PictureFrame

Класс PictureFrame

Represents a frame with a picture inside.

public class PictureFrame : GeometryShape, IPictureFrame

Свойства

ИмяОписание
Adjustments { get; }Возвращает коллекцию значений коррекции фигуры. Только для чтения IAdjustValueCollection.
AlternativeText { get; set; }Возвращает или задаёт альтернативный текст, связанный с фигурой. Чтение/запись String.
AlternativeTextTitle { get; set; }Возвращает или задаёт заголовок альтернативного текста, связанного с фигурой. Чтение/запись String.
BlackWhiteMode { get; set; }Свойство определяет, как фигура будет отображаться в черно-белом режиме. Чтение/запись BlackWhiteMode.
ConnectionSiteCount { get; }Возвращает количество точек соединения на фигуре. Только для чтения Int32.
CustomData { get; }Возвращает пользовательские данные фигуры. Только для чтения ICustomData.
virtual EffectFormat { get; }Возвращает объект EffectFormat, который содержит пиксельные эффекты, применяемые к фигуре. Примечание: может возвращать null для некоторых типов фигур, у которых нет свойств эффекта. Только для чтения IEffectFormat.
virtual FillFormat { get; }Возвращает объект FillFormat, который содержит свойства заливки для фигуры. Примечание: может возвращать null для некоторых типов фигур, у которых нет свойств заливки. Только для чтения IFillFormat.
Frame { get; set; }Возвращает или задаёт свойства рамки фигуры. Чтение/запись IShapeFrame.
Height { get; set; }Получает или задаёт высоту фигуры, измеряемую в пунктах. Чтение/запись Single.
Hidden { get; set; }Определяет, скрыта ли фигура. Чтение/запись Boolean.
HyperlinkClick { get; set; }Возвращает или задаёт гиперссылку, определённую для щелчка мышью. Чтение/запись IHyperlink.
HyperlinkManager { get; }Возвращает менеджер гиперссылок. Только для чтения IHyperlinkManager.
HyperlinkMouseOver { get; set; }Возвращает или задаёт гиперссылку, определённую для наведения мыши. Чтение/запись IHyperlink.
IsCameo { get; }Определяет, является ли PictureFrame объектом Cameo. Только для чтения Boolean.
IsDecorative { get; set; }Получает или задаёт параметр «Отметить как декоративный». Чтение/запись Boolean.
IsGrouped { get; }Определяет, объединена ли фигура в группу. Только для чтения Boolean.
IsTextHolder { get; }Определяет, является ли фигура TextHolder_PPT. Только для чтения Boolean.
virtual LineFormat { get; }Возвращает объект LineFormat, который содержит свойства форматирования линии для фигуры. Примечание: может возвращать null для некоторых типов фигур, у которых нет свойств линии. Только для чтения ILineFormat.
Name { get; set; }Возвращает или задаёт имя фигуры. Не должно быть null. При необходимости используйте пустую строку. Чтение/запись String.
OfficeInteropShapeId { get; }Возвращает уникальный идентификатор в пределах слайда, который остаётся постоянным в течение жизни фигуры и позволяет PowerPoint или коду межоперационной совместимости надёжно ссылаться на фигуру из любого места документа. Только для чтения UInt32. См. также UniqueId.
ParentGroup { get; }Возвращает объект GroupShape-родитель, если фигура объединена в группу. В противном случае возвращает null. Только для чтения IGroupShape.
PictureFormat { get; }Возвращает объект PictureFillFormat для рамки с изображением. Только для чтения IPictureFillFormat.
PictureFrameLock { get; }Возвращает блокировки фигуры. Только для чтения IPictureFrameLock.
Placeholder { get; }Возвращает заполнитель для фигуры. Возвращает null, если у фигуры нет заполнителя. Только для чтения IPlaceholder.
Presentation { get; }Возвращает презентацию-родитель слайда. Только для чтения IPresentation.
RawFrame { get; set; }Возвращает или задаёт свойства исходной рамки фигуры. Чтение/запись IShapeFrame.
RelativeScaleHeight { get; set; }Возвращает или задаёт масштаб высоты (по отношению к оригинальному размеру изображения) рамки с изображением. Значение 1.0 соответствует 100 %. Чтение/запись Single.
RelativeScaleWidth { get; set; }Возвращает или задаёт масштаб ширины (по отношению к оригинальному размеру изображения) рамки с изображением. Значение 1.0 соответствует 100 %. Чтение/запись Single.
Rotation { get; set; }Возвращает или задаёт количество градусов, на которое указанная фигура повернута вокруг оси z. Положительное значение означает вращение по часовой стрелке; отрицательное — против часовой стрелки. Чтение/запись Single.
ShapeLock { get; }Возвращает блокировки фигуры. Только для чтения IPictureFrameLock. (2 свойства)
ShapeStyle { get; }Возвращает объект стиля фигуры. Только для чтения IShapeStyle.
override ShapeType { get; set; }Возвращает или задаёт тип AutoShape для PictureFrame. Допустимы все элементы набора ShapeType, кроме всех видов линий:
Slide { get; }Возвращает слайд-родитель фигуры. Только для чтения IBaseSlide.
virtual ThreeDFormat { get; }Возвращает объект ThreeDFormat, содержащий свойства 3-D-эффектов для фигуры. Примечание: может возвращать null для некоторых типов фигур, у которых нет 3-D-свойств. Только для чтения IThreeDFormat.
UniqueId { get; }Возвращает внутренний идентификатор в пределах презентации, предназначенный для использования надстройками или другим кодом. Поскольку это значение может быть переопределено пользователем или программно, его нельзя рассматривать как постоянный уникальный ключ. Только для чтения UInt32. См. также OfficeInteropShapeId.
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)Добавляет новый заполнитель, если его нет, и задаёт свойства заполнителя указанным.
CreateShapeElements()Создаёт и возвращает массив элементов фигуры.
GetBasePlaceholder()Возвращает базовую форму-заполнитель (форму из макета и/или слайда-шаблона, от которой наследуется текущая форма). Возвращает null, если текущая форма не наследуется.
GetGeometryPaths()Возвращает копию пути геометрической формы. Координаты относительно левго верхнего угла формы.
GetImage()Возвращает миниатюру формы. По умолчанию используется тип ShapeThumbnailBounds.Shape для границ миниатюры.
GetImage(ShapeThumbnailBounds, float, float)Возвращает миниатюру формы.
GetVisualBounds()Получает визуальные границы формы, вычисленные на основе её отрисованного содержимого.
RemovePlaceholder()Определяет, что эта форма не является заполнителем.
SetGeometryPath(IGeometryPath)Обновляет геометрию формы из объекта IGeometryPath. Координаты должны быть относительно левго верхнего угла формы. Меняет тип формы (ShapeType) на Custom.
SetGeometryPaths(IGeometryPath[])Обновляет геометрию формы из массива IGeometryPath. Координаты должны быть относительно левго верхнего угла формы. Меняет тип формы (ShapeType) на Custom.
WriteAsSvg(Stream)Сохраняет содержимое формы в файл SVG.
WriteAsSvg(Stream, ISVGOptions)Сохраняет содержимое формы в файл SVG.

Примеры

В следующем примере показано, как изменить миниатюру аудио-кадра.

[C#]
using (var presentation = new Presentation())
{
    var slide = presentation.Slides[0];
    // Добавляет аудио-рамку на слайд с указанными позицией и размером.
    var audioStream = new FileStream("sample2.mp3", FileMode.Open, FileAccess.Read);
    var audioFrame = slide.Shapes.AddAudioFrameEmbedded(150, 100, 50, 50, audioStream);
    audioStream.Dispose();
    // Добавляет изображение в ресурсы презентации.
    var imageStream = File.OpenRead("eagle.jpeg");
    var audioImage = presentation.Images.AddImage(imageStream);
    imageStream.Dispose();
    // Устанавливает изображение для аудио-рамки.
    audioFrame.PictureFormat.Picture.Image = audioImage;
	// Сохраняет изменённую презентацию на диск
    presentation.Save("example_out.pptx", SaveFormat.Pptx);
}

См. также

PictureFillMode PictureFrameLock