TextRange メソッド (PowerPoint)TextRange.Runs method (PowerPoint)

指定したテキストランのサブセットを表すTextRangeオブジェクトを返します。Returns a TextRange object that represents the specified subset of text runs. テキスト ランは、同じフォント属性を共有する文字の範囲によって構成されます。A text run consists of a range of characters that share the same font attributes.

構文Syntax

expression.expression. Runs( _Start_, _Length_ )

TextRangeオブジェクトを表す変数を取得します。expression A variable that represents a TextRange object.

パラメーターParameters

名前Name 必須 / オプションRequired/Optional データ型Data type 説明Description
StartStart 省略可能Optional LongLong 返されるテキスト範囲の最初のランを指定します。The first run in the returned range.
LengthLength 省略可能Optional LongLong 返されるテキストのラン数を指定します。The number of runs to be returned.

戻り値Return value

TextRangeTextRange

解説Remarks

引数 Start と Length の両方を省略する場合、返されるテキストは指定した範囲の最初のランから最後の段落までになります。If both Start and Length are omitted, the returned range starts with the first run and ends with the last paragraph in the specified range.

Start を指定して Length を省略すると、取得範囲はラン 1 つとなります。If Start is specified but Length is omitted, the returned range contains one run.

Length を指定して Start を省略すると、取得範囲は指定された範囲の先頭のランから始まります。If Length is specified but Start is omitted, the returned range starts with the first run in the specified range.

Start が指定されたテキストのラン数より大きい場合、取得範囲は指定された範囲の最後のランから始まります。If Start is greater than the number of runs in the specified text, the returned range starts with the last run in the specified range.

Length が指定された先頭のランからテキスト末尾までのラン数より大きい場合、取得範囲はこれらすべてのランとなります。If Length is greater than the number of runs from the specified starting run to the end of the text, the returned range contains all those runs.

ランとは、先行する文字と異なるフォント属性を持つ文字から、同じフォント属性を持つ最後の文字から 2 番目の文字までの、すべての文字を意味します。A run consists of all characters from the first character after a font change to the second-to-last character that has the same font attributes. たとえば、次の文を考えてみましょう。For example, consider the following sentence:

この斜体の単語は太字ではありません。This italic word is not bold.

この文では、"This" という単語の後ろのスペースが斜体として書式設定されていない場合、最初のランは "This" という単語で構成されます (スペースが斜体として書式設定されている場合、最初のランは最初の 3 文字 "Thi" で構成されます)。In the preceding sentence, the first run consists of the word "This" only if the space after the word "This" isn't formatted as italic (if the space is italic, the first run is only the first three characters, or "Thi"). 同様に、単語の後ろのスペースが斜体として書式設定されている場合、2 番目のランは単語 "italic" となります。Likewise, the second run contains the word "italic" only if the space after the word is formatted as italic.

テキスト範囲内のランのカウントまたはループについては、 TextRange オブジェクトを参照してください。For information about counting or looping through the runs in a text range, see the TextRange object.

Example

次の使用例は、作業中のプレゼンテーションのスライド 1 の図形 2 内の 2 番目のランの書式が既に斜体として書式設定されている場合、太字も設定します。This example formats the second run in shape two on slide one in the active presentation as bold italic if it is already italic.

With Application.ActivePresentation.Slides(1).Shapes(2) _
        .TextFrame.TextRange

    With .Runs(2).Font
        If .Italic Then
            .Bold = True
        End If
    End With

End With


関連項目See also

TextRange オブジェクトTextRange Object

サポートとフィードバック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.