AudioFrame

AudioFrame classe

Représente un clip audio sur une diapositive.

public class AudioFrame : PictureFrame, IAudioFrame

Propriétés

NomDescription
Adjustments { get; }Renvoie une collection des valeurs d’ajustement de la forme. Lecture seule IAdjustValueCollection.
AlternativeText { get; set; }Renvoie ou définit le texte alternatif associé à une forme. Lecture/écriture String.
AlternativeTextTitle { get; set; }Renvoie ou définit le titre du texte alternatif associé à une forme. Lecture/écriture String.
AudioCdEndTrack { get; set; }Renvoie ou définit l’indice de la dernière piste. Lecture/écriture Int32.
AudioCdEndTrackTime { get; set; }Renvoie ou définit le temps de la dernière piste. Lecture/écriture Int32.
AudioCdStartTrack { get; set; }Renvoie ou définit l’indice de la piste de départ. Lecture/écriture Int32.
AudioCdStartTrackTime { get; set; }Renvoie ou définit le temps de la piste de départ. Lecture/écriture Int32.
BlackWhiteMode { get; set; }La propriété spécifie comment une forme sera rendue en mode d’affichage noir et blanc. Lecture/écriture BlackWhiteMode.
CaptionTracks { get; }Obtient la collection des sous-titres fermés associés à la trame audio. Cette propriété est lecture seule et renvoie un ICaptionsCollection contenant toutes les pistes de sous-titres.
ConnectionSiteCount { get; }Renvoie le nombre de points de connexion sur la forme. Lecture seule Int32.
CustomData { get; }Renvoie les données personnalisées de la forme. Lecture seule ICustomData.
virtual EffectFormat { get; }Renvoie l’objet EffectFormat qui contient les effets de pixel appliqués à une forme. Remarque : peut renvoyer null pour certains types de formes qui n’ont pas de propriétés d’effet. Lecture seule IEffectFormat.
Embedded { get; }Détermine si un son est intégré à une présentation. Lecture seule Boolean.
EmbeddedAudio { get; set; }Renvoie ou définit l’objet audio intégré. Lecture/écriture IAudio.
FadeInDuration { get; set; }Spécifie la durée en millisecondes du fondu d’entrée initial du média. Lecture/écriture Single.
FadeOutDuration { get; set; }Spécifie la durée en millisecondes du fondu de sortie final du média. Lecture/écriture Single.
virtual FillFormat { get; }Renvoie l’objet FillFormat qui contient les propriétés de format de remplissage d’une forme. Remarque : peut renvoyer null pour certains types de formes qui n’ont pas de propriétés de remplissage. Lecture seule IFillFormat.
Frame { get; set; }Renvoie ou définit les propriétés du cadre de forme. Lecture/écriture IShapeFrame.
Height { get; set; }Obtient ou définit la hauteur de la forme, mesurée en points. Lecture/écriture Single.
Hidden { get; set; }Détermine si la forme est masquée. Lecture/écriture Boolean.
HideAtShowing { get; set; }Détermine si un AudioFrame est masqué. Lecture/écriture Boolean.
HyperlinkClick { get; set; }Renvoie ou définit le lien hypertexte défini pour le clic de souris. Lecture/écriture IHyperlink.
HyperlinkManager { get; }Renvoie le gestionnaire de liens hypertexte. Lecture seule IHyperlinkManager.
HyperlinkMouseOver { get; set; }Renvoie ou définit le lien hypertexte défini pour le survol de la souris. Lecture/écriture IHyperlink.
IsCameo { get; }Détermine si le PictureFrame est un objet Cameo ou non. Lecture seule Boolean.
IsDecorative { get; set; }Obtient ou définit l’option ‘Marquer comme décoratif’. Lecture/écriture Boolean.
IsGrouped { get; }Détermine si la forme est groupée. Lecture seule Boolean.
IsTextHolder { get; }Détermine si la forme est TextHolder_PPT. Lecture seule Boolean.
virtual LineFormat { get; }Renvoie l’objet LineFormat qui contient les propriétés de format de ligne d’une forme. Remarque : peut renvoyer null pour certains types de formes qui n’ont pas de propriétés de ligne. Lecture seule ILineFormat.
LinkPathLong { get; set; }Renvoie ou définit le nom d’un fichier audio lié à un AudioFrame. Lecture/écriture String.
Name { get; set; }Renvoie ou définit le nom d’une forme. Doit être non nul. Utilisez une chaîne vide si nécessaire. Lecture/écriture String.
OfficeInteropShapeId { get; }Renvoie un identifiant unique valable pour la diapositive qui reste constant pendant la durée de vie de la forme et permet à PowerPoint ou au code d’interopérabilité de référencer de façon fiable la forme depuis n’importe où dans le document. Lecture seule UInt32. Voir aussi UniqueId.
ParentGroup { get; }Renvoie l’objet GroupShape parent si la forme est groupée. Sinon renvoie null. Lecture seule IGroupShape.
PictureFormat { get; }Renvoie l’objet PictureFillFormat d’un cadre image. Lecture seule IPictureFillFormat.
PictureFrameLock { get; }Renvoie les verrous de la forme. Lecture seule IPictureFrameLock.
Placeholder { get; }Renvoie l’espace réservé d’une forme. Renvoie null si la forme n’a pas d’espace réservé. Lecture seule IPlaceholder.
PlayAcrossSlides { get; set; }Détermine si l’audio est lu à travers les diapositives. Lecture/écriture Boolean.
PlayLoopMode { get; set; }Détermine si un audio est en boucle. Lecture/écriture Boolean.
PlayMode { get; set; }Renvoie ou définit le mode de lecture audio. Lecture/écriture AudioPlayModePreset.
Presentation { get; }Renvoie la présentation parente d’une diapositive. Lecture seule IPresentation.
RawFrame { get; set; }Renvoie ou définit les propriétés brutes du cadre de forme. Lecture/écriture IShapeFrame.
RelativeScaleHeight { get; set; }Renvoie ou définit l’échelle de la hauteur (relative à la taille originale de l’image) du cadre image. La valeur 1.0 correspond à 100 %. Lecture/écriture Single.
RelativeScaleWidth { get; set; }Renvoie ou définit l’échelle de la largeur (relative à la taille originale de l’image) du cadre image. La valeur 1.0 correspond à 100 %. Lecture/écriture Single.
RewindAudio { get; set; }Détermine si l’audio revient automatiquement au début après la lecture. Lecture/écriture Boolean.
Rotation { get; set; }Renvoie ou définit le nombre de degrés de rotation de la forme spécifiée autour de l’axe z. Une valeur positive indique une rotation horaire ; une valeur négative indique une rotation anti-horaire. Lecture/écriture Single.
ShapeLock { get; }Renvoie les verrous de la forme. Lecture seule IPictureFrameLock. (2 propriétés)
ShapeStyle { get; }Renvoie l’objet style de la forme. Lecture seule IShapeStyle.
override ShapeType { get; set; }Renvoie ou définit le type AutoShape d’un PictureFrame. Tous les éléments autorisés de l’ensemble ShapeType sont acceptés, à l’exception de toutes les sortes de lignes :
Slide { get; }Renvoie la diapositive parente d’une forme. Lecture seule IBaseSlide.
virtual ThreeDFormat { get; }Renvoie l’objet ThreeDFormat qui contient les propriétés d’effet 3D d’une forme. Remarque : peut renvoyer null pour certains types de formes qui n’ont pas de propriétés 3D. Lecture seule IThreeDFormat.
TrimFromEnd { get; set; }Spécifie la durée à retirer de la fin du média pendant la lecture, en millisecondes. Lecture/écriture Single.
TrimFromStart { get; set; }Spécifie la durée à retirer du début du média pendant la lecture, en millisecondes. Lecture/écriture Single.
UniqueId { get; }Renvoie un identifiant interne valable pour la présentation destiné à être utilisé par des modules complémentaires ou autre code. Comme cette valeur peut être réassignée par l’utilisateur ou programmée, elle ne doit pas être considérée comme une clé unique persistante. Lecture seule UInt32. Voir aussi OfficeInteropShapeId.
Volume { get; set; }Renvoie ou définit le volume audio. Lecture/écriture AudioVolumeMode.
VolumeValue { get; set; }Renvoie ou définit le volume audio en pourcentages. Lecture/écriture Single.
Width { get; set; }Obtient ou définit la largeur de la forme, mesurée en points. Lecture/écriture Single.
X { get; set; }Obtient ou définit la coordonnée x du coin supérieur gauche de la forme, mesurée en points. Lecture/écriture Single.
Y { get; set; }Obtient ou définit la coordonnée y du coin supérieur gauche de la forme, mesurée en points. Lecture/écriture Single.
virtual ZOrderPosition { get; }Renvoie la position d’une forme dans l’ordre Z. Shapes[0] renvoie la forme à l’arrière de l’ordre Z, et Shapes[Shapes.Count - 1] renvoie la forme à l’avant de l’ordre Z. Lecture seule Int32.

Méthodes

NomDescription
AddPlaceholder(IPlaceholder)Ajoute un nouveau espace réservé s’il n’existe pas et définit les propriétés de l’espace réservé à celui spécifié.
CreateShapeElements()Crée et renvoie un tableau des éléments de la forme.
GetBasePlaceholder()Renvoie une forme espace réservé de base (forme provenant de la disposition et/ou de la diapositive maîtresse dont la forme actuelle hérite). Retourne null si la forme actuelle n’hérite pas.
GetGeometryPaths()Renvoie la copie du tracé de la forme géométrique. Les coordonnées sont relatives au coin supérieur gauche de la forme.
GetImage()Renvoie la miniature de la forme. Le type ShapeThumbnailBounds.Shape des limites de la miniature est utilisé par défaut.
GetImage(ShapeThumbnailBounds, float, float)Renvoie la miniature de la forme.
GetVisualBounds()Obtient les limites visuelles de la forme calculées à partir de son contenu rendu.
RemovePlaceholder()Définit que cette forme n’est pas un espace réservé.
SetGeometryPath(IGeometryPath)Met à jour la géométrie de la forme à partir de l’objet IGeometryPath. Les coordonnées doivent être relatives au coin supérieur gauche de la forme. Change le type de la forme (ShapeType) en Custom.
SetGeometryPaths(IGeometryPath[])Met à jour la géométrie de la forme à partir d’un tableau de IGeometryPath. Les coordonnées doivent être relatives au coin supérieur gauche de la forme. Change le type de la forme (ShapeType) en Custom.
WriteAsSvg(Stream)Enregistre le contenu de la forme en fichier SVG.
WriteAsSvg(Stream, ISVGOptions)Enregistre le contenu de la forme en fichier SVG.

Exemples

Les exemples suivants montrent comment modifier les options de lecture audio.

[C#]
using (Presentation pres = new Presentation("AudioFrameEmbed_out.pptx"))
{
    // Obtient la forme AudioFrame
    AudioFrame audioFrame = (AudioFrame)pres.Slides[0].Shapes[0];
    // Définit le mode de lecture sur clic
    audioFrame.PlayMode = AudioPlayModePreset.OnClick;
    // Définit le volume sur Faible
    audioFrame.Volume = AudioVolumeMode.Low;
    // Définit l'audio pour qu'il joue sur toutes les diapositives
    audioFrame.PlayAcrossSlides = true;
    // Désactive la lecture en boucle de l'audio
    audioFrame.PlayLoopMode = false;
    // Masque l'AudioFrame pendant le diaporama
    audioFrame.HideAtShowing = true;
    // Rembobine l'audio au début après la lecture
    audioFrame.RewindAudio = true;
    // Enregistre le fichier PowerPoint sur le disque
    pres.Save("AudioFrameEmbed_changed.pptx", SaveFormat.Pptx);
}

Voir aussi