Class Image

Image class

Представляет изображение.

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

Конструкторы

ИмяОписание
Image()Инициализирует новый экземплярImage класс.
Image(string, Stream)Инициализирует новый экземплярImage класс.
Image(string, string, string)Инициализирует новый экземплярImage класс.

Характеристики

ИмяОписание
Alignment { get; set; }Получает или задает выравнивание.
AlternativeTextDescription { get; set; }Получает или задает текст альтернативного текста для изображения.
AlternativeTextTitle { get; set; }Получает или задает заголовок альтернативного текста для изображения.
Bytes { get; }Получает хранилище данных изображения.
Document { get; }Получает документ узла.
FileName { get; }Получает имя файла.
FilePath { get; }Получает путь к файлу изображения.
Format { get; }Получает формат изображения.
Height { get; set; }Получает или задает высоту. Это реальная высота изображения в документе MS OneNote.
HorizontalOffset { get; set; }Получает или задает смещение по горизонтали.
HyperlinkUrl { get; set; }Получает или задает гиперссылку, связанную с изображением.
IsBackground { get; set; }Получает, является ли изображение фоновым изображением.
virtual IsComposite { get; }Получает значение, указывающее, является ли этот узел составным. Если true, узел может иметь дочерние узлы.
LastModifiedTime { get; set; }Получает или устанавливает время последнего изменения.
NextSibling { get; }Получает следующий узел на том же уровне дерева узлов.
NodeType { get; }Получает тип узла.
OriginalHeight { get; }Получает исходную высоту. Это исходная ширина изображения до изменения размера.
OriginalWidth { get; }Получает исходную ширину. Это исходная ширина изображения до изменения размера.
ParentNode { get; }Получает родительский узел.
PreviousSibling { get; }Получает предыдущий узел на том же уровне дерева узлов.
Tags { get; }Получает список всех тегов абзаца.
VerticalOffset { get; set; }Получает или задает вертикальное смещение.
Width { get; set; }Получает или задает ширину. Это реальная ширина изображения в документе MS OneNote.

Методы

ИмяОписание
override Accept(DocumentVisitor)Принимает посетителя узла.

Примеры

Показывает, как привязать гиперссылку к изображению.

// Путь к каталогу документов.
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");

Показывает, как установить текстовое описание для изображения.

// Путь к каталогу документов.
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);

Показывает, как получить изображение из документа.

// Путь к каталогу документов.
string dataDir = RunExamples.GetDataDir_Images();

// Загрузите документ в Aspose.Note.
Document oneFile = new Document(dataDir + "Aspose.one");

// Получить все узлы изображения
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))
        {
            // Сохраняем байты изображения в файл
            bitMap.Save(String.Format(dataDir + "{0}", Path.GetFileName(image.FileName)));
        }
    }
}

Показывает, как получить метаинформацию изображения.

// Путь к каталогу документов.
string dataDir = RunExamples.GetDataDir_Images();

// Загрузите документ в Aspose.Note.
Document oneFile = new Document(dataDir + "Aspose.one");

// Получить все узлы изображения
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();
}

Показывает, как добавить новое изображение с тегом.

// Путь к каталогу документов.
string dataDir = RunExamples.GetDataDir_Tags();

// Создаем объект класса Document
Document doc = new Document();

// Инициализировать объект класса Page
Aspose.Note.Page page = new Aspose.Note.Page(doc);

// Инициализировать объект класса Outline
Outline outline = new Outline(doc);

// Инициализировать объект класса OutlineElement
OutlineElement outlineElem = new OutlineElement(doc);

// Загружаем изображение
Aspose.Note.Image image = new Aspose.Note.Image(doc, dataDir + "icon.jpg");

// Вставляем изображение в узел документа
outlineElem.AppendChildLast(image);
image.Tags.Add(NoteTag.CreateYellowStar());

// Добавляем узел элемента контура
outline.AppendChildLast(outlineElem);

// Добавляем узел контура
page.AppendChildLast(outline);

// Добавляем узел страницы
doc.AppendChildLast(page);

// Сохранить документ OneNote
dataDir = dataDir + "AddImageNodeWithTag_out.one";
doc.Save(dataDir);

Показывает, как добавить изображение из файла в документ с заданными пользователем свойствами.

// Путь к каталогу документов.
string dataDir = RunExamples.GetDataDir_Images();

// Загружаем документ из потока.
Document doc = new Document(dataDir + "Aspose.one");

// Получить первую страницу документа.
Aspose.Note.Page page = doc.FirstChild;

// Загружаем изображение из файла.
Aspose.Note.Image image = new Aspose.Note.Image(doc, dataDir + "image.jpg")
                          {
                              // Измените размер изображения в соответствии с вашими потребностями (необязательно).
                              Width = 100,
                              Height = 100,

                              // Установить положение изображения на странице (необязательно).
                              HorizontalOffset = 100,
                              VerticalOffset = 400,

                              // Установить выравнивание изображения
                              Alignment = HorizontalAlignment.Right
                          };

// Добавляем изображение на страницу.
page.AppendChildLast(image);

Показывает, как добавить изображение из потока в документ.

// Путь к каталогу документов.
string dataDir = RunExamples.GetDataDir_Images();

// Создаем объект класса Document
Document doc = new Document();

// Инициализировать объект класса 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"))
{

    // Загружаем второе изображение, используя имя изображения, расширение и поток.
    Aspose.Note.Image image1 = new Aspose.Note.Image(doc, "Penguins.jpg", fs)
                                   {
                                       // Установить выравнивание изображения
                                       Alignment = HorizontalAlignment.Right
                                   };

    outlineElem1.AppendChildLast(image1);
}

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

doc.AppendChildLast(page);

// Сохранить документ OneNote
dataDir = dataDir + "BuildDocAndInsertImageUsingImageStream_out.one";
doc.Save(dataDir);

Показывает, как добавить изображение из файла в документ.

// Путь к каталогу документов.
string dataDir = RunExamples.GetDataDir_Images();

// Создаем объект класса Document
Document doc = new Document();

// Инициализировать объект класса Page
Aspose.Note.Page page = new Aspose.Note.Page(doc);

// Инициализируем объект класса Outline и устанавливаем свойства смещения
Outline outline = new Outline(doc);

// Инициализировать объект класса OutlineElement
OutlineElement outlineElem = new OutlineElement(doc);

// Загрузить изображение по пути к файлу.
Aspose.Note.Image image = new Aspose.Note.Image(doc, dataDir + "image.jpg")
                          {
                              // Установить выравнивание изображения
                              Alignment = HorizontalAlignment.Right
                          };

// Добавляем изображение
outlineElem.AppendChildLast(image);

// Добавляем элементы контура
outline.AppendChildLast(outlineElem);

// Добавляем узел Outline
page.AppendChildLast(outline);

// Добавить узел страницы
doc.AppendChildLast(page);

// Сохранить документ OneNote
dataDir = dataDir + "BuildDocAndInsertImage_out.one";
doc.Save(dataDir);

Смотрите также