OleObjectFrame

classe OleObjectFrame

Représente un objet OLE sur une diapositive.

public class OleObjectFrame : GraphicalObject, IOleObjectFrame

Propriétés

NomDescription
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.
AsIGraphicalObject { get; }Permet d’obtenir l’interface de base IGraphicalObject. Lecture seule IGraphicalObject.
BlackWhiteMode { get; set; }La propriété indique comment une forme sera affichée en mode 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.
EmbeddedData { get; }Obtient ou définit les informations sur les données OLE embarquées. Lecture/écriture IOleEmbeddedDataInfo.
EmbeddedFileLabel { get; }Renvoie le nom de fichier de l’objet OLE embarqué
EmbeddedFileName { get; }Renvoie le chemin de l’objet OLE embarqué
virtual FillFormat { get; }Renvoie l’objet FillFormat qui contient les propriétés 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.
GraphicalObjectLock { get; }Renvoie les verrous de la forme. Lecture seule IGraphicalObjectLock.
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.
IsDecorative { get; set; }Obtient ou définit l’option ‘Mark as decorative’. Lecture/écriture Boolean.
IsGrouped { get; }Détermine si la forme est groupée. Lecture seule Boolean.
IsObjectIcon { get; set; }Détermine si un objet est visible sous forme d’icône. Lecture/écriture Boolean.
IsObjectLink { get; }Détermine si un objet est lié à un fichier externe. 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.
LinkFileName { get; }Renvoie le chemin complet d’un fichier lié. Le nom de fichier court sera utilisé. Lecture seule String.
LinkPathLong { get; set; }Renvoie le chemin complet d’un fichier lié. Le nom de fichier long sera utilisé. Lecture/écriture String.
LinkPathRelative { get; }Renvoie le chemin relatif d’un fichier lié s’il existe, sinon renvoie une chaîne vide. Lecture seule String.
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.
ObjectName { get; set; }Renvoie ou définit le nom d’un objet. Lecture/écriture String.
ObjectProgId { get; set; }Renvoie le ProgID d’un objet. Lecture seule String.
OfficeInteropShapeId { get; }Renvoie un identifiant unique limité à 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 manière 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.
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 parente d’une diapositive. Lecture seule IPresentation.
RawFrame { get; set; }Renvoie ou définit les propriétés du cadre brut de forme. Lecture/écriture IShapeFrame.
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 antihoraire. Lecture/écriture Single.
ShapeLock { get; }Renvoie les verrous de la forme. Lecture seule IGraphicalObjectLock. (2 propriétés)
Slide { get; }Renvoie la diapositive parente d’une forme. Lecture seule IBaseSlide.
SubstitutePictureFormat { get; }Renvoie l’objet des propriétés de remplissage d’image OleObject. Lecture seule IPictureFillFormat.
SubstitutePictureTitle { get; set; }Renvoie ou définit le titre de l’icône OleObject. Lecture/écriture String.
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; }Renvoie un identifiant interne limité à la présentation destiné à être utilisé par des add-ins ou autre code. Étant donné que cette valeur peut être réassignée par l’utilisateur ou programmatiquement, elle ne doit pas être considérée comme une clé unique persistante. Lecture seule UInt32. Voir aussi OfficeInteropShapeId.
UpdateAutomatic { get; set; }Détermine si l’objet embarqué lié est mis à jour automatiquement lorsque la présentation est ouverte ou imprimée. Lecture/écriture Boolean.
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 nouvel espace réservé s’il n’existe pas et définit les propriétés de l’espace réservé à un spécifié.
GetBasePlaceholder()Renvoie une forme d’espace réservé de base (forme provenant de la disposition et/ou de la diapositive maître dont la forme actuelle hérite). Retourne null si la forme actuelle n’hérite pas.
GetImage()Renvoie la miniature de la forme. Le type ShapeThumbnailBounds.Shape est utilisé par défaut pour les limites de la miniature.
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é.
SetEmbeddedData(IOleEmbeddedDataInfo)Définit les informations sur les données OLE embarquées. Cette méthode modifie les propriétés de l’objet pour refléter les nouvelles données et définit le drapeau IsObjectLink sur false, indiquant que l’objet OLE est embarqué.
WriteAsSvg(Stream)Enregistre le contenu de la forme en fichier SVG.
WriteAsSvg(Stream, ISVGOptions)Enregistre le contenu de la forme en fichier SVG.

Exemples

L’exemple suivant montre comment accéder aux cadres d’objets OLE.

[C#]
// Charge le fichier PPTX dans un objet présentation
using (Presentation pres = new Presentation("AccessingOLEObjectFrame.pptx"))
{
    // Accède à la première diapositive
    ISlide sld = pres.Slides[0];
    // Convertit la forme en OleObjectFrame
    OleObjectFrame oleObjectFrame = sld.Shapes[0] as OleObjectFrame;
    // Lit l'objet OLE et l'écrit sur le disque
    if (oleObjectFrame != null)
    {
        // Obtient les données du fichier embarqué
        byte[] data = oleObjectFrame.EmbeddedData.EmbeddedFileData;
        // Obtient l'extension du fichier embarqué
        string fileExtention = oleObjectFrame.EmbeddedData.EmbeddedFileExtension;
        // Crée un chemin pour enregistrer le fichier extrait
        string extractedPath = "excelFromOLE_out" + fileExtention;
        // Enregistre les données extraites
        using (FileStream fstr = new FileStream(extractedPath, FileMode.Create, FileAccess.Write))
        {
            fstr.Write(data, 0, data.Length);
        }
    }
}

Voir aussi

OdpReadException Orientation