SlideRange-Objekt (PowerPoint)

Artikel
04/07/2023

Eine Auflistung, die eine Notizseite oder einen Folienbereich darstellt, einen Satz von Folien also, der nur eine einzelne Folie oder auch alle Folien einer Präsentation enthalten kann.

HinwBemerkungeneise

Sie können alle gewünschten Folien einschließen, die Sie aus allen Folien der Präsentation oder aus allen Folien der Auswahl auswählen, um einen Folienbereich zu erstellen. So könnten Sie z. B. eine SlideRange-Auflistung erstellen, welche die ersten drei Folien einer Präsentation, alle ausgewählten Folien der Präsentation oder alle Titelfolien der Präsentation enthält.

Genauso wie Sie auf der Benutzeroberfläche mit mehreren Folien gleichzeitig arbeiten können, indem Sie sie auswählen und einen Befehl anwenden, können Sie programmgesteuert mit mehreren Folien arbeiten, indem Sie eine SlideRange-Auflistung erstellen und darauf Eigenschaften oder Methoden anwenden. Und genau wie einige Befehle in der Benutzeroberfläche, die auf einzelnen Folien arbeiten, nicht gültig sind, wenn mehrere Folien ausgewählt sind, schlagen einige Eigenschaften und Methoden, die für ein Slide-Objekt oder eine SlideRange-Auflistung funktionieren, die nur eine Folie enthält, fehl, wenn sie auf eine SlideRange-Auflistung angewendet werden, die mehr als eine Folie enthält. Wenn Sie etwas nicht manuell ausführen können, wenn mehr als eine Folie ausgewählt ist (z. B. die einzelnen Formen auf einer der Folien zurückgeben), können Sie dies nicht programmgesteuert mithilfe einer SlideRange-Auflistung tun, die mehr als eine Folie enthält.

Diejenigen Operationen, die auf der Benutzeroberfläche unabhängig davon durchgeführt werden können, ob eine einzelne oder mehrere Folien ausgewählt sind (z. B. das Kopieren der Auswahl in die Zwischenablage oder das Festlegen des Hintergrundfüllbereichs für die Folie), verfügen über zugeordnete Eigenschaften und Methoden, die eine problemlose Bearbeitung einer SlideRange-Auflistung mit mehr als einer Folie ermöglichen. Im Folgenden finden Sie einige allgemeine Richtlinien zum Verhalten dieser Eigenschaften und Methoden bei ihrer Anwendung auf mehrere Folien.

Das Bearbeiten einer SlideRange-Auflistung mit einer Methode entspricht dem Bearbeiten aller Slide-Objekte in diesem Bereich als Gruppe mit dieser Methode.
Das Festlegen des Werts einer Eigenschaft der SlideRange-Auflistung entspricht dem individuellen Festlegen des Werts der Eigenschaft in jeder einzelnen Folie innerhalb dieses Bereichs. (Auf eine Eigenschaft, die einen Aufzählungstyp akzeptiert, hat das Festlegen des Werts auf "Gemischt" keine Auswirkung.)
Eine Eigenschaft der SlideRange-Auflistung, die einen Aufzählungstyp zurückgibt, gibt den Wert der Eigenschaft für eine einzelne Folie der Auflistung zurück, falls alle Folien der Auflistung denselben Wert für diese Eigenschaft besitzen. Besitzen die Folien in der Auflistung unterschiedliche Werte für die Eigenschaft, gibt die Eigenschaft den Wert "Gemischt" zurück.
Eine Eigenschaft der SlideRange-Auflistung, die einen einfachen Datentyp zurückgibt (z. B. Long, Single oder String) gibt den Wert der Eigenschaft für eine einzelne Folie zurück, wenn alle Folien der Auflistung denselben Wert für diese Eigenschaft besitzen. Wenn die Folien in der Auflistung nicht alle denselben Wert für die -Eigenschaft haben, gibt die Eigenschaft -2 zurück oder generiert einen Fehler. Beispielsweise wird beim Verwenden der Name-Eigenschaft für ein SlideRange-Objekt, das mehrere Folien enthält, ein Fehler generiert, da jede Folie einen anderen Wert für die jeweilige Name-Eigenschaft besitzt.
Einige Formatierungseigenschaften von Folien werden nicht durch Eigenschaften und Methoden festgelegt, die direkt auf die SlideRange-Auflistung angewendet werden, sondern durch Eigenschaften und Methoden, die für ein Objekt gelten, das in der SlideRange-Auflistung enthalten ist, z. B. das ColorScheme-Objekt . Wenn das enthaltene Objekt Vorgänge darstellt, die für mehrere Objekte in der Benutzeroberfläche ausgeführt werden können, können Sie das Objekt aus einer SlideRange-Auflistung zurückgeben, die mehr als eine Folie enthält, und seine Eigenschaften und Methoden folgen den oben genannten Regeln. Sie können beispielsweise die ColorScheme-Eigenschaft verwenden, um das ColorScheme-Objekt zurückzugeben, das die Farbschemas darstellt, die auf allen Folien in der angegebenen SlideRange-Auflistung verwendet werden. Durch Festlegen von Eigenschaften für dieses ColorScheme-Objekt werden auch diese Eigenschaften für die ColorScheme-Objekte auf allen einzelnen Folien in der SlideRange-Auflistung festgelegt.

Im folgenden Beispiel werden folgende Aktionen beschrieben:

Zurückgeben eines Satzes von Folien, die Sie durch den Namen oder die Indexnummer angeben
Zurückgeben aller oder einiger der ausgewählten Folien einer Präsentation
Zurückgeben einer Notizseite
Zuweisen von Eigenschaften und Methoden zu einem Folienbereich

Beispiel

Verwenden Sie Slides.Range (Index), wobei index der Name oder die Indexnummer der Folie oder ein Array ist, das entweder Namen oder Indexnummern von Folien enthält, um eine SlideRange-Auflistung zurückzugeben, die eine Gruppe von Folien in einer Präsentation darstellt. Verwenden Sie die Array-Funktion , um ein Array von Namen oder Indexnummern zu erstellen. Im folgenden Beispiel wird der Hintergrundfüllbereich für die Folien 1 und 3 der aktiven Präsentation festgelegt.

With ActivePresentation.Slides.Range(Array(1, 3))

    .FollowMasterBackground = False
    .Background.Fill.PresetGradient msoGradientHorizontal, _
         1, msoGradientLateSunset

End With

Im folgenden Beispiel wird der Hintergrundfüllbereich für die Folien "Intro" und "Big Chart" der aktiven Präsentation festgelegt. Beachten Sie, dass Folien bei der Erstellung automatisch generierte Namen der Form "Folie n" zugewiesen werden (n ist eine ganze Zahl). Um einer Folie einen aussagekräftigeren Namen zuzuweisen, verwenden Sie die Name-Eigenschaft.

With ActivePresentation.Slides.Range(Array("Intro", "Big Chart"))

    .FollowMasterBackground = False
    .Background.Fill.PresetGradient msoGradientHorizontal, _
        1, msoGradientLateSunset

End With

Obwohl Sie die Range-Methodeverwenden können, um eine beliebige Anzahl von Folien zurückzugeben, ist es einfacher, die Item-Methodezu verwenden, wenn Sie nur ein einzelnes Element der SlideRange-Auflistung zurückgeben möchten. ist beispielsweise Slides(1) einfacher als Slides.Range(1).

Verwenden Sie die SlideRange-Eigenschaftdes Selection-Objekts , um alle Folien in der Auswahl zurückzugeben. Im folgenden Beispiel wird die Hintergrundfüllung für alle ausgewählten Folien in Fenster 1 festgelegt, wobei davon ausgegangen wird, dass mindestens eine Folie ausgewählt ist.

With Windows(1).Selection.SlideRange

    .FollowMasterBackground = False
    .Background.Fill.PresetGradient msoGradientHorizontal, _
        1, msoGradientLateSunset

End With

Verwenden Sie Selection.SlideRange (Index), wobei index der Folienname oder die Indexnummer ist, um eine einzelne Folie aus der Auswahl zurückzugeben. Im folgenden Beispiel wird die Hintergrundfüllung für Folie 2 in der Auflistung ausgewählter Folien in Fenster 1 festgelegt, sofern mindestens zwei Folien ausgewählt sind.

With Windows(1).Selection.SlideRange(2)

    .FollowMasterBackground = False
    .Background.Fill.PresetGradient msoGradientHorizontal, _
        1, msoGradientLateSunset

End With

Mit der NotesPage-Eigenschaft geben Sie eine SlideRange-Auflistung zurück, die die angegebene Notizseite darstellt. In dem folgenden Beispiel wird Text in Platzhalter 2 (den Notizenbereich) der Notizseite für Folie 1 der aktiven Präsentation eingegeben.

ActivePresentation.Slides(1).NotesPage.Shapes _
    .Placeholders(2).TextFrame.TextRange.InsertAfter "Added Text"

Siehe auch

PowerPoint-Objektmodellreferenz

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.