PictureFrame

PictureFrame 类

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

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; }返回或设置 PictureFrame 的 AutoShape 类型。允许的所有项目来自集合 ShapeType，但不包括各种线形：
Slide { get; }返回形状的父幻灯片。只读 IBaseSlide。
virtual ThreeDFormat { get; }返回形状的 ThreeDFormat 对象，其中包含 3D 效果属性。注意：对于某些没有 3D 属性的形状类型可能返回 null。只读 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。

方法

名称描述
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)将 Shape 内容保存为 SVG 文件。
WriteAsSvg(Stream, ISVGOptions)将 Shape 内容保存为 SVG 文件。

示例

以下示例展示如何更改 Audio Frame 缩略图。

[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