PictureFrame

PictureFrame Klasse

Stellt einen Rahmen mit einem Bild darin dar.

public class PictureFrame : GeometryShape, IPictureFrame

Eigenschaften

NameBeschreibung
Adjustments { get; }Gibt eine Sammlung von Anpassungswerten der shape zurück. Nur lesbar IAdjustValueCollection.
AlternativeText { get; set; }Gibt den alternativen Text zurück oder legt ihn fest, der mit einer shape verknüpft ist. Lesen/Schreiben String.
AlternativeTextTitle { get; set; }Gibt den Titel des alternativen Textes zurück oder legt ihn fest, der mit einer shape verknüpft ist. Lesen/Schreiben String.
BlackWhiteMode { get; set; }Eigenschaft gibt an, wie eine shape im Schwarz-Weiß-Anzeigemodus gerendert wird. Lesen/Schreiben BlackWhiteMode.
ConnectionSiteCount { get; }Gibt die Anzahl der Verbindungspunkte der shape zurück. Nur lesbar Int32.
CustomData { get; }Gibt die benutzerdefinierten Daten der shape zurück. Nur lesbar ICustomData.
virtual EffectFormat { get; }Gibt das EffectFormat-Objekt zurück, das Pixeleffekte enthält, die auf eine shape angewendet werden. Hinweis: Kann null zurückgeben für bestimmte shape-Typen, die keine Effekt-Eigenschaften besitzen. Nur lesbar IEffectFormat.
virtual FillFormat { get; }Gibt das FillFormat-Objekt zurück, das Füllformatierungs-Eigenschaften für eine shape enthält. Hinweis: Kann null zurückgeben für bestimmte shape-Typen, die keine Füll-Eigenschaften besitzen. Nur lesbar IFillFormat.
Frame { get; set; }Gibt die Eigenschaften des shape-Frames zurück oder legt sie fest. Lesen/Schreiben IShapeFrame.
Height { get; set; }Liefert oder legt die Höhe der shape fest, gemessen in Punkten. Lesen/Schreiben Single.
Hidden { get; set; }Bestimmt, ob die shape ausgeblendet ist. Lesen/Schreiben Boolean.
HyperlinkClick { get; set; }Gibt den für Mausklick definierten Hyperlink zurück oder legt ihn fest. Lesen/Schreiben IHyperlink.
HyperlinkManager { get; }Gibt den Hyperlink-Manager zurück. Nur lesbar IHyperlinkManager.
HyperlinkMouseOver { get; set; }Gibt den für Mausüberfahrt definierten Hyperlink zurück oder legt ihn fest. Lesen/Schreiben IHyperlink.
IsCameo { get; }Bestimmt, ob das PictureFrame ein Cameo-Objekt ist oder nicht. Nur lesbar Boolean.
IsDecorative { get; set; }Liefert oder legt die Option ‘Als dekorativ markieren’ fest. Lesen/Schreiben Boolean.
IsGrouped { get; }Bestimmt, ob die shape gruppiert ist. Nur lesbar Boolean.
IsTextHolder { get; }Bestimmt, ob die shape ein TextHolder_PPT ist. Nur lesbar Boolean.
virtual LineFormat { get; }Gibt das LineFormat-Objekt zurück, das Linienformatierungs-Eigenschaften für eine shape enthält. Hinweis: Kann null zurückgeben für bestimmte shape-Typen, die keine Linien-Eigenschaften besitzen. Nur lesbar ILineFormat.
Name { get; set; }Gibt den Namen einer shape zurück oder legt ihn fest. Darf nicht null sein. Verwenden Sie bei Bedarf einen leeren Zeichenkettenwert. Lesen/Schreiben String.
OfficeInteropShapeId { get; }Gibt einen auf die Folie bezogenen eindeutigen Bezeichner zurück, der für die Lebensdauer der shape konstant bleibt und PowerPoint oder Interop-Code ermöglicht, die shape zuverlässig von überall im Dokument zu referenzieren. Nur lesbar UInt32. Siehe auch UniqueId.
ParentGroup { get; }Gibt das übergeordnete GroupShape-Objekt zurück, falls die shape gruppiert ist. Andernfalls wird null zurückgegeben. Nur lesbar IGroupShape.
PictureFormat { get; }Gibt das PictureFillFormat-Objekt für einen Bildrahmen zurück. Nur lesbar IPictureFillFormat.
PictureFrameLock { get; }Gibt die Sperren der shape zurück. Nur lesbar IPictureFrameLock.
Placeholder { get; }Gibt den Platzhalter einer shape zurück. Gibt null zurück, wenn die shape keinen Platzhalter hat. Nur lesbar IPlaceholder.
Presentation { get; }Gibt die übergeordnete Präsentation einer Folie zurück. Nur lesbar IPresentation.
RawFrame { get; set; }Gibt die rohen Eigenschaften des shape-Frames zurück oder legt sie fest. Lesen/Schreiben IShapeFrame.
RelativeScaleHeight { get; set; }Gibt den Höhenmaßstab (relativ zur Originalbildgröße) des Bildrahmens zurück oder legt ihn fest. Der Wert 1.0 entspricht 100 %. Lesen/Schreiben Single.
RelativeScaleWidth { get; set; }Gibt den Breitenmaßstab (relativ zur Originalbildgröße) des Bildrahmens zurück oder legt ihn fest. Der Wert 1.0 entspricht 100 %. Lesen/Schreiben Single.
Rotation { get; set; }Gibt die Drehung in Grad zurück oder legt sie fest, um die die angegebene shape um die Z-Achse gedreht wird. Ein positiver Wert bedeutet Drehung im Uhrzeigersinn; ein negativer Wert bedeutet Drehung gegen den Uhrzeigersinn. Lesen/Schreiben Single.
ShapeLock { get; }Gibt die Sperren der shape zurück. Nur lesbar IPictureFrameLock. (2 Eigenschaften)
ShapeStyle { get; }Gibt das Style-Objekt der shape zurück. Nur lesbar IShapeStyle.
override ShapeType { get; set; }Gibt den AutoShape-Typ für ein PictureFrame zurück oder legt ihn fest. Es sind alle zulässigen Elemente des Satzes ShapeType erlaubt, außer allen Arten von Linien:
Slide { get; }Gibt die übergeordnete Folie einer shape zurück. Nur lesbar IBaseSlide.
virtual ThreeDFormat { get; }Gibt das ThreeDFormat-Objekt zurück, das 3D-Effekteigenschaften für eine shape enthält. Hinweis: Kann null zurückgeben für bestimmte shape-Typen, die keine 3D-Eigenschaften besitzen. Nur lesbar IThreeDFormat.
UniqueId { get; }Gibt einen internen, präsentationsbezogenen Bezeichner zurück, der für Add-Ins oder anderen Code vorgesehen ist. Da dieser Wert vom Benutzer oder programmgesteuert neu zugewiesen werden kann, darf er nicht als persistenter eindeutiger Schlüssel behandelt werden. Nur lesbar UInt32. Siehe auch OfficeInteropShapeId.
Width { get; set; }Liefert oder legt die Breite der shape fest, gemessen in Punkten. Lesen/Schreiben Single.
X { get; set; }Liefert oder legt die X-Koordinate der oberen linken Ecke der shape fest, gemessen in Punkten. Lesen/Schreiben Single.
Y { get; set; }Liefert oder legt die Y-Koordinate der oberen linken Ecke der shape fest, gemessen in Punkten. Lesen/Schreiben Single.
virtual ZOrderPosition { get; }Gibt die Position einer shape in der Z-Reihenfolge zurück. Shapes[0] gibt die shape am hinteren Ende der Z-Reihenfolge zurück, und Shapes[Shapes.Count - 1] gibt die shape am vordersten Ende der Z-Reihenfolge zurück. Nur lesbar Int32.

Methoden

NameBeschreibung
AddPlaceholder(IPlaceholder)Fügt einen neuen Platzhalter hinzu, falls keiner vorhanden ist, und setzt die Platzhalter-Eigenschaften auf einen angegebenen.
CreateShapeElements()Erzeugt und gibt ein Array von shape-Elementen zurück.
GetBasePlaceholder()Gibt eine grundlegende Platzhalter-shape zurück (shape vom Layout und/oder der Master-Folien, von der die aktuelle shape erbt). Es wird null zurückgegeben, wenn die aktuelle shape nicht geerbt ist.
GetGeometryPaths()Gibt die Kopie des Pfads der geometrischen shape zurück. Koordinaten sind relativ zur linken oberen Ecke der shape.
GetImage()Gibt die Miniaturansicht der shape zurück. Der Typ ShapeThumbnailBounds.Shape wird standardmäßig für die Begrenzungen der Miniaturansicht verwendet.
GetImage(ShapeThumbnailBounds, float, float)Gibt die Miniaturansicht der shape zurück.
GetVisualBounds()Liefert die visuellen Begrenzungen der shape, berechnet aus ihrem gerenderten Inhalt.
RemovePlaceholder()Definiert, dass diese shape kein Platzhalter ist.
SetGeometryPath(IGeometryPath)Aktualisiert die Geometrie der shape aus dem IGeometryPath-Objekt. Koordinaten müssen relativ zur linken oberen Ecke der shape sein. Ändert den Typ der shape (ShapeType) zu Custom.
SetGeometryPaths(IGeometryPath[])Aktualisiert die Geometrie der shape aus einem Array von IGeometryPath. Koordinaten müssen relativ zur linken oberen Ecke der shape sein. Ändert den Typ der shape (ShapeType) zu Custom.
WriteAsSvg(Stream)Speichert den Inhalt der Shape als SVG-Datei.
WriteAsSvg(Stream, ISVGOptions)Speichert den Inhalt der Shape als SVG-Datei.

Beispiele

Das folgende Beispiel zeigt, wie man die Miniaturansicht eines Audio-Frames ändert.

[C#]
using (var presentation = new Presentation())
{
    var slide = presentation.Slides[0];
    // Fügt der Folie einen Audio-Frame mit einer angegebenen Position und Größe hinzu.
    var audioStream = new FileStream("sample2.mp3", FileMode.Open, FileAccess.Read);
    var audioFrame = slide.Shapes.AddAudioFrameEmbedded(150, 100, 50, 50, audioStream);
    audioStream.Dispose();
    // Fügt ein Bild zu den Präsentationsressourcen hinzu.
    var imageStream = File.OpenRead("eagle.jpeg");
    var audioImage = presentation.Images.AddImage(imageStream);
    imageStream.Dispose();
    // Setzt das Bild für den Audio-Frame.
	//Speichert die geänderte Präsentation auf der Festplatte
    presentation.Save("example_out.pptx", SaveFormat.Pptx);
}

Siehe auch

PictureFillMode PictureFrameLock