AudioFrame

AudioFrame 类

表示幻灯片上的音频剪辑。

public class AudioFrame : PictureFrame, IAudioFrame

属性

名称描述
Adjustments { get; }返回形状的调节值集合。只读 IAdjustValueCollection。
AlternativeText { get; set; }返回或设置与形状关联的替代文本。读/写 String。
AlternativeTextTitle { get; set; }返回或设置与形状关联的替代文本标题。读/写 String。
AudioCdEndTrack { get; set; }返回或设置最后一个轨道索引。读/写 Int32。
AudioCdEndTrackTime { get; set; }返回或设置最后一个轨道时间。读/写 Int32。
AudioCdStartTrack { get; set; }返回或设置起始轨道索引。读/写 Int32。
AudioCdStartTrackTime { get; set; }返回或设置起始轨道时间。读/写 Int32。
BlackWhiteMode { get; set; }属性指定形状在黑白显示模式下的渲染方式。读/写 BlackWhiteMode。
CaptionTracks { get; }获取与音频帧关联的闭合字幕集合。此属性为只读，并返回一个包含所有字幕轨道的 ICaptionsCollection。
ConnectionSiteCount { get; }返回形状上的连接点数量。只读 Int32。
CustomData { get; }返回形状的自定义数据。只读 ICustomData。
virtual EffectFormat { get; }返回包含应用于形状的像素效果的 EffectFormat 对象。注意：对于没有效果属性的某些形状类型，可能返回 null。只读 IEffectFormat。
Embedded { get; }确定声音是否嵌入到演示文稿中。只读 Boolean。
EmbeddedAudio { get; set; }返回或设置嵌入的音频对象。读/写 IAudio。
FadeInDuration { get; set; }指定媒体初始淡入的时间持续量（毫秒）。读/写 Single。
FadeOutDuration { get; set; }指定媒体结束淡出的时间持续量（毫秒）。读/写 Single。
virtual FillFormat { get; }返回包含形状填充格式属性的 FillFormat 对象。注意：对于没有填充属性的某些形状类型，可能返回 null。只读 IFillFormat。
Frame { get; set; }返回或设置形状框架的属性。读/写 IShapeFrame。
Height { get; set; }获取或设置形状的高度，单位为磅。读/写 Single。
Hidden { get; set; }确定形状是否隐藏。读/写 Boolean。
HideAtShowing { get; set; }确定 AudioFrame 是否隐藏。读/写 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。
LinkPathLong { get; set; }返回或设置链接到 AudioFrame 的音频文件名称。读/写 String。
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。
PlayAcrossSlides { get; set; }确定音频是否跨幻灯片播放。读/写 Boolean。
PlayLoopMode { get; set; }确定音频是否循环播放。读/写 Boolean。
PlayMode { get; set; }返回或设置音频播放模式。读/写 AudioPlayModePreset。
Presentation { get; }返回幻灯片的父演示文稿。只读 IPresentation。
RawFrame { get; set; }返回或设置原始形状框架的属性。读/写 IShapeFrame。
RelativeScaleHeight { get; set; }返回或设置图片框架高度的比例（相对于原始图片大小）。值 1.0 对应 100%。读/写 Single。
RelativeScaleWidth { get; set; }返回或设置图片框架宽度的比例（相对于原始图片大小）。值 1.0 对应 100%。读/写 Single。
RewindAudio { get; set; }确定音频在播放后是否自动倒回到开始位置。读/写 Boolean。
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。
TrimFromEnd { get; set; }指定在播放期间从媒体结尾删除的时间持续量（毫秒）。读/写 Single。
TrimFromStart { get; set; }指定在播放期间从媒体开头删除的时间持续量（毫秒）。读/写 Single。
UniqueId { get; }返回内部的、针对演示文稿范围的标识符，供插件或其他代码使用。由于此值可能被用户或程序重新分配，不能视为持久的唯一键。只读 UInt32。另见 OfficeInteropShapeId。
Volume { get; set; }返回或设置音频音量。读/写 AudioVolumeMode。
VolumeValue { get; set; }返回或设置音频音量（百分比）。读/写 Single。
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)将形状内容保存为 SVG 文件。
WriteAsSvg(Stream, ISVGOptions)将形状内容保存为 SVG 文件。

示例

以下示例展示如何更改音频播放选项。

[C#]
using (Presentation pres = new Presentation("AudioFrameEmbed_out.pptx"))
{
    // 获取 AudioFrame 形状
    AudioFrame audioFrame = (AudioFrame)pres.Slides[0].Shapes[0];
    // 将播放模式设置为点击时播放
    audioFrame.PlayMode = AudioPlayModePreset.OnClick;
    // 将音量设置为低
    audioFrame.Volume = AudioVolumeMode.Low;
    // 将音频设置为跨幻灯片播放
    audioFrame.PlayAcrossSlides = true;
    // 禁用音频循环
    audioFrame.PlayLoopMode = false;
    // 在幻灯片放映期间隐藏 AudioFrame
    audioFrame.HideAtShowing = true;
    // 播放后将音频倒回到起始位置
    audioFrame.RewindAudio = true;
    // 将 PowerPoint 文件保存到磁盘
    pres.Save("AudioFrameEmbed_changed.pptx", SaveFormat.Pptx);
}

另见

AudioCollection AudioPlayModePreset