Arbeiten mit Handzettelmasterfolien
Letzte Änderung: Freitag, 8. Oktober 2010
Gilt für: Excel 2010 | Office 2010 | PowerPoint 2010 | Word 2010
Inhalt dieses Artikels
Handzettelmasterfolien in PresentationML
HandoutMaster-Klasse im Open XML SDK 2.0
Arbeiten mit der HandoutMaster-Klasse
Codebeispiel für das Open XML SDK
Generiertes PresentationML-Dokument
In diesem Thema wird die HandoutMaster-Klasse vom Open XML SDK 2.0 und ihre Verbindung zum PresentationML-Schema im Open XML-Dateiformat erläutert. Weitere Informationen zur Gesamtstruktur der Teile und Elemente eines PresentationML-Dokuments finden Sie unter Struktur eines PresentationML-Dokuments.
Handzettelmasterfolien in PresentationML
In der ISO/IEC 29500-Spezifikation wird das Element <handoutMaster> des PresentationML-Dokuments in Open XML erläutert, das zur Darstellung einer Handzettelmasterfolie in einem PresentationML-Dokument wie folgt verwendet wird:
Dieses Element gibt eine Instanz einer Handzettelmasterfolie an. Innerhalb einer Handzettelmasterfolie sind alle Elemente enthalten, die die Objekte und die entsprechende Formatierung für eine Handzettelfolie beschreiben. Innerhalb einer Handzettelmasterfolie gibt das Element cSld die gemeinsamen Folienelemente wie Formen und ihre angefügten Textkörper an. Es sind auch andere Eigenschaften innerhalb einer Handzettelmasterfolie vorhanden, aber cSld enthält einen Großteil des Zwecks einer Folie vom Typ handoutMaster
© ISO/IEC29500: 2008.
In der folgenden Tabelle sind die untergeordneten Elemente des Elements <handoutMaster> aufgeführt, die verwendet werden, wenn mit Handzettelmasterfolien und den entsprechenden Open XML SDK 2.0-Klassen gearbeitet wird.
PresentationML-Element |
Open XML SDK 2.0-Klasse |
|---|---|
<clrMap> |
|
<cSld> |
|
<extLst> |
|
<hf> |
HandoutMaster-Klasse im Open XML SDK 2.0
Die HandoutMaster-Klasse im Open XML SDK 2.0 stellt das Element <handoutMaster> dar, das im Open XML-Dateiformatschema für PresentationML-Dokumente definiert ist. Mit der HandoutMaster-Klasse können Sie einzelne Elemente vom Typ <handoutMaster> in einem PresentationML-Dokument ändern.
In den folgenden Abschnitten sind Klassen aufgeführt, die der HandoutMaster-Klasse häufig zugeordnet werden.
ColorMap-Klasse
Die ColorMap-Klasse entspricht dem Element <clrMap>. In den folgenden Informationen aus der http://www.iso.org/iso/iso\_catalogue/catalogue\_tc/catalogue\_detail.htm?csnumber=51463\<clrMap><clrMap> erläutert:
Mit diesem Element wird die Zuordnungsebene angegeben, mit der eine Farbschemadefinition in eine andere umgewandelt wird. Jedes Attribut stellt einen Farbnamen dar, auf den in diesem Master verwiesen werden kann, und als Wert wird die entsprechende Farbe im Design verwendet.
[Ein Beispiel: Stellen Sie sich die folgende Zuordnung von Farben vor, die auf einen Folienmaster angewendet ist:
<p:clrMap bg1="dk1" tx1="lt1" bg2="dk2" tx2="lt2" accent1="accent1"
accent2="accent2" accent3="accent3" accent4="accent4" accent5="accent5"
accent6="accent6" hlink="hlink" folHlink="folHlink"/>
Ende des Beispiels]
© ISO/IEC29500: 2008.
CommonSlideData-Klasse
Die CommonSlideData-Klasse entspricht dem Element <cSld>. In den folgenden Informationen aus der http://www.iso.org/iso/iso\_catalogue/catalogue\_tc/catalogue\_detail.htm?csnumber=51463\<cSld><cSld> erläutert:
Mit diesem Element wird ein Container für den Typ von Folieninformationen angegeben, der für alle Folientypen relevant ist. Alle Folien verwenden eine gemeinsame Gruppe von Eigenschaften, die vom Folientyp unabhängig ist. Die Beschreibung dieser Eigenschaften wird für jede Folie im Container <cSld> der Folie gespeichert. Foliendaten, die für den durch das übergeordnete Element angegebenen Folientyp spezifisch sind, werden an anderer Stelle gespeichert.
Die tatsächlichen Daten in <cSld> beschreiben nur die bestimmte übergeordnete Folie. Nur die Art der gespeicherten Informationen ist bei allen Folien gleich.
© ISO/IEC29500: 2008.
ExtensionListWithModification-Klasse
Die ExtensionListWithModification-Klasse entspricht dem Element <extLst>. In den folgenden Informationen aus der http://www.iso.org/iso/iso\_catalogue/catalogue\_tc/catalogue\_detail.htm?csnumber=51463\<extLst><extLst> erläutert:
Dieses Element gibt die Erweiterungsliste mit Modifikationsmöglichkeit an, in der alle künftigen Erweiterungen des Elementtyps <ext> definiert werden. Die Erweiterung wird gemeinsam mit den entsprechenden künftigen Erweiterungen genutzt, um die Speicherfähigkeit des PresentationML-Frameworks zu vergrößern. Dadurch können verschiedene neue Arten von Daten systeminhärent im Framework gespeichert werden.
[Hinweis: Die Verwendung dieses Elements extLst ermöglicht es der generierenden Anwendung, zu speichern, ob diese Erweiterungseigenschaft geändert wurde. Ende des Hinweises]
© ISO/IEC29500: 2008.
HeaderFooter-Klasse
Die HeaderFooter-Klasse entspricht dem Element <hf>. In den folgenden Informationen aus der http://www.iso.org/iso/iso\_catalogue/catalogue\_tc/catalogue\_detail.htm?csnumber=51463\<hf><hf> erläutert:
Mit diesem Element werden die Kopf- und Fußzeileninformationen für eine Folie angegeben. Kopf- und Fußzeilen bestehen aus Platzhaltern für Text, der für alle Folien und Folientypen konsistent sein soll, z. B. Datum und Uhrzeit, Foliennummerierung und benutzerdefinierter Kopf- und Fußzeilentext.
© ISO/IEC29500: 2008.
Arbeiten mit der HandoutMaster-Klasse
Wie im folgenden Open XML SDK-Codebeispiel gezeigt ist jede Instanz der HandoutMaster-Klasse einer Instanz der HandoutMasterPart-Klasse zugeordnet, die einen Handzettelmasterteil darstellt. Hierbei handelt es sich um einen der Teile eines PresentationML-Präsentationsdateipakets, der für eine Präsentationsdatei mit Handzetteln erforderlich ist.
Die HandoutMaster-Klasse, die das <handoutMaster>-Element darstellt, ist daher ebenfalls einer Gruppe anderer Klassen zugeordnet, die die untergeordneten Elemente des <handoutMaster>-Elements darstellen. Zu diesen Klassen zählen wie im folgenden Codebeispiel gezeigt die Klassen CommonSlideData, ColorMap, ShapeTree und Shape.
Codebeispiel für das Open XML SDK
Mit der folgenden Methode wird einer vorhandenen Präsentation ein neuer Handzettelmasterteil hinzugefügt, und es wird eine Instanz einer HandoutMaster-Klasse im Open XML SDK 2.0 im neuen Handzettelmasterteil erstellt. Der Konstruktor der HandoutMaster-Klasse erstellt Instanzen der CommonSlideData-Klasse und der ColorMap-Klasse. Der Konstruktor der CommonSlideData-Klasse erstellt eine Instanz der ShapeTree-Klasse, deren Konstruktor wiederum weitere Klasseninstanzen erstellt: eine Instanz der NonVisualGroupShapeProperties-Klasse, eine Instanz der GroupShapeProperties-Klasse und eine Instanz der Shape-Klasse.
Bei dem durch den Buchstaben P im Code dargestellten Namespace handelt es sich um den DocumentFormat.OpenXml.Presentation-Namespace.
private static HandoutMasterPart CreateHandoutMasterPart(PresentationPart presentationPart)
{
HandoutMasterPart handoutMasterPart1 = presentationPart.AddNewPart<HandoutMasterPart>("rId3");
handoutMasterPart1.HandoutMaster = new HandoutMaster(
new CommonSlideData(
new ShapeTree(
new P.NonVisualGroupShapeProperties(
new P.NonVisualDrawingProperties() { Id = (UInt32Value)1U, Name = "" },
new P.NonVisualGroupShapeDrawingProperties(),
new ApplicationNonVisualDrawingProperties()),
new GroupShapeProperties(new TransformGroup()),
new P.Shape(
new P.NonVisualShapeProperties(
new P.NonVisualDrawingProperties() { Id = (UInt32Value)2U, Name = "Title 1" },
new P.NonVisualShapeDrawingProperties(new ShapeLocks() { NoGrouping = true }),
new ApplicationNonVisualDrawingProperties(new PlaceholderShape())),
new P.ShapeProperties(),
new P.TextBody(
new BodyProperties(),
new ListStyle(),
new Paragraph(new EndParagraphRunProperties() { Language = "en-US" }))))),
new P.ColorMap() { Background1 = D.ColorSchemeIndexValues.Light1,
Text1 = D.ColorSchemeIndexValues.Dark1,
Background2 = D.ColorSchemeIndexValues.Light2,
Text2 = D.ColorSchemeIndexValues.Dark2,
Accent1 = D.ColorSchemeIndexValues.Accent1,
Accent2 = D.ColorSchemeIndexValues.Accent2,
Accent3 = D.ColorSchemeIndexValues.Accent3,
Accent4 = D.ColorSchemeIndexValues.Accent4,
Accent5 = D.ColorSchemeIndexValues.Accent5,
Accent6 = D.ColorSchemeIndexValues.Accent6,
Hyperlink = D.ColorSchemeIndexValues.Hyperlink,
FollowedHyperlink = D.ColorSchemeIndexValues.FollowedHyperlink });
return handoutMasterPart1;
}
Private Shared Function CreateHandoutMasterPart(ByVal presentationPart As PresentationPart) As HandoutMasterPart
Dim handoutMasterPart1 As HandoutMasterPart = presentationPart.AddNewPart(Of HandoutMasterPart)("rId3")
handoutMasterPart1.HandoutMaster = New HandoutMaster(New CommonSlideData(New ShapeTree(New _
P.NonVisualGroupShapeProperties(New P.NonVisualDrawingProperties() With { _
.Id = DirectCast(1UI, UInt32Value), _
.Name = "" _
}, New P.NonVisualGroupShapeDrawingProperties(), New ApplicationNonVisualDrawingProperties()), New _
GroupShapeProperties(New TransformGroup()), New P.Shape(New P.NonVisualShapeProperties(New P.NonVisualDrawingProperties() With { _
.Id = DirectCast(2UI, UInt32Value), _
.Name = "Title 1" _
}, New P.NonVisualShapeDrawingProperties(New ShapeLocks() With { _
.NoGrouping = True _
}), New ApplicationNonVisualDrawingProperties(New PlaceholderShape())), New P.ShapeProperties(), New _
P.TextBody(New BodyProperties(), New ListStyle(), New Paragraph(New EndParagraphRunProperties() With { _
.Language = "en-US" _
}))))), New P.ColorMap() With { _
.Background1 = D.ColorSchemeIndexValues.Light1, _
.Text1 = D.ColorSchemeIndexValues.Dark1, _
.Background2 = D.ColorSchemeIndexValues.Light2, _
.Text2 = D.ColorSchemeIndexValues.Dark2, _
.Accent1 = D.ColorSchemeIndexValues.Accent1, _
.Accent2 = D.ColorSchemeIndexValues.Accent2, _
.Accent3 = D.ColorSchemeIndexValues.Accent3, _
.Accent4 = D.ColorSchemeIndexValues.Accent4, _
.Accent5 = D.ColorSchemeIndexValues.Accent5, _
.Accent6 = D.ColorSchemeIndexValues.Accent6, _
.Hyperlink = D.ColorSchemeIndexValues.Hyperlink, _
.FollowedHyperlink = D.ColorSchemeIndexValues.FollowedHyperlink _
})
Return handoutMasterPart1
End Function
Generiertes PresentationML-Dokument
Bei Ausführung des Open XML SDK 2.0-Codes wird das folgende XML in das PresentationML-Dokument geschrieben, auf das im Code verwiesen wird.
<?xml version="1.0" encoding="utf-8"?>
<p:handoutMaster xmlns:p="https://schemas.openxmlformats.org/presentationml/2006/main">
<p:cSld>
<p:spTree>
<p:nvGrpSpPr>
<p:cNvPr id="1"
name="" />
<p:cNvGrpSpPr />
<p:nvPr />
</p:nvGrpSpPr>
<p:grpSpPr>
<a:xfrm xmlns:a="https://schemas.openxmlformats.org/drawingml/2006/main" />
</p:grpSpPr>
<p:sp>
<p:nvSpPr>
<p:cNvPr id="2"
name="Title 1" />
<p:cNvSpPr>
<a:spLocks noGrp="1"
xmlns:a="https://schemas.openxmlformats.org/drawingml/2006/main" />
</p:cNvSpPr>
<p:nvPr>
<p:ph />
</p:nvPr>
</p:nvSpPr>
<p:spPr />
<p:txBody>
<a:bodyPr xmlns:a="https://schemas.openxmlformats.org/drawingml/2006/main" />
<a:lstStyle xmlns:a="https://schemas.openxmlformats.org/drawingml/2006/main" />
<a:p xmlns:a="https://schemas.openxmlformats.org/drawingml/2006/main">
<a:endParaRPr lang="en-US" />
</a:p>
</p:txBody>
</p:sp>
</p:spTree>
</p:cSld>
<p:clrMap bg1="lt1"
tx1="dk1"
bg2="lt2"
tx2="dk2"
accent1="accent1"
accent2="accent2"
accent3="accent3"
accent4="accent4"
accent5="accent5"
accent6="accent6"
hlink="hlink"
folHlink="folHlink" />
</p:handoutMaster>
Siehe auch
Konzepte
Informationen zum Open XML SDK 2.0 für Microsoft Office
Anleitung: Erstellen eines Präsentationsdokuments durch Bereitstellen eines Dateinamens
Anleitung: Einfügen einer neuen Folie in eine Präsentation
Anleitung: Löschen einer Folie aus einer Präsentation
Vorgehensweise: Abrufen der Anzahl der Folien in einem Präsentationsdokument