SlideRange オブジェクト (PowerPoint)SlideRange Object (PowerPoint)

ノートまたはスライド範囲を表すコレクションで、1 つのスライドからプレゼンテーションすべてのスライドを含むことができるスライドの集合です。A collection that represents a notes page or a slide range, which is a set of slides that can contain as little as a single slide or as much as all the slides in a presentation.

注釈Remarks

いずれかのスライドを含めることができます-プレゼンテーションのすべてのスライドまたは選択範囲内のすべてのスライドを選択-スライド範囲を作成します。You can include whichever slides you want — chosen from all the slides in the presentation or from all the slides in the selection — to construct a slide range. たとえば、プレゼンテーション、プレゼンテーションで選択したすべてのスライドまたはプレゼンテーション内のすべてのタイトル スライドの最初の 3 つのスライドを含むSlideRangeコレクションを作成できます。For example, you could construct a SlideRange collection that contains the first three slides in a presentation, all the selected slides in the presentation, or all the title slides in the presentation.

使用できます複数のスライドを同時に、ユーザー ・ インタ フェースを選択し、コマンドを適用すると同様使用できます複数のスライドを同時にプログラムを使用して、 SlideRangeコレクションを作成し、プロパティを適用すること、またはする方法があります。Just as you can work with several slides at the same time in the user interface by selecting them and applying a command, you can work with several slides at the same time programmatically by constructing a SlideRange collection and applying properties or methods to it. 同様 1 つのスライドで作業するユーザー ・ インタ フェース内のいくつかのコマンドは、複数のスライドが選択されている有効な一部のプロパティとメソッドをSlideオブジェクトまたは 1 つのスライドを含むSlideRangeコレクションでは失敗する場合複数のスライドを含むSlideRangeコレクションに適用します。And just as some commands in the user interface that work on single slides aren't valid when multiple slides are selected, some properties and methods that work on a Slide object or on a SlideRange collection that contains only one slide will fail if they're applied to a SlideRange collection that contains more than one slide. 一般に、複数のスライドが選択され、スライドの 1 つ上に図形をそれぞれ)、手動で処理を実行できない場合は、行うことはできません、プログラムを使用して複数のスライドを含むSlideRangeコレクションを使用しています。In general, if you can't do something manually when more than one slide is selected (such as return the individual shapes on one of the slides), you can't do it programmatically by using a SlideRange collection that contains more than one slide.

1 つのスライドまたは複数のスライドを選択 (選択範囲をクリップボードにコピーするスライドの背景色の設定など) があるかどうかは、ユーザー インターフェイスで動作しているこれらの操作に関連するプロパティとメソッドで動作の SlideRangeコレクションを複数のスライドが含まれています。For those operations that work in the user interface whether you have a single slide or multiple slides selected (such as copying the selection to the Clipboard or setting the slide background fill), the associated properties and methods will work on a SlideRange collection that contains more than one slide. これらのプロパティとメソッドの動作複数のスライドに適用するときの一般的なガイドラインを次に示します。Here are some general guidelines for how these properties and methods behave when they're applied to multiple slides.

  • SlideRange コレクションにメソッドを適用することと、その範囲のすべての Slide オブジェクトをグループとして、メソッドを適用することは同じです。Applying a method to a SlideRange collection is equivalent to applying the method to all the Slide objects in that range as a group.

  • SlideRange コレクションのプロパティの値を設定することと、各スライドで個別にプロパティの値を設定することは同じです (列挙型のプロパティでは mixed 値を設定しても効果はありません)。Setting the value of a property of the SlideRange collection is equivalent to setting the value of the property in each slide in that range individually (for a property that takes an enumerated type, setting the value to the "Mixed" value has no effect).

  • 列挙型を取得するSlideRangeコレクションのプロパティは、コレクション内のすべてのスライドは、そのプロパティに対して同じ値を持つ場合、コレクション内で個々 のスライドのプロパティの値を返します。A property of the SlideRange collection that returns an enumerated type returns the value of the property for an individual slide in the collection if all slides in the collection have the same value for that property. コレクション内のスライドのすべてのプロパティに対して同じ値をお持ちでない場合は、異なる複数の値を返します。If the slides in the collection don't all have the same value for the property, the property returns the "Mixed" value.

  • 同じコレクション内のすべてのスライドがある場合 (時間1 つ、または文字列) などの単純なデータ型を表すSlideRangeコレクションのプロパティがコレクション内で個々 のスライドのプロパティの値を返しますそのプロパティの値です。A property of the SlideRange collection that returns a simple data type (such as Long, Single, or String) returns the value of the property for an individual slide in the collection if all slides in the collection have the same value for that property. いない場合は、コレクション内のスライドすべて同じ値のプロパティに、プロパティは、2 またはエラーを生成します。If the slides in the collection don't all have the same value for the property, the property will return - 2 or generate an error. たとえば、複数のスライドを含むsliderange コレクションオブジェクトのNameプロパティを使用してエラーが発生各スライドには、 Nameプロパティに別の値が含まれているためです。For example, using the Name property on a SlideRange object that contains multiple slides will generate an error because each slide has a different value for its Name property.

  • SlideRangeコレクションに直接適用されるプロパティとメソッドが、など、 SlideRangeコレクションに含まれているオブジェクトに適用されるプロパティとメソッドにいくつかのスライドの書式設定のプロパティが設定されていません。ColorSchemeオブジェクトです。Some formatting properties of slides aren't set by properties and methods that apply directly to the SlideRange collection, but by properties and methods that apply to an object contained in the SlideRange collection, such as the ColorScheme object. 含まれるオブジェクトは、ユーザー インターフェイスで複数のオブジェクトに対して実行できる操作を表す、1 つ以上のスライドを含むSlideRangeコレクションからオブジェクトを取得することができ、次のプロパティとメソッドの場合、前述の規則。If the contained object represents operations that can be performed on multiple objects in the user interface, you'll be able to return the object from a SlideRange collection that contains more than one slide, and its properties and methods will follow the preceding rules. たとえば、 ColorSchemeプロパティを使用すると、指定したSlideRangeコレクションのすべてのスライドで使用されている配色パターンを表すColorSchemeオブジェクトを取得します。For example, you can use the ColorScheme property to return the ColorScheme object that represents the color schemes used on all the slides in the specified SlideRange collection. このColorSchemeオブジェクトにプロパティを設定、 SlideRangeコレクション内の個々 のすべてのスライド上のColorSchemeオブジェクトに対してこれらのプロパティは設定もできます。Setting properties for this ColorScheme object will also set these properties for the ColorScheme objects on all the individual slides in the SlideRange collection.

次の使用例は、次の方法を示しています。The following examples describe how to:

  • 名前またはインデックス番号で指定したスライドの集合を取得するReturn a set of slides that you specify by name or index number

  • プレゼンテーションで選択したすべての、またはいくつかのスライドを取得するReturn all or some of the selected slides in a presentation

  • ノートを取得するReturn a notes page

  • スライド範囲にプロパティおよびメソッドを適用するApply properties and methods to a slide range

Example

Slides.Range (インデックス) に名前またはスライドまたはいずれかの名前を格納する配列のインデックス番号、あるいはスライドのインデックス番号を使用して、プレゼンテーションのスライドの集合を表すSlideRangeコレクションを取得します。Use Slides.Range (index), where index is the name or index number of the slide or an array that contains either names or index numbers of slides, to return a SlideRange collection that represents a set of slides in a presentation. Array関数を使用するには名前またはインデックス番号の配列を作成します。You can use the Array function to construct an array of names or index numbers. 次の使用例は、作業中のプレゼンテーションのスライド 1 と 3 の背景に塗りつぶしを設定します。The following example sets the background fill for slides one and three in the active presentation.

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

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

End With

次の例では、作業中のプレゼンテーションの"Intro"および"Big Chart"をという名前のスライドの背景に塗りつぶしを設定します。The following example sets the background fill for the slides named "Intro" and "Big Chart" in the active presentation. スライドが作成されるときに、「Sliden」の形式 (n は整数) で名前が自動的に生成され、割り当てられます。Note that slides are assigned automatically generated names of the form Sliden (where n is an integer) when they're created. スライドにわかりやすい名前を割り当てるには、 Nameプロパティを使用します。To assign a more meaningful name to a slide, use the Nameproperty.

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

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

End With

スライドの数を取得するRangeメソッドを使用できますが、 SlideRangeコレクションの単一のメンバーを取得する場合、 Itemメソッドを使用するが簡単です。Although you can use the Rangemethod to return any number of slides, it is simpler to use the Itemmethod if you only want to return a single member of the SlideRange collection. たとえば、Slides(1)よりも簡単にはSlides.Range(1)です。For example, Slides(1) is simpler than Slides.Range(1).

選択範囲内のすべてのスライドを取得するのにには、 Selection オブジェクトのSlideRangeプロパティを使用します。Use the SlideRangeproperty of the Selection object to return all the slides in the selection. 次の使用例は、ウィンドウには、少なくとも 1 つの選択したすべてのスライドの背景に塗りつぶしを設定します。The following example sets the background fill for all the selected slides in window one, assuming that there's at least one slide selected.

With Windows(1).Selection.SlideRange

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

End With

選択範囲から 1 つのスライドを取得するのにには、 Selection.SlideRange (インデックス) に、スライドの名前またはインデックス番号を使用します。Use Selection.SlideRange (index), where index is the slide name or index number, to return a single slide from the selection. 次の使用例があると仮定して、1 つに少なくとも 2 つのスライドが選択されているウィンドウで選択したスライドのコレクションに 2 つのスライドの背景に塗りつぶしを設定します。The following example sets the background fill for slide two in the collection of selected slides in window one, assuming that there are at least two slides selected.

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

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

End With

NotesPageプロパティを使用して、指定したノートを表すSlideRangeコレクションを取得します。Use the NotesPage property to return a SlideRange collection that represents the specified notes page. 次の使用例は、作業中のプレゼンテーション上のテキスト プレース ホルダー 2 (ノート領域) 1 つのスライドのノート ページを挿入します。The following example inserts text into placeholder two (the notes area) on the notes page for slide one in the active presentation.

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

関連項目See also

PowerPoint オブジェクト モデル リファレンスPowerPoint Object Model Reference

サポートとフィードバックSupport and feedback

Office VBA またはこの説明書に関するご質問やフィードバックがありますか?Have questions or feedback about Office VBA or this documentation? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.