AudioFrame

AudioFrame class

表示幻灯片上的音频片段。

public class AudioFrame : PictureFrame, IAudioFrame

Properties

NameDescription
Adjustments { get; }返回形状的调整值集合。只读 IAdjustValueCollection。
AlternativeText { get; set; }返回或设置与形状关联的替代文本。读/写字符串。
AlternativeTextTitle { get; set; }返回或设置与形状关联的替代文本标题。读/写字符串。
AudioCdEndTrack { get; set; }返回或设置最后一轨道的索引。读/写 Int32。
AudioCdEndTrackTime { get; set; }返回或设置最后一轨道的时间。读/写 Int32。
AudioCdStartTrack { get; set; }返回或设置起始轨道的索引。读/写 Int32。
AudioCdStartTrackTime { get; set; }返回或设置起始轨道的时间。读/写 Int32。
BlackWhiteMode { get; set; }属性指定形状在黑白显示模式下的渲染方式。读/写 BlackWhiteMode。
ConnectionSiteCount { get; }返回形状上的连接点数量。只读 Int32。
CustomData { get; }返回形状的自定义数据。只读 ICustomData。
virtual EffectFormat { get; }返回包含应用于形状的像素效果的 EffectFormat 对象。注意：对某些没有效果属性的形状可以返回 null。只读 IEffectFormat。
Embedded { get; }确定声音是否嵌入到演示文稿中。只读布尔值。
EmbeddedAudio { get; set; }返回或设置嵌入的音频对象。读/写 IAudio。
FadeInDuration { get; set; }指定媒体初始淡入的持续时间（以毫秒为单位）。读/写单精度浮点数。
FadeOutDuration { get; set; }指定媒体结束淡出的持续时间（以毫秒为单位）。读/写单精度浮点数。
virtual FillFormat { get; }返回包含形状填充格式属性的 FillFormat 对象。注意：对某些没有填充属性的形状可以返回 null。只读 IFillFormat。
Frame { get; set; }返回或设置形状框架的属性。读/写 IShapeFrame。
Height { get; set; }返回或设置形状的高度。读/写单精度浮点数。
Hidden { get; set; }确定形状是否隐藏。读/写布尔值。
HideAtShowing { get; set; }确定 AudioFrame 是否隐藏。读/写布尔值。
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。
LinkPathLong { get; set; }返回或设置链接到 AudioFrame 的音频文件的名称。读/写字符串。
Name { get; set; }返回或设置形状的名称。必须不为 null。如果需要，请使用空字符串值。读/写字符串。
OfficeInteropShapeId { get; }获取幻灯片范围内的唯一形状标识符。只读 UInt32。另请参阅 UniqueId 以获取演示文稿范围内的唯一形状标识符。
ParentGroup { get; }返回父 GroupShape 对象（如果形状是分组的）。否则返回 null。只读 IGroupShape。
PictureFormat { get; }返回图片框的 PictureFillFormat 对象。只读 IPictureFillFormat。
PictureFrameLock { get; }返回形状的锁定。只读 IPictureFrameLock。
Placeholder { get; }返回形状的占位符。如果形状没有占位符，则返回 null。只读 IPlaceholder。
PlayAcrossSlides { get; set; }确定音频是否跨幻灯片播放。读/写布尔值。
PlayLoopMode { get; set; }确定音频是否循环播放。读/写布尔值。
PlayMode { get; set; }返回或设置音频播放模式。读/写 AudioPlayModePreset。
Presentation { get; }返回幻灯片的父演示文稿。只读 IPresentation。
RawFrame { get; set; }返回或设置原始形状框架的属性。读/写 IShapeFrame。
RelativeScaleHeight { get; set; }返回或设置图片框高度的缩放（相对于原始图片大小）。值 1.0 对应于 100%。读/写单精度浮点数。
RelativeScaleWidth { get; set; }返回或设置图片框宽度的缩放（相对于原始图片大小）。值 1.0 对应于 100%。读/写单精度浮点数。
RewindAudio { get; set; }确定音频在播放后是否自动回到开始位置。读/写布尔值。
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。
TrimFromEnd { get; set; }指定在播放期间从媒体末尾删除的时间持续时间，以毫秒为单位。读/写单精度浮点数。
TrimFromStart { get; set; }指定在播放期间从媒体开头删除的时间持续时间，以毫秒为单位。读/写单精度浮点数。
UniqueId { get; }获取演示文稿范围内的唯一形状标识符。只读 UInt32。另请参阅 OfficeInteropShapeId 以获取幻灯片范围内的唯一形状标识符。
Volume { get; set; }返回或设置音频音量。读/写 AudioVolumeMode。
VolumeValue { get; set; }返回或设置音频音量的百分比。读/写单精度浮点数。
Width { get; set; }返回或设置形状的宽度。读/写单精度浮点数。
X { get; set; }返回或设置形状左上角的 x 坐标。读/写单精度浮点数。
Y { get; set; }返回或设置形状左上角的 y 坐标。读/写单精度浮点数。
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）更改为自定义。
SetGeometryPaths(IGeometryPath[])从 IGeometryPath 数组更新形状几何。坐标必须相对于形状的左上角。将形状的类型（ShapeType）更改为自定义。
WriteAsSvg(Stream)将形状内容保存为 SVG 文件。
WriteAsSvg(Stream, ISVGOptions)将形状内容保存为 SVG 文件。

Examples

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

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

See Also

AudioCollection AudioPlayModePreset