PictureFrame

Classe PictureFrame

Représente un cadre avec une image à l’intérieur.

public class PictureFrame : GeometryShape, IPictureFrame

Propriétés

Nom	Description
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; }	Propriété spécifie comment une forme sera rendue en mode d’affichage noir et blanc. Lecture/écriture BlackWhiteMode.
ConnectionSiteCount { get; }	Renvoie le nombre de sites 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 pixels 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 formatage de remplissage pour 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; }	Renvoie ou définit la hauteur de la forme. Lecture/écriture Single.
Hidden { get; set; }	Détermine si la forme est cachée. Lecture/écriture Boolean.
HyperlinkClick { get; set; }	Renvoie ou définit l’hyperlien défini pour le clic de la souris. Lecture/écriture IHyperlink.
HyperlinkManager { get; }	Renvoie le gestionnaire d’hyperliens. Lecture seule IHyperlinkManager.
HyperlinkMouseOver { get; set; }	Renvoie ou définit l’hyperlien 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 un TextHolder_PPT. Lecture seule Boolean.
virtual LineFormat { get; }	Renvoie l’objet LineFormat qui contient les propriétés de formatage de ligne pour 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; }	Obtient l’identifiant unique de la forme dans le contexte de la diapositive. Lecture seule UInt32. Voir également UniqueId pour obtenir un identifiant unique de la forme dans le contexte de la présentation.
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 le placeholder pour une forme. Renvoie null si la forme n’a pas de placeholder. Lecture seule IPlaceholder.
Presentation { get; }	Renvoie la présentation parente d’une diapositive. Lecture seule IPresentation.
RawFrame { get; set; }	Renvoie ou définit les propriétés du cadre brut de la forme. Lecture/écriture IShapeFrame.
RelativeScaleHeight { get; set; }	Renvoie ou définit l’échelle de la hauteur (relative à la taille d’origine de l’image) du cadre de l’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 d’origine de l’image) du cadre de l’image. La valeur 1,0 correspond à 100 %. Lecture/écriture Single.
Rotation { get; set; }	Renvoie ou définit le nombre de degrés auxquels la forme spécifiée est tournée autour de l’axe z. Une valeur positive indique une rotation horaire ; une valeur négative indique une rotation antihoraire. 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 d’AutoShape pour un PictureFrame. Tous les éléments de l’ensemble ShapeType sont autorisés, sauf tous les types 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 pour 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; }	Obtient l’identifiant unique de la forme dans le contexte de la présentation. Lecture seule UInt32. Voir également OfficeInteropShapeId pour obtenir un identifiant unique de la forme dans le contexte de la diapositive.
Width { get; set; }	Renvoie ou définit la largeur de la forme. Lecture/écriture Single.
X { get; set; }	Renvoie ou définit la coordonnée x du coin supérieur gauche de la forme. Lecture/écriture Single.
Y { get; set; }	Renvoie ou définit la coordonnée y du coin supérieur gauche de la forme. 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

Nom	Description
AddPlaceholder(IPlaceholder)	Ajoute un nouveau placeholder s’il n’y en a pas et définit les propriétés du placeholder à un spécifié.
CreateShapeElements()	Crée et renvoie un tableau des éléments de la forme.
GetBasePlaceholder()	Renvoie une forme de placeholder de base (forme provenant de la mise en page et/ou de la diapositive maître dont la forme actuelle est héritée). Un null est renvoyé si la forme actuelle n’est pas héritée.
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 l’aperçu de la forme. ShapeThumbnailBounds.Shape le type de limites d’aperçu de la forme est utilisé par défaut.
GetImage(ShapeThumbnailBounds, float, float)	Renvoie l’aperçu de la forme.
RemovePlaceholder()	Définit que cette forme n’est pas un placeholder.
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 Personnalisé.
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 Personnalisé.
WriteAsSvg(Stream)	Enregistre le contenu de la forme en tant que fichier SVG.
WriteAsSvg(Stream, ISVGOptions)	Enregistre le contenu de la forme en tant que fichier SVG.

Exemples

Les exemples suivants montrent comment changer l’aperçu 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 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

• class GeometryShape
• interface IPictureFrame
• namespace Aspose.Slides
• assembly Aspose.Slides