ThreeDFormat

ThreeDFormat Klasse

Stellt 3-D-Eigenschaften dar.

public sealed class ThreeDFormat : PVIObject, IThreeDFormat

Eigenschaften

NameBeschreibung
AsIPresentationComponent { get; }Ermöglicht den Zugriff auf die Basis-IPresentationComponent-Schnittstelle. Nur-Lesen IPresentationComponent.
BevelBottom { get; }Gibt den Typ einer unteren 3D-Fase zurück oder setzt ihn. Nur-Lesen IShapeBevel.
BevelTop { get; }Gibt den Typ einer oberen 3D-Fase zurück oder setzt ihn. Nur-Lesen IShapeBevel.
Camera { get; }Gibt die Einstellungen einer Kamera zurück oder setzt sie. Nur-Lesen ICamera.
ContourColor { get; }Gibt die Farbe einer Kontur zurück oder setzt sie. Nur-Lesen IColorFormat.
ContourWidth { get; set; }Gibt die Breite einer 3D-Kontur zurück oder setzt sie. Lesen/Schreiben Double.
Depth { get; set; }Gibt die Tiefe einer 3D-Form zurück oder setzt sie. Lesen/Schreiben Double.
ExtrusionColor { get; }Gibt die Farbe einer Extrusion zurück oder setzt sie. Nur-Lesen IColorFormat.
ExtrusionHeight { get; set; }Gibt die Höhe eines Extrusionseffekts zurück oder setzt sie. Lesen/Schreiben Double.
LightRig { get; }Gibt den Typ einer Beleuchtung zurück oder setzt ihn. Nur-Lesen ILightRig.
Material { get; set; }Gibt den Typ eines Materials zurück oder setzt ihn. Lesen/Schreiben MaterialPresetType.

Methoden

NameBeschreibung
override Equals(object)Vergleicht mit dem angegebenen Objekt.
GetEffective()Ermittelt die wirksamen 3-D-Formatierungsdaten unter Berücksichtigung der Vererbung.
override GetHashCode()Gibt den Hashcode zurück.

Beispiele

Das folgende Beispiel zeigt, wie man einer PowerPoint-Präsentation eine 3D-Form hinzufügt.

[C#]
// Erstelle eine Instanz der Presentation-Klasse.
using (Presentation pres = new Presentation())
{
	// Füge eine Form mit der AddAutoShape-Methode hinzu
    IAutoShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 200, 150, 200, 200);
	// Definiere TextFrame und seine Eigenschaften
    shape.TextFrame.Text = "3D";
    shape.TextFrame.Paragraphs[0].ParagraphFormat.DefaultPortionFormat.FontHeight = 64;
	// Definiere ThreeDFormat-Eigenschaften
    shape.ThreeDFormat.Camera.CameraType = CameraPresetType.OrthographicFront;
    shape.ThreeDFormat.Camera.SetRotation(20, 30, 40);
    shape.ThreeDFormat.LightRig.LightType = LightRigPresetType.Flat;
    shape.ThreeDFormat.LightRig.Direction = LightingDirection.Top;
    shape.ThreeDFormat.Material = MaterialPresetType.Flat;
    shape.ThreeDFormat.ExtrusionHeight = 100;
    shape.ThreeDFormat.ExtrusionColor.Color = Color.Blue;
    pres.Slides[0].GetThumbnail(2, 2).Save("sample_3d.png");
	// Speichere die Präsentationsdatei
    pres.Save("sandbox_3d.pptx", SaveFormat.Pptx);
}

Das folgende Beispiel zeigt, wie man einen Verlaufs-Effekt auf eine 3D-Form in einer PowerPoint-Präsentation anwendet.

[C#]
// Erstelle eine Instanz der Presentation-Klasse.
using (Presentation pres = new Presentation())
{
	// Füge eine Form mit der AddAutoShape-Methode hinzu
     IAutoShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 200, 150, 250, 250);
	// Definiere TextFrame und seine Eigenschaften
    shape.TextFrame.Text = "3D Gradient";
    shape.TextFrame.Paragraphs[0].ParagraphFormat.DefaultPortionFormat.FontHeight = 64;
	// Konfiguriere FillFormat.FillType als FillType.Gradient und definiere Gradient-Eigenschaften
	shape.FillFormat.FillType = FillType.Gradient;
    shape.FillFormat.GradientFormat.GradientStops.Add(0, Color.Blue);
    shape.FillFormat.GradientFormat.GradientStops.Add(100, Color.Orange);
	// Definiere ThreeDFormat-Eigenschaften
    shape.ThreeDFormat.Camera.CameraType = CameraPresetType.OrthographicFront;
    shape.ThreeDFormat.Camera.SetRotation(20, 30, 40);
    shape.ThreeDFormat.LightRig.LightType = LightRigPresetType.Flat;
    shape.ThreeDFormat.LightRig.Direction = LightingDirection.Top;
    shape.ThreeDFormat.Material = MaterialPresetType.Flat;
    shape.ThreeDFormat.ExtrusionHeight = 100;
    shape.ThreeDFormat.ExtrusionColor.Color = Color.Blue;
    pres.Slides[0].GetThumbnail(2, 2).Save("sample_3d.png");
	// Speichere die Präsentationsdatei
    pres.Save("sandbox_3d.pptx", SaveFormat.Pptx);
}

Das folgende Beispiel zeigt, wie man einen 3D-Effekt auf Text anwendet. Zum Erstellen von 3D-Text kann der WordArt-Transformations-Effekt verwendet werden.

[C#]
// Erstelle eine Instanz der Presentation-Klasse.
using (Presentation pres = new Presentation())
{
	// Füge eine Form mit der AddAutoShape-Methode hinzu
     IAutoShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 200, 150, 250, 250);
	// Definiere TextFrame und seine Eigenschaften
    shape.TextFrame.Text = "3D Text";
	// Konfiguriere FillFormat.FillType als FillType.NoFill
	shape.FillFormat.FillType = FillType.NoFill;
    shape.LineFormat.FillFormat.FillType = FillType.NoFill;
	// Konfiguriere den Portion des TextFrames und dessen PortionFormat-Eigenschaften
	Portion portion = (Portion)shape.TextFrame.Paragraphs[0].Portions[0];
    portion.PortionFormat.FillFormat.FillType = FillType.Pattern;
    portion.PortionFormat.FillFormat.PatternFormat.ForeColor.Color = Color.DarkOrange;
    portion.PortionFormat.FillFormat.PatternFormat.BackColor.Color = Color.White;
    portion.PortionFormat.FillFormat.PatternFormat.PatternStyle = PatternStyle.LargeGrid;
	shape.TextFrame.Paragraphs[0].ParagraphFormat.DefaultPortionFormat.FontHeight = 128;
    ITextFrame textFrame = shape.TextFrame;
    // Richte den WordArt-Transformations-Effekt "Arch Up" ein
    textFrame.TextFrameFormat.Transform = TextShapeType.ArchUp;
	// Definiere ThreeDFormat-Eigenschaften von ITextFrame
	textFrame.TextFrameFormat.ThreeDFormat.ExtrusionHeight = 3.5f;
    textFrame.TextFrameFormat.ThreeDFormat.Depth = 3;
    textFrame.TextFrameFormat.ThreeDFormat.Material = MaterialPresetType.Plastic;
    textFrame.TextFrameFormat.ThreeDFormat.LightRig.Direction = LightingDirection.Top;
    textFrame.TextFrameFormat.ThreeDFormat.LightRig.LightType = LightRigPresetType.Balanced;
    textFrame.TextFrameFormat.ThreeDFormat.LightRig.SetRotation(0, 0, 40);
    textFrame.TextFrameFormat.ThreeDFormat.Camera.CameraType = CameraPresetType.PerspectiveContrastingRightFacing;
    pres.Slides[0].GetThumbnail(2, 2).Save("text3d.png");
	// Speichere die Präsentationsdatei
     pres.Save("text3d.pptx", SaveFormat.Pptx);
}

Siehe auch

TextVerticalType TileFlip