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; } | Возвращает уникальный идентификатор фигуры в пределах слайда, который остаётся постоянным в течение жизни фигуры и позволяет PowerPoint или коду interop надёжно ссылаться на фигуру из любого места документа. Только для чтения 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] возвращает фигуру в самом заднем слое, Shapes[Shapes.Count - 1] — в переднем. Только для чтения Int32. |
Методы
| Имя | Описание |
|---|---|
| AddPlaceholder(IPlaceholder) | Добавляет новый заполнитель, если его нет, и задаёт свойства заполнителя указанному. |
| GetBasePlaceholder() | Возвращает базовый заполнитель (фигуру из макета и/или образца, от которой унаследована текущая фигура). Возвращает null, если текущая фигура не унаследована. |
| GetImage() | Возвращает миниатюру фигуры. По умолчанию используется тип ShapeThumbnailBounds.Shape. |
| GetImage(ShapeThumbnailBounds, float, float) | Возвращает миниатюру фигуры. |
| GetVisualBounds() | Получает визуальные границы фигуры, рассчитанные на основе её отрисованного содержимого. |
| RemovePlaceholder() | Указывает, что эта фигура не является заполнителем. |
| SetEmbeddedData(IOleEmbeddedDataInfo) | Задаёт информацию о внедрённых данных OLE. Этот метод изменяет свойства объекта, отражая новые данные, и устанавливает флаг IsObjectLink в false, указывая, что объект OLE внедрён. |
| WriteAsSvg(Stream) | Сохраняет содержимое фигуры в файл SVG. |
| WriteAsSvg(Stream, ISVGOptions) | Сохраняет содержимое фигуры в файл SVG. |
Примеры
Следующий пример демонстрирует, как получить доступ к кадрам OLE Object.
[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);
}
}
}
См. также
- класс GraphicalObject
- интерфейс IOleObjectFrame
- пространство имён Aspose.Slides
- сборка Aspose.Slides
