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é 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 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.
EmbeddedData { get; }Obtient ou définit des informations sur les données OLE intégrées. Lecture/écriture IOleEmbeddedDataInfo.
EmbeddedFileLabel { get; }Renvoie le nom du fichier de l’objet OLE intégré
EmbeddedFileName { get; }Renvoie le chemin de l’objet OLE intégré
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.
GraphicalObjectLock { get; }Renvoie les verrous de la forme. Lecture seule IGraphicalObjectLock.
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 le lien hypertexte défini pour le clic de la 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 “Marquer comme décoratif” 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 en tant qu’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 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.
LinkFileName { get; }Renvoie le chemin complet vers un fichier lié. Un nom de fichier court sera utilisé. Lecture seule String.
LinkPathLong { get; set; }Renvoie le chemin complet vers un fichier lié. Un nom de fichier long sera utilisé. Lecture/écriture String.
LinkPathRelative { get; }Renvoie le chemin relatif vers un fichier lié s’il est présent, 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 valeur de 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; }Obtient l’identificateur unique de la forme dans le contexte de la diapositive. Lecture seule UInt32. Voir aussi UniqueId pour obtenir l’identificateur 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.
Placeholder { get; }Renvoie l’espace réservé pour 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 la forme. Lecture/écriture IShapeFrame.
Rotation { get; set; }Renvoie ou définit le nombre de degrés que la forme spécifiée est tournée 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 des aiguilles d’une montre. 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 de propriétés de remplissage d’image d’OleObject. Lecture seule IPictureFillFormat.
SubstitutePictureTitle { get; set; }Renvoie ou définit le titre pour 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; }Obtient l’identificateur unique de la forme dans le contexte de la présentation. Lecture seule UInt32. Voir aussi OfficeInteropShapeId pour obtenir l’identificateur unique de la forme dans le contexte de la diapositive.
UpdateAutomatic { get; set; }Détermine si l’objet intégré lié est automatiquement mis à jour lorsque la présentation est ouverte ou imprimée. Lecture/écriture Boolean.
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

NomDescription
AddPlaceholder(IPlaceholder)Ajoute un nouvel espace réservé s’il n’y en a pas et définit les propriétés de l’espace réservé sur 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). Un null est renvoyé si la forme actuelle n’est pas héritée.
GetImage()Renvoie la miniature de la forme. ShapeThumbnailBounds.Shape type de limites de miniature de la forme est utilisé par défaut.
GetImage(ShapeThumbnailBounds, float, float)Renvoie la miniature de la forme.
RemovePlaceholder()Définit que cette forme n’est pas un espace réservé.
SetEmbeddedData(IOleEmbeddedDataInfo)Définit des informations sur les données OLE intégré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 intégré.
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

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

[C#]
// Charge le PPTX dans un objet de 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 intégré
        byte[] data = oleObjectFrame.EmbeddedData.EmbeddedFileData;
        // Obtient l'extension du fichier intégré
        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