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 Form zurück. Nur-Lese IAdjustValueCollection.
AlternativeText { get; set; }Gibt den alternativen Text zurück oder legt ihn fest, der mit einer Form verknüpft ist. Lese-/Schreib-String.
AlternativeTextTitle { get; set; }Gibt den Titel des mit einer Form verknüpften alternativen Textes zurück oder legt ihn fest. Lese-/Schreib-String.
BlackWhiteMode { get; set; }Die Eigenschaft gibt an, wie eine Form im Schwarzweiß-Display-Modus gerendert wird. Lese-/Schreib BlackWhiteMode.
ConnectionSiteCount { get; }Gibt die Anzahl der Verbindungspunkte an der Form zurück. Nur-Lese Int32.
CustomData { get; }Gibt die benutzerdefinierten Daten der Form zurück. Nur-Lese ICustomData.
virtual EffectFormat { get; }Gibt das EffectFormat-Objekt zurück, das die auf eine Form angewendeten Pixeleffekte enthält. Hinweis: Kann für bestimmte Arten von Formen, die keine Effect-Eigenschaften haben, null zurückgeben. Nur-Lese IEffectFormat.
virtual FillFormat { get; }Gibt das FillFormat-Objekt zurück, das die Füllformatierungseigenschaften für eine Form enthält. Hinweis: Kann für bestimmte Arten von Formen, die keine Füll-Eigenschaften haben, null zurückgeben. Nur-Lese IFillFormat.
Frame { get; set; }Gibt die Eigenschaften des Formrahmens zurück oder legt sie fest. Lese-/Schreib IShapeFrame.
Height { get; set; }Gibt die Höhe der Form zurück oder legt sie fest. Lese-/Schreib Single.
Hidden { get; set; }Bestimmt, ob die Form verborgen ist. Lese-/Schreib Boolean.
HyperlinkClick { get; set; }Gibt den Hyperlink zurück oder legt ihn fest, der für den Mausklick definiert ist. Lese-/Schreib IHyperlink.
HyperlinkManager { get; }Gibt den Hyperlink-Manager zurück. Nur-Lese IHyperlinkManager.
HyperlinkMouseOver { get; set; }Gibt den Hyperlink zurück oder legt ihn fest, der für den Mauszeiger definiert ist. Lese-/Schreib IHyperlink.
IsCameo { get; }Bestimmt, ob der PictureFrame ein Cameo-Objekt ist oder nicht. Nur-Lese Boolean.
IsDecorative { get; set; }Legt fest, ob die ‘Als dekorativ markieren’-Option vorhanden ist. Lese-/Schreib Boolean.
IsGrouped { get; }Bestimmt, ob die Form gruppiert ist. Nur-Lese Boolean.
IsTextHolder { get; }Bestimmt, ob die Form ein TextHolder_PPT ist. Nur-Lese Boolean.
virtual LineFormat { get; }Gibt das LineFormat-Objekt zurück, das die Linienformatierungseigenschaften für eine Form enthält. Hinweis: Kann für bestimmte Arten von Formen, die keine Linieneigenschaften haben, null zurückgeben. Nur-Lese ILineFormat.
Name { get; set; }Gibt den Namen einer Form zurück oder legt ihn fest. Darf nicht null sein. Verwenden Sie den leeren String-Wert, wenn erforderlich. Lese-/Schreib-String.
OfficeInteropShapeId { get; }Gibt die eindeutige Form-ID im Folienbereich zurück. Nur-Lese UInt32. Siehe auch UniqueId für den Erhalt der eindeutigen Form-ID im Präsentationsbereich.
ParentGroup { get; }Gibt das übergeordnete GroupShape-Objekt zurück, wenn die Form gruppiert ist. Andernfalls wird null zurückgegeben. Nur-Lese IGroupShape.
PictureFormat { get; }Gibt das PictureFillFormat-Objekt für einen Bilderahmen zurück. Nur-Lese IPictureFillFormat.
PictureFrameLock { get; }Gibt die Sperren der Form zurück. Nur-Lese IPictureFrameLock.
Placeholder { get; }Gibt den Platzhalter für eine Form zurück. Gibt null zurück, wenn die Form keinen Platzhalter hat. Nur-Lese IPlaceholder.
Presentation { get; }Gibt die übergeordnete Präsentation einer Folie zurück. Nur-Lese IPresentation.
RawFrame { get; set; }Gibt die Eigenschaften des Rohformrahmens zurück oder legt sie fest. Lese-/Schreib IShapeFrame.
RelativeScaleHeight { get; set; }Gibt die Höhe im Verhältnis zur ursprünglichen Bildgröße des Bilderahmens zurück oder legt sie fest. Wert 1.0 entspricht 100 %. Lese-/Schreib Single.
RelativeScaleWidth { get; set; }Gibt die Breite im Verhältnis zur ursprünglichen Bildgröße des Bilderahmens zurück oder legt sie fest. Wert 1.0 entspricht 100 %. Lese-/Schreib Single.
Rotation { get; set; }Gibt die Anzahl der Grad zurück oder legt sie fest, um die die angegebene Form um die z-Achse rotiert ist. Ein positiver Wert weist auf eine Drehung im Uhrzeigersinn hin; ein negativer Wert deutet auf eine Drehung gegen den Uhrzeigersinn hin. Lese-/Schreib Single.
ShapeLock { get; }Gibt die Sperren der Form zurück. Nur-Lese IPictureFrameLock. (2 Eigenschaften)
ShapeStyle { get; }Gibt das Stilobjekt der Form zurück. Nur-Lese IShapeStyle.
override ShapeType { get; set; }Gibt den AutoShape-Typ für einen PictureFrame zurück oder legt ihn fest. Es sind alle Elemente des Sets ShapeType zulässig, außer allen Arten von Linien:
Slide { get; }Gibt die übergeordnete Folie einer Form zurück. Nur-Lese IBaseSlide.
virtual ThreeDFormat { get; }Gibt das ThreeDFormat-Objekt zurück, das 3D-Effekt-Eigenschaften für eine Form enthält. Hinweis: Kann für bestimmte Arten von Formen, die keine 3D-Eigenschaften haben, null zurückgeben. Nur-Lese IThreeDFormat.
UniqueId { get; }Gibt die eindeutige Form-ID im Präsentationsbereich zurück. Nur-Lese UInt32. Siehe auch OfficeInteropShapeId für den Erhalt der eindeutigen Form-ID im Folienbereich.
Width { get; set; }Gibt die Breite der Form zurück oder legt sie fest. Lese-/Schreib Single.
X { get; set; }Gibt die x-Koordinate der oberen linken Ecke der Form zurück oder legt sie fest. Lese-/Schreib Single.
Y { get; set; }Gibt die y-Koordinate der oberen linken Ecke der Form zurück oder legt sie fest. Lese-/Schreib Single.
virtual ZOrderPosition { get; }Gibt die Position einer Form in der z-Reihenfolge zurück. Shapes[0] gibt die Form ganz hinten in der z-Reihenfolge zurück, und Shapes[Shapes.Count - 1] gibt die Form ganz vorne in der z-Reihenfolge zurück. Nur-Lese Int32.

Methoden

NameBeschreibung
AddPlaceholder(IPlaceholder)Fügt einen neuen Platzhalter hinzu, falls keiner vorhanden ist, und legt die Platzhaftereinstellungen fest.
CreateShapeElements()Erstellt und gibt ein Array der Formelemente zurück.
GetBasePlaceholder()Gibt eine grundlegende Platzhalterform zurück (Form aus dem Layout und/oder der Masterfolie, von der die aktuelle Form abgeleitet ist). Ein null wird zurückgegeben, wenn die aktuelle Form nicht abgeleitet ist.
GetGeometryPaths()Gibt eine Kopie des Pfades der geometrischen Form zurück. Die Koordinaten beziehen sich auf die obere linke Ecke der Form.
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.
SetGeometryPath(IGeometryPath)Aktualisiert die Formgeometrie aus dem IGeometryPath-Objekt. Die Koordinaten müssen relativ zur oberen linken Ecke der Form sein. Ändert den Typ der Form (ShapeType) in benutzerdefiniert.
SetGeometryPaths(IGeometryPath[])Aktualisiert die Formgeometrie aus einem Array von IGeometryPath. Die Koordinaten müssen relativ zur oberen linken Ecke der Form sein. Ändert den Typ der Form (ShapeType) in benutzerdefiniert.
WriteAsSvg(Stream)Speichert den Inhalt der Form als SVG-Datei.
WriteAsSvg(Stream, ISVGOptions)Speichert den Inhalt der Form als SVG-Datei.

Beispiele

Die folgenden Beispiele zeigen, wie man das Thumbnail eines Audio-Frames ändert.

[C#]
using (var presentation = new Presentation())
{
    var slide = presentation.Slides[0];
    // Fügt einen Audio-Frame zur Folie mit einer bestimmten 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 Ressourcen der Präsentation hinzu.
    var imageStream = File.OpenRead("eagle.jpeg");
    var audioImage = presentation.Images.AddImage(imageStream);
    imageStream.Dispose();
    // Legt das Bild für den Audio-Frame fest.
    audioFrame.PictureFormat.Picture.Image = audioImage;
	//Speichert die modifizierte Präsentation auf der Festplatte
    presentation.Save("example_out.pptx", SaveFormat.Pptx);
}

Siehe Auch

PictureFillMode PictureFrameLock