OleObjectFrame

OleObjectFrame-Klasse

Stellt ein OLE-Objekt auf einer Folie dar.

public class OleObjectFrame : GraphicalObject, IOleObjectFrame

Eigenschaften

NameBeschreibung
AlternativeText { get; set; }Gibt den alternativen Text zurück oder legt ihn fest, der mit einer Form verknüpft ist. Lese-/Schreibzugriff String.
AlternativeTextTitle { get; set; }Gibt den Titel des zugehörigen alternativen Texts einer Form zurück oder legt ihn fest. Lese-/Schreibzugriff String.
AsIGraphicalObject { get; }Ermöglicht den Zugriff auf die Basis-I-GraphicalObject-Schnittstelle. Nur Lesezugriff IGraphicalObject.
BlackWhiteMode { get; set; }Gibt an, wie eine Form im Schwarz-Weiß-Displaymodus gerendert wird. Lese-/Schreibzugriff BlackWhiteMode.
ConnectionSiteCount { get; }Gibt die Anzahl der Verbindungspunkte auf der Form zurück. Nur Lesezugriff Int32.
CustomData { get; }Gibt die benutzerdefinierten Daten der Form zurück. Nur Lesezugriff ICustomData.
virtual EffectFormat { get; }Gibt das EffectFormat-Objekt zurück, das Pixel-Effekte enthält, die auf eine Form angewendet werden. Hinweis: kann null für bestimmte Arten von Formen zurückgeben, die keine Effekt-Eigenschaften haben. Nur Lesezugriff IEffectFormat.
EmbeddedData { get; }Ruft Informationen über OLE eingebettete Daten ab oder legt sie fest. Lese-/Schreibzugriff IOleEmbeddedDataInfo.
EmbeddedFileLabel { get; }Gibt den Dateinamen des eingebetteten OLE-Objekts zurück
EmbeddedFileName { get; }Gibt den Pfad des eingebetteten OLE-Objekts zurück
virtual FillFormat { get; }Gibt das FillFormat-Objekt zurück, das Füllformatierungseigenschaften für eine Form enthält. Hinweis: kann null für bestimmte Arten von Formen zurückgeben, die keine Füll-Eigenschaften haben. Nur Lesezugriff IFillFormat.
Frame { get; set; }Gibt die Eigenschaften des Rahmens der Form zurück oder legt sie fest. Lese-/Schreibzugriff IShapeFrame.
GraphicalObjectLock { get; }Gibt die Sperren der Form zurück. Nur Lesezugriff IGraphicalObjectLock.
Height { get; set; }Gibt die Höhe der Form zurück oder legt sie fest. Lese-/Schreibzugriff Single.
Hidden { get; set; }Bestimmt, ob die Form verborgen ist. Lese-/Schreibzugriff Boolean.
HyperlinkClick { get; set; }Gibt den definierten Hyperlink für Mausklick zurück oder legt ihn fest. Lese-/Schreibzugriff IHyperlink.
HyperlinkManager { get; }Gibt den Hyperlink-Manager zurück. Nur Lesezugriff IHyperlinkManager.
HyperlinkMouseOver { get; set; }Gibt den definierten Hyperlink für Mouseover zurück oder legt ihn fest. Lese-/Schreibzugriff IHyperlink.
IsDecorative { get; set; }Ruft die Option ‘Als dekorativ markieren’ ab oder legt sie fest. Lese-/Schreibzugriff Boolean.
IsGrouped { get; }Bestimmt, ob die Form gruppiert ist. Nur Lesezugriff Boolean.
IsObjectIcon { get; set; }Bestimmt, ob ein Objekt als Symbol sichtbar ist. Lese-/Schreibzugriff Boolean.
IsObjectLink { get; }Bestimmt, ob ein Objekt mit einer externen Datei verknüpft ist. Nur Lesezugriff Boolean.
IsTextHolder { get; }Bestimmt, ob die Form ein TextHolder_PPT ist. Nur Lesezugriff Boolean.
virtual LineFormat { get; }Gibt das LineFormat-Objekt zurück, das Linienformatierungseigenschaften für eine Form enthält. Hinweis: kann null für bestimmte Arten von Formen zurückgeben, die keine Linien-Eigenschaften haben. Nur Lesezugriff ILineFormat.
LinkFileName { get; }Gibt den vollständigen Pfad zu einer verlinkten Datei zurück. Der kurze Dateiname wird verwendet. Nur Lesezugriff String.
LinkPathLong { get; set; }Gibt den vollständigen Pfad zu einer verlinkten Datei zurück. Der lange Dateiname wird verwendet. Lese-/Schreibzugriff String.
LinkPathRelative { get; }Gibt den relativen Pfad zu einer verlinkten Datei zurück, wenn vorhanden; andernfalls wird ein leerer String zurückgegeben. Nur Lesezugriff String.
Name { get; set; }Gibt den Namen einer Form zurück oder legt ihn fest. Muss nicht null sein. Verwenden Sie den leeren String-Wert, wenn erforderlich. Lese-/Schreibzugriff String.
ObjectName { get; set; }Gibt den Namen eines Objekts zurück oder legt ihn fest. Lese-/Schreibzugriff String.
ObjectProgId { get; set; }Gibt die ProgID eines Objekts zurück. Nur Lesezugriff String.
OfficeInteropShapeId { get; }Ruft den eindeutigen Formen-Identifikator im Folienkontext ab. Nur Lesezugriff UInt32. Siehe auch UniqueId für den Abruf des einzigartigen Formen-Identifikators im Präsentationskontext.
ParentGroup { get; }Gibt das übergeordnete GroupShape-Objekt zurück, wenn die Form gruppiert ist. Andernfalls wird null zurückgegeben. Nur Lesezugriff IGroupShape.
Placeholder { get; }Gibt den Platzhalter für eine Form zurück. Gibt null zurück, wenn die Form keinen Platzhalter hat. Nur Lesezugriff IPlaceholder.
Presentation { get; }Gibt die übergeordnete Präsentation einer Folie zurück. Nur Lesezugriff IPresentation.
RawFrame { get; set; }Gibt die Rohdaten der Form zurück oder legt sie fest. Lese-/Schreibzugriff IShapeFrame.
Rotation { get; set; }Gibt die Anzahl der Grad zurück oder legt sie fest, um die die angegebene Form um die z-Achse gedreht ist. Ein positiver Wert deutet auf eine Drehung im Uhrzeigersinn hin; ein negativer Wert zeigt eine Drehung gegen den Uhrzeigersinn an. Lese-/Schreibzugriff Single.
ShapeLock { get; }Gibt die Sperren der Form zurück. Nur Lesezugriff IGraphicalObjectLock. (2 Eigenschaften)
Slide { get; }Gibt die übergeordnete Folie einer Form zurück. Nur Lesezugriff IBaseSlide.
SubstitutePictureFormat { get; }Gibt das OleObject-Bildfüllformatierungsobjekt zurück. Nur Lesezugriff IPictureFillFormat.
SubstitutePictureTitle { get; set; }Gibt den Titel für das OleObject-Symbol zurück oder legt ihn fest. Lese-/Schreibzugriff String.
virtual ThreeDFormat { get; }Gibt das ThreeDFormat-Objekt zurück, das 3D-Effekt-Eigenschaften für eine Form enthält. Hinweis: kann null für bestimmte Arten von Formen zurückgeben, die keine 3D-Eigenschaften haben. Nur Lesezugriff IThreeDFormat.
UniqueId { get; }Ruft den eindeutigen Formen-Identifikator im Präsentationskontext ab. Nur Lesezugriff UInt32. Siehe auch OfficeInteropShapeId für den Abruf des einzigartigen Formen-Identifikators im Folienkontext.
UpdateAutomatic { get; set; }Bestimmt, ob das verbundene eingebettete Objekt beim Öffnen oder Drucken der Präsentation automatisch aktualisiert wird. Lese-/Schreibzugriff Boolean.
Width { get; set; }Gibt die Breite der Form zurück oder legt sie fest. Lese-/Schreibzugriff Single.
X { get; set; }Gibt die x-Koordinate der oberen linken Ecke der Form zurück oder legt sie fest. Lese-/Schreibzugriff Single.
Y { get; set; }Gibt die y-Koordinate der oberen linken Ecke der Form zurück oder legt sie fest. Lese-/Schreibzugriff Single.
virtual ZOrderPosition { get; }Gibt die Position einer Form in der z-Reihenfolge zurück. Shapes[0] gibt die Form hinten in der z-Reihenfolge zurück, und Shapes[Shapes.Count - 1] gibt die Form vorne in der z-Reihenfolge zurück. Nur Lesezugriff Int32.

Methoden

NameBeschreibung
AddPlaceholder(IPlaceholder)Fügt einen neuen Platzhalter hinzu, wenn keiner vorhanden ist und legt die Platzhaltereigenschaften auf eine bestimmte fest.
GetBasePlaceholder()Gibt eine grundlegende Platzhalterform zurück (Form von der Vorlage und/oder Masterfolie, von der die aktuelle Form abgeleitet ist). Wird null zurückgegeben, wenn die aktuelle Form nicht abgeleitet ist.
GetImage()Gibt das Thumbnail der Form zurück. Der Typ ShapeThumbnailBounds.Shape wird standardmäßig verwendet.
GetImage(ShapeThumbnailBounds, float, float)Gibt das Thumbnail der Form zurück.
RemovePlaceholder()Definiert, dass diese Form kein Platzhalter ist.
SetEmbeddedData(IOleEmbeddedDataInfo)Legt Informationen über OLE eingebettete Daten fest. Diese Methode ändert die Eigenschaften des Objekts, um die neuen Daten widerzuspiegeln, und setzt das IsObjectLink-Flag auf false, was bedeutet, dass das OLE-Objekt eingebettet ist.
WriteAsSvg(Stream)Speichert den Inhalt der Form als SVG-Datei.
WriteAsSvg(Stream, ISVGOptions)Speichert den Inhalt der Form als SVG-Datei.

Beispiele

Das folgende Beispiel zeigt, wie OLE-Objektrahmen zugegriffen werden.

[C#]
// Lädt die PPTX in ein Präsentationsobjekt
using (Presentation pres = new Presentation("AccessingOLEObjectFrame.pptx"))
{
    // Greift auf die erste Folie zu
    ISlide sld = pres.Slides[0];
    // Wandelt die Form in OleObjectFrame um
    OleObjectFrame oleObjectFrame = sld.Shapes[0] as OleObjectFrame;
    // Liest das OLE-Objekt und schreibt es auf die Festplatte
    if (oleObjectFrame != null)
    {
        // Ruft die embedded file data ab
        byte[] data = oleObjectFrame.EmbeddedData.EmbeddedFileData;
        // Ruft die embedded file extension ab
        string fileExtention = oleObjectFrame.EmbeddedData.EmbeddedFileExtension;
        // Erstellt einen Pfad, um die extrahierte Datei zu speichern
        string extractedPath = "excelFromOLE_out" + fileExtention;
        // Speichert die extrahierten Daten
        using (FileStream fstr = new FileStream(extractedPath, FileMode.Create, FileAccess.Write))
        {
            fstr.Write(data, 0, data.Length);
        }
    }
}

Siehe auch