Метод TextRange. characters (PowerPoint)TextRange.Characters method (PowerPoint)

Возвращает объект TextRange , представляющий заданное подмножество текстовых символов.Returns a TextRange object that represents the specified subset of text characters. Сведения о том, как подсчитать или циклически пересчитать символы в диапазоне текста, можно найти в разделе объект TextRange .For information about counting or looping through the characters in a text range, see the TextRange object.

СинтаксисSyntax

выражение.expression. Characters( _Start_, _Length_ )Characters( _Start_, _Length_ )

Expression (выражение ) Переменная, представляющая объект TextRange .expression A variable that represents a TextRange object.

ПараметрыParameters

ИмяName Обязательный или необязательныйRequired/Optional Тип данныхData type ОписаниеDescription
НачалоStart НеобязательныйOptional LongLong Первый символ в возвращенном диапазоне.The first character in the returned range.
LengthLength НеобязательныйOptional LongLong Число возвращаемых символов.The number of characters to be returned.

Возвращаемое значениеReturn value

TextRangeTextRange

ПримечанияRemarks

Если начало и длина опущены, возвращаемый диапазон начинается с первого символа и заканчивается последним абзацем в указанном диапазоне.If both Start and Length are omitted, the returned range starts with the first character and ends with the last paragraph in the specified range.

Если указано значение Start, но длина опущена, возвращаемый диапазон содержит один символ.If Start is specified but Length is omitted, the returned range contains one character.

Если длина указана, но параметр start опущен, возвращаемый диапазон начинается с первого символа в указанном диапазоне.If Length is specified but Start is omitted, the returned range starts with the first character in the specified range.

Если параметр start имеет значение, превышающее число символов в указанном тексте, возвращаемый диапазон начинается с последнего символа в указанном диапазоне.If Start is greater than the number of characters in the specified text, the returned range starts with the last character in the specified range.

Если длина превышает количество символов от указанного начального знака до конца текста, возвращаемый диапазон содержит все эти символы.If Length is greater than the number of characters from the specified starting character to the end of the text, the returned range contains all those characters.

ПримерExample

В этом примере задается текст для фигуры две на слайде 1 в активной презентации, а второй символ преобразуется в знак подстрочного индекса с 20 процентным смещением.This example sets the text for shape two on slide one in the active presentation and then makes the second character a subscript character with a 20-percent offset.

Dim charRange As TextRange

With Application.ActivePresentation.Slides(1).Shapes(2)

    Set charRange = .TextFrame.TextRange.InsertBefore("H2O")

    charRange.Characters(2).Font.BaselineOffset = -0.2

End With


В этом примере каждый символ подстрочного знака в фигуре 2 на слайде форматируется полужирным шрифтом.This example formats every subscript character in shape two on slide one as bold.

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

    For i = 1 To .Characters.Count

        With .Characters(i).Font

            If .Subscript Then .Bold = True

        End With

    Next

End With


См. такжеSee also

Объект TextRangeTextRange 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.