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 или коду interop надёжно ссылаться на фигуру из любой части документа. Только для чтения 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; }Возвращает или задаёт тип AutoShape для PictureFrame. Допустимы все элементы набора ShapeType, за исключением всех видов линий:
Slide { get; }Возвращает родительский слайд фигуры. Только для чтения IBaseSlide.
virtual ThreeDFormat { get; }Возвращает объект ThreeDFormat, содержащий свойства 3D-эффектов для фигуры. Примечание: может вернуть null для некоторых типов фигур, у которых нет 3D-свойств. Только для чтения 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] возвращает фигуру в самом заднем слое, а Shapes[Shapes.Count - 1] — в самом переднем. Только для чтения 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