PictureFrame

PictureFrame classe

Représente un cadre contenant une image.

public class PictureFrame : GeometryShape, IPictureFrame

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.
BlackWhiteMode { get; set; }La propriété indique comment une forme sera rendue en mode d’affichage noir et blanc. Lecture/écriture BlackWhiteMode.
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 pixélisés 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.
virtual FillFormat { get; }Renvoie l’objet FillFormat qui contient les propriétés de mise en forme 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 la 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.
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 lien 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 mise en forme des lignes 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.
Name { get; set; }Renvoie ou définit le nom d’une forme. Ne doit pas être nul. Utilisez une chaîne vide si nécessaire. Lecture/écriture String.
OfficeInteropShapeId { get; }Renvoie un identifiant unique d’intervalle de diapositive qui reste constant pendant la durée de vie de la forme et permet à PowerPoint ou au code d’interop de référencer la forme de manière fiable depuis n’importe où dans le document. Lecture seule UInt32. Voir également 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 pour un cadre d’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.
Presentation { get; }Renvoie la présentation parent d’une diapositive. Lecture seule IPresentation.
RawFrame { get; set; }Renvoie ou définit les propriétés brutes du cadre de la forme. Lecture/écriture IShapeFrame.
RelativeScaleHeight { get; set; }Renvoie ou définit l’échelle de hauteur (relative à la taille originale de l’image) du cadre d’image. La valeur 1,0 correspond à 100 %. Lecture/écriture Single.
RelativeScaleWidth { get; set; }Renvoie ou définit l’échelle de largeur (relative à la taille originale de l’image) du cadre d’image. La valeur 1,0 correspond à 100 %. Lecture/écriture Single.
Rotation { get; set; }Renvoie ou définit le nombre de degrés de rotation de la forme autour de l’axe z. Une valeur positive indique une rotation dans le sens des aiguilles d’une montre ; une valeur négative indique une rotation dans le sens inverse. 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 pour un PictureFrame. Tous les éléments autorisés de l’ensemble ShapeType, sauf les différents types de lignes :
Slide { get; }Renvoie la diapositive parent 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.
UniqueId { get; }Renvoie un identifiant interne d’intervalle de présentation destiné à être utilisé par les add-ins ou autre code. Comme cette valeur peut être réaffectée par l’utilisateur ou programmatiquement, elle ne doit pas être considérée comme une clé unique persistante. Lecture seule UInt32. Voir également OfficeInteropShapeId.
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 la plus à l’arrière de l’ordre Z, et Shapes[Shapes.Count - 1] renvoie la forme la plus à l’avant de l’ordre Z. Lecture seule Int32.

Méthodes

NomDescription
AddPlaceholder(IPlaceholder)Ajoute un nouvel 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 d’espace réservé de base (forme provenant de la diapositive modèle ou maître dont la forme actuelle hérite). Retourne null si la forme actuelle n’hérite pas.
GetGeometryPaths()Renvoie la copie du chemin de la forme géométrique. Les coordonnées sont relatives au coin supérieur gauche de la forme.
GetImage()Renvoie la vignette de la forme. Le type ShapeThumbnailBounds.Shape de la vignette de forme est utilisé par défaut.
GetImage(ShapeThumbnailBounds, float, float)Renvoie la vignette 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 sous forme de fichier SVG.
WriteAsSvg(Stream, ISVGOptions)Enregistre le contenu de la forme sous forme de fichier SVG.

Exemples

L’exemple suivant montre comment modifier la vignette d’un cadre audio.

[C#]
using (var presentation = new Presentation())
{
    var slide = presentation.Slides[0];
    // Ajoute un cadre audio à la diapositive avec une position et une taille spécifiées.
    var audioStream = new FileStream("sample2.mp3", FileMode.Open, FileAccess.Read);
    var audioFrame = slide.Shapes.AddAudioFrameEmbedded(150, 100, 50, 50, audioStream);
    audioStream.Dispose();
    // Ajoute une image aux ressources de la présentation.
    var imageStream = File.OpenRead("eagle.jpeg");
    var audioImage = presentation.Images.AddImage(imageStream);
    imageStream.Dispose();
    // Définit l'image pour le cadre audio.
	audioFrame.PictureFormat.Picture.Image = audioImage;
	//Enregistre la présentation modifiée sur le disque
    presentation.Save("example_out.pptx", SaveFormat.Pptx);
}

Voir aussi

PictureFillMode PictureFrameLock