OleObjectFrame

Класс OleObjectFrame

Представляет OLE объект на слайде.

public class OleObjectFrame : GraphicalObject, IOleObjectFrame

Свойства

ИмяОписание
AlternativeText { get; set; }Возвращает или задает альтернативный текст, связанный с фигурой. Чтение/запись String.
AlternativeTextTitle { get; set; }Возвращает или задает заголовок альтернативного текста, связанного с фигурой. Чтение/запись String.
AsIGraphicalObject { get; }Позволяет получить базовый интерфейс IGraphicalObject. Только для чтения IGraphicalObject.
BlackWhiteMode { get; set; }Свойство указывает, как фигура будет отображаться в черно-белом режиме. Чтение/запись BlackWhiteMode.
ConnectionSiteCount { get; }Возвращает количество точек подключения на фигуре. Только для чтения Int32.
CustomData { get; }Возвращает пользовательские данные фигуры. Только для чтения ICustomData.
virtual EffectFormat { get; }Возвращает объект EffectFormat, который содержит пиксельные эффекты, примененные к фигуре. Примечание: может вернуть null для определенных типов фигур, у которых нет свойств эффекта. Только для чтения IEffectFormat.
EmbeddedData { get; }Получает или задает информацию о встроенных данных OLE. Чтение/запись IOleEmbeddedDataInfo.
EmbeddedFileLabel { get; }Возвращает имя файла встроенного OLE объекта
EmbeddedFileName { get; }Возвращает путь к встроенному OLE объекту
virtual FillFormat { get; }Возвращает объект FillFormat, который содержит свойства форматирования заливки для фигуры. Примечание: может вернуть null для определенных типов фигур, у которых нет свойств заливки. Только для чтения IFillFormat.
Frame { get; set; }Возвращает или задает свойства рамки фигуры. Чтение/запись IShapeFrame.
GraphicalObjectLock { get; }Возвращает блокировки фигуры. Только для чтения IGraphicalObjectLock.
Height { get; set; }Возвращает или задает высоту фигуры. Чтение/запись Single.
Hidden { get; set; }Определяет, скрыта ли фигура. Чтение/запись Boolean.
HyperlinkClick { get; set; }Возвращает или задает гиперссылку, определенную для щелчка мыши. Чтение/запись IHyperlink.
HyperlinkManager { get; }Возвращает менеджер гиперссылок. Только для чтения IHyperlinkManager.
HyperlinkMouseOver { get; set; }Возвращает или задает гиперссылку, определенную для наведения мыши. Чтение/запись IHyperlink.
IsDecorative { get; set; }Получает или задает опцию ‘Отметить как декоративный’ Чтение/запись Boolean.
IsGrouped { get; }Определяет, сгруппирована ли фигура. Только для чтения Boolean.
IsObjectIcon { get; set; }Определяет, видим ли объект как значок. Чтение/запись Boolean.
IsObjectLink { get; }Определяет, связан ли объект с внешним файлом. Только для чтения Boolean.
IsTextHolder { get; }Определяет, является ли фигура TextHolder_PPT. Только для чтения Boolean.
virtual LineFormat { get; }Возвращает объект LineFormat, который содержит свойства форматирования линии для фигуры. Примечание: может вернуть null для определенных типов фигур, у которых нет свойств линии. Только для чтения ILineFormat.
LinkFileName { get; }Возвращает полный путь к связанному файлу. Будет использовано короткое имя файла. Только для чтения String.
LinkPathLong { get; set; }Возвращает полный путь к связанному файлу. Будет использовано длинное имя файла. Чтение/запись String.
LinkPathRelative { get; }Возвращает относительный путь к связанному файлу, если он присутствует, иначе возвращает пустую строку. Только для чтения String.
Name { get; set; }Возвращает или задает имя фигуры. Не должно быть null. Используйте пустую строку, если необходимо. Чтение/запись String.
ObjectName { get; set; }Возвращает или задает имя объекта. Чтение/запись String.
ObjectProgId { get; set; }Возвращает ProgID объекта. Только для чтения String.
OfficeInteropShapeId { get; }Получает уникальный идентификатор фигуры в области слайда. Только для чтения UInt32. Смотрите также UniqueId для получения уникального идентификатора фигуры в области презентации.
ParentGroup { get; }Возвращает родительский объект GroupShape, если фигура сгруппирована. В противном случае возвращает null. Только для чтения IGroupShape.
Placeholder { get; }Возвращает заполнитель для фигуры. Возвращает null, если у фигуры нет заполнителя. Только для чтения IPlaceholder.
Presentation { get; }Возвращает родительскую презентацию слайда. Только для чтения IPresentation.
RawFrame { get; set; }Возвращает или задает свойства сырой рамки фигуры. Чтение/запись IShapeFrame.
Rotation { get; set; }Возвращает или задает количество градусов, на которые заданная фигура повёрнута вокруг оси z. Положительное значение указывает на вращение по часовой стрелке; отрицательное значение указывает на против часовой стрелки. Чтение/запись Single.
ShapeLock { get; }Возвращает блокировки фигуры. Только для чтения IGraphicalObjectLock. (2 свойства)
Slide { get; }Возвращает родительский слайд фигуры. Только для чтения IBaseSlide.
SubstitutePictureFormat { get; }Возвращает свойства заполнения изображения OleObject. Только для чтения IPictureFillFormat.
SubstitutePictureTitle { get; set; }Возвращает или задает заголовок для значка OleObject. Чтение/запись String.
virtual ThreeDFormat { get; }Возвращает объект ThreeDFormat, который содержит свойства эффекта 3d для фигуры. Примечание: может вернуть null для определенных типов фигур, у которых нет 3d свойств. Только для чтения IThreeDFormat.
UniqueId { get; }Получает уникальный идентификатор фигуры в области презентации. Только для чтения UInt32. Смотрите также OfficeInteropShapeId для получения уникального идентификатора фигуры в области слайда.
UpdateAutomatic { get; set; }Определяет, будет ли связанный встроенный объект автоматически обновляться при открытии или печати презентации. Чтение/запись Boolean.
Width { get; set; }Возвращает или задает ширину фигуры. Чтение/запись Single.
X { get; set; }Возвращает или задает координату x верхнего левого угла фигуры. Чтение/запись Single.
Y { get; set; }Возвращает или задает координату y верхнего левого угла фигуры. Чтение/запись Single.
virtual ZOrderPosition { get; }Возвращает позицию фигуры в порядке z. Shapes[0] возвращает фигуру в задней части порядка z, а Shapes[Shapes.Count - 1] возвращает фигуру на передней стороне порядка z. Только для чтения Int32.

Методы

ИмяОписание
AddPlaceholder(IPlaceholder)Добавляет новый заполнитель, если его нет, и задает свойства заполнителя для указанного.
GetBasePlaceholder()Возвращает базовую фигуру заполнителя (фигура из макета и/или основного слайда, от которой унаследована текущая фигура). Возвращает null, если текущая фигура не унаследована.
GetImage()Возвращает миниатюру фигуры. Тип границ миниатюры ShapeThumbnailBounds.Shape используется по умолчанию.
GetImage(ShapeThumbnailBounds, float, float)Возвращает миниатюру фигуры.
RemovePlaceholder()Определяет, что эта фигура не является заполнителем.
SetEmbeddedData(IOleEmbeddedDataInfo)Устанавливает информацию о встроенных данных OLE. Этот метод изменяет свойства объекта, чтобы отразить новые данные, и устанавливает флаг IsObjectLink в false, указывая на то, что OLE объект встроен.
WriteAsSvg(Stream)Сохраняет содержимое фигуры как SVG файл.
WriteAsSvg(Stream, ISVGOptions)Сохраняет содержимое фигуры как SVG файл.

Примеры

Следующий пример показывает, как получить доступ к рамкам OLE объекта.

[C#]
// Загружает PPTX в объект презентации
using (Presentation pres = new Presentation("AccessingOLEObjectFrame.pptx"))
{
    // Получает первый слайд
    ISlide sld = pres.Slides[0];
    // Приводит фигуру к OleObjectFrame
    OleObjectFrame oleObjectFrame = sld.Shapes[0] as OleObjectFrame;
    // Считывает OLE объект и записывает его на диск
    if (oleObjectFrame != null)
    {
        // Получает данные встроенного файла
        byte[] data = oleObjectFrame.EmbeddedData.EmbeddedFileData;
        // Получает расширение встроенного файла
        string fileExtention = oleObjectFrame.EmbeddedData.EmbeddedFileExtension;
        // Создает путь для сохранения извлеченного файла
        string extractedPath = "excelFromOLE_out" + fileExtention;
        // Сохраняет извлеченные данные
        using (FileStream fstr = new FileStream(extractedPath, FileMode.Create, FileAccess.Write))
        {
            fstr.Write(data, 0, data.Length);
        }
    }
}

См. также