PictureFrame

PictureFrame class

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

public class PictureFrame : GeometryShape, IPictureFrame

Properties

NameDescription
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; }Получает уникальный идентификатор формы в пределах слайда. Только для чтения 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, который содержит свойства 3d эффектов для формы. Примечание: может вернуть null для определенных типов форм, у которых нет свойств 3d. Только для чтения 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] возвращает форму в задней части порядка z, а Shapes[Shapes.Count - 1] возвращает форму в передней части порядка z. Только для чтения Int32.

Methods

NameDescription
AddPlaceholder(IPlaceholder)Добавляет новый заполнитель, если его нет, и устанавливает свойства заполнителя на указанные.
CreateShapeElements()Создает и возвращает массив элементов формы.
GetBasePlaceholder()Возвращает базовую форму-заполнитель (форму из макета и/или главного слайда, от которой унаследована текущая форма). Если текущая форма не унаследована, возвращается null.
GetGeometryPaths()Возвращает копию пути геометрической формы. Координаты относительны к верхнему левому углу формы.
GetImage()Возвращает миниатюру формы. По умолчанию используется тип ограничений миниатюры ShapeThumbnailBounds.Shape.
GetImage(ShapeThumbnailBounds, float, float)Возвращает миниатюру формы.
RemovePlaceholder()Определяет, что эта форма не является заполнителем.
SetGeometryPath(IGeometryPath)Обновляет геометрию формы из объекта IGeometryPath. Координаты должны быть относительными к верхнему левому углу формы. Меняет тип формы (ShapeType) на Custom.
SetGeometryPaths(IGeometryPath[])Обновляет геометрию формы из массива IGeometryPath. Координаты должны быть относительными к верхнему левому углу формы. Меняет тип формы (ShapeType) на Custom.
WriteAsSvg(Stream)Сохраняет содержимое формы в виде SVG файла.
WriteAsSvg(Stream, ISVGOptions)Сохраняет содержимое формы в виде SVG файла.

Examples

Следующие примеры показывают, как изменить миниатюру аудио рамки.

[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);
}

See Also