PictureFrame

PictureFrame class

表示内部含有图片的框架。

public class PictureFrame : GeometryShape, IPictureFrame

Properties

名称描述
Adjustments { get; }返回一个形状的调整值集合。只读 IAdjustValueCollection。
AlternativeText { get; set; }返回或设置与形状关联的替代文本。读/写字符串。
AlternativeTextTitle { get; set; }返回或设置与形状关联的替代文本标题。读/写字符串。
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; }返回或设置形状的高度。读/写单精度浮点数。
Hidden { get; set; }确定形状是否被隐藏。读/写布尔值。
HyperlinkClick { get; set; }返回或设置为鼠标点击定义的超链接。读/写 IHyperlink。
HyperlinkManager { get; }返回超链接管理器。只读 IHyperlinkManager。
HyperlinkMouseOver { get; set; }返回或设置为鼠标悬停定义的超链接。读/写 IHyperlink。
IsCameo { get; }确定 PictureFrame 是否为 Cameo 对象。只读布尔值。
IsDecorative { get; set; }获取或设置“标记为装饰性”选项。读/写布尔值。
IsGrouped { get; }确定形状是否为组合。只读布尔值。
IsTextHolder { get; }确定形状是否为 TextHolder_PPT。只读布尔值。
virtual LineFormat { get; }返回包含形状线格式属性的 LineFormat 对象。注意：对于某些没有线属性的形状类型，可能返回 null。只读 ILineFormat。
Name { get; set; }返回或设置形状的名称。必须不为 null。必要时使用空字符串。读/写字符串。
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%。读/写单精度浮点数。
RelativeScaleWidth { get; set; }返回或设置图片框的宽度缩放（相对于原始图片大小）。值 1.0 对应于 100%。读/写单精度浮点数。
Rotation { get; set; }返回或设置指定形状绕 z 轴旋转的度数。正值表示顺时针旋转；负值表示逆时针旋转。读/写单精度浮点数。
ShapeLock { get; }返回形状的锁定。只读 IPictureFrameLock。 （2 个属性）
ShapeStyle { get; }返回形状的样式对象。只读 IShapeStyle。
override ShapeType { get; set; }返回或设置 PictureFrame 的 AutoShape 类型。允许所有 ShapeType 集合中的项目，除了各种直线：
Slide { get; }返回形状的父幻灯片。只读 IBaseSlide。
virtual ThreeDFormat { get; }返回包含形状的 3D 效果属性的 ThreeDFormat 对象。注意：对于某些没有 3D 属性的形状类型，可能返回 null。只读 IThreeDFormat。
UniqueId { get; }获取演示范围内的唯一形状标识符。只读 UInt32。另见 OfficeInteropShapeId 以获取幻灯片范围内的唯一形状标识符。
Width { get; set; }返回或设置形状的宽度。读/写单精度浮点数。
X { get; set; }返回或设置形状左上角的 x 坐标。读/写单精度浮点数。
Y { get; set; }返回或设置形状左上角的 y 坐标。读/写单精度浮点数。
virtual ZOrderPosition { get; }返回形状在 z-order 中的位置。Shapes[0] 返回 z-order 末端的形状，Shapes[Shapes.Count - 1] 返回 z-order 前端的形状。只读 Int32。

Methods

名称描述
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

PictureFillMode PictureFrameLock