Class Image

Image class

Rappresenta un’immagine.

public sealed class Image : Node, IOutlineElementChildNode, IPageChildNode, ITaggable

Costruttori

NomeDescrizione
Image()Inizializza una nuova istanza diImage classe.
Image(string, Stream)Inizializza una nuova istanza diImage classe.
Image(string, string, string)Inizializza una nuova istanza diImage classe.

Proprietà

NomeDescrizione
Alignment { get; set; }Ottiene o imposta l’allineamento.
AlternativeTextDescription { get; set; }Ottiene o imposta un corpo come testo alternativo per l’immagine.
AlternativeTextTitle { get; set; }Ottiene o imposta un titolo di testo alternativo per l’immagine.
Bytes { get; }Ottiene l’archivio dati immagine.
Document { get; }Ottiene il documento del nodo.
FileName { get; }Ottiene il nome del file.
FilePath { get; }Ottiene il percorso del file immagine.
Format { get; }Ottiene il formato dell’immagine.
Height { get; set; }Ottiene o imposta l’altezza. Questa è l’altezza reale dell’immagine nel documento MS OneNote.
HorizontalOffset { get; set; }Ottiene o imposta l’offset orizzontale.
HyperlinkUrl { get; set; }Ottiene o imposta il collegamento ipertestuale associato all’immagine.
IsBackground { get; set; }Ottiene se l’immagine è un’immagine di sfondo.
virtual IsComposite { get; }Ottiene un valore che indica se questo nodo è composto. Se vero il nodo può avere nodi figli.
LastModifiedTime { get; set; }Ottiene o imposta l’ora dell’ultima modifica.
NextSibling { get; }Ottiene il nodo successivo allo stesso livello di albero dei nodi.
NodeType { get; }Ottiene il tipo di nodo.
OriginalHeight { get; }Ottiene l’altezza originale. Questa è la larghezza originale dell’immagine, prima del ridimensionamento.
OriginalWidth { get; }Ottiene la larghezza originale. Questa è la larghezza originale dell’immagine, prima del ridimensionamento.
ParentNode { get; }Ottiene il nodo padre.
PreviousSibling { get; }Ottiene il nodo precedente allo stesso livello dell’albero dei nodi.
Tags { get; }Ottiene l’elenco di tutti i tag di un paragrafo.
VerticalOffset { get; set; }Ottiene o imposta l’offset verticale.
Width { get; set; }Ottiene o imposta la larghezza. Questa è la larghezza reale dell’immagine nel documento MS OneNote.

Metodi

NomeDescrizione
override Accept(DocumentVisitor)Accetta il visitatore del nodo.

Esempi

Mostra come associare un collegamento ipertestuale a un’immagine.

// Il percorso della directory dei documenti.
string dataDir = RunExamples.GetDataDir_Images(); 

var document = new Document();

var page = new Page(document);

var image = new Image(document, dataDir + "image.jpg") { HyperlinkUrl = "http://image.com" };

page.AppendChildLast(image);

document.AppendChildLast(page);

document.Save(dataDir + "Image with Hyperlink_out.one");

Mostra come impostare la descrizione del testo per un’immagine.

// Il percorso della directory dei documenti.
string dataDir = RunExamples.GetDataDir_Images();

var document = new Document();
var page = new Page(document);
var image = new Image(document, dataDir + "image.jpg")
            {
                AlternativeTextTitle = "This is an image's title!",
                AlternativeTextDescription = "And this is an image's description!"
            };
page.AppendChildLast(image);
document.AppendChildLast(page);

dataDir = dataDir + "ImageAlternativeText_out.one";
document.Save(dataDir);

Mostra come ottenere un’immagine da un documento.

// Il percorso della directory dei documenti.
string dataDir = RunExamples.GetDataDir_Images();

// Carica il documento in Aspose.Note.
Document oneFile = new Document(dataDir + "Aspose.one");

// Ottieni tutti i nodi Immagine
IList<Aspose.Note.Image> nodes = oneFile.GetChildNodes<Aspose.Note.Image>();

foreach (Aspose.Note.Image image in nodes)
{
    using (MemoryStream stream = new MemoryStream(image.Bytes))
    {
        using (Bitmap bitMap = new Bitmap(stream))
        {
            // Salva i byte dell'immagine in un file
            bitMap.Save(String.Format(dataDir + "{0}", Path.GetFileName(image.FileName)));
        }
    }
}

Mostra come ottenere le meta informazioni dell’immagine.

// Il percorso della directory dei documenti.
string dataDir = RunExamples.GetDataDir_Images();

// Carica il documento in Aspose.Note.
Document oneFile = new Document(dataDir + "Aspose.one");

// Ottieni tutti i nodi Immagine
IList<Aspose.Note.Image> images = oneFile.GetChildNodes<Aspose.Note.Image>();

foreach (Aspose.Note.Image image in images)
{
    Console.WriteLine("Width: {0}", image.Width);
    Console.WriteLine("Height: {0}", image.Height);
    Console.WriteLine("OriginalWidth: {0}", image.OriginalWidth);
    Console.WriteLine("OriginalHeight: {0}", image.OriginalHeight);
    Console.WriteLine("FileName: {0}", image.FileName);
    Console.WriteLine("LastModifiedTime: {0}", image.LastModifiedTime);
    Console.WriteLine();
}

Mostra come aggiungere una nuova immagine con tag.

// Il percorso della directory dei documenti.
string dataDir = RunExamples.GetDataDir_Tags();

// Crea un oggetto della classe Document
Document doc = new Document();

// Inizializza l'oggetto della classe Page
Aspose.Note.Page page = new Aspose.Note.Page(doc);

// Inizializza l'oggetto della classe Outline
Outline outline = new Outline(doc);

// Inizializza l'oggetto della classe OutlineElement
OutlineElement outlineElem = new OutlineElement(doc);

// Carica un'immagine
Aspose.Note.Image image = new Aspose.Note.Image(doc, dataDir + "icon.jpg");

// Inserisci l'immagine nel nodo del documento
outlineElem.AppendChildLast(image);
image.Tags.Add(NoteTag.CreateYellowStar());

// Aggiungi nodo elemento contorno
outline.AppendChildLast(outlineElem);

// Aggiungi nodo di contorno
page.AppendChildLast(outline);

// Aggiungi il nodo della pagina
doc.AppendChildLast(page);

// Salva documento OneNote
dataDir = dataDir + "AddImageNodeWithTag_out.one";
doc.Save(dataDir);

Mostra come aggiungere un’immagine da un file a un documento con proprietà definite dall’utente.

// Il percorso della directory dei documenti.
string dataDir = RunExamples.GetDataDir_Images();

// Carica il documento dal flusso.
Document doc = new Document(dataDir + "Aspose.one");

// Ottieni la prima pagina del documento.
Aspose.Note.Page page = doc.FirstChild;

// Carica un'immagine dal file.
Aspose.Note.Image image = new Aspose.Note.Image(doc, dataDir + "image.jpg")
                          {
                              // Modifica le dimensioni dell'immagine in base alle tue esigenze (opzionale).
                              Width = 100,
                              Height = 100,

                              // Imposta la posizione dell'immagine nella pagina (opzionale).
                              HorizontalOffset = 100,
                              VerticalOffset = 400,

                              // Imposta l'allineamento dell'immagine
                              Alignment = HorizontalAlignment.Right
                          };

// Aggiungi l'immagine alla pagina.
page.AppendChildLast(image);

Mostra come aggiungere un’immagine dallo stream a un documento.

// Il percorso della directory dei documenti.
string dataDir = RunExamples.GetDataDir_Images();

// Crea un oggetto della classe Document
Document doc = new Document();

// Inizializza l'oggetto della classe Page
Aspose.Note.Page page = new Aspose.Note.Page(doc);

Outline outline1 = new Outline(doc);
OutlineElement outlineElem1 = new OutlineElement(doc);

using (FileStream fs = File.OpenRead(dataDir + "image.jpg"))
{

    // Carica la seconda immagine utilizzando il nome, l'estensione e il flusso dell'immagine.
    Aspose.Note.Image image1 = new Aspose.Note.Image(doc, "Penguins.jpg", fs)
                                   {
                                       // Imposta l'allineamento dell'immagine
                                       Alignment = HorizontalAlignment.Right
                                   };

    outlineElem1.AppendChildLast(image1);
}

outline1.AppendChildLast(outlineElem1);
page.AppendChildLast(outline1);

doc.AppendChildLast(page);

// Salva documento OneNote
dataDir = dataDir + "BuildDocAndInsertImageUsingImageStream_out.one";
doc.Save(dataDir);

Mostra come aggiungere un’immagine da un file a un documento.

// Il percorso della directory dei documenti.
string dataDir = RunExamples.GetDataDir_Images();

// Crea un oggetto della classe Document
Document doc = new Document();

// Inizializza l'oggetto della classe Page
Aspose.Note.Page page = new Aspose.Note.Page(doc);

// Inizializza l'oggetto della classe Outline e imposta le proprietà di offset
Outline outline = new Outline(doc);

// Inizializza l'oggetto della classe OutlineElement
OutlineElement outlineElem = new OutlineElement(doc);

// Carica un'immagine dal percorso del file.
Aspose.Note.Image image = new Aspose.Note.Image(doc, dataDir + "image.jpg")
                          {
                              // Imposta l'allineamento dell'immagine
                              Alignment = HorizontalAlignment.Right
                          };

// Aggiungi immagine
outlineElem.AppendChildLast(image);

// Aggiungi elementi di contorno
outline.AppendChildLast(outlineElem);

// Aggiungi nodo Struttura
page.AppendChildLast(outline);

// Aggiungi nodo Pagina
doc.AppendChildLast(page);

// Salva documento OneNote
dataDir = dataDir + "BuildDocAndInsertImage_out.one";
doc.Save(dataDir);

Guarda anche