Método de TextRange. Characters (PowerPoint)TextRange.Characters method (PowerPoint)

Retorna um objeto TextRange que representa o subconjunto especificado de caracteres de texto.Returns a TextRange object that represents the specified subset of text characters. Para obter informações sobre como contar ou fazer loop pelos caracteres de um intervalo de texto, consulte o objeto TextRange.For information about counting or looping through the characters in a text range, see the TextRange object.

SintaxeSyntax

expression.expression. Characters( _Start_, _Length_ )Characters( _Start_, _Length_ )

expressão Uma variável que representa um objeto TextRange .expression A variable that represents a TextRange object.

ParâmetrosParameters

NomeName Obrigatório/OpcionalRequired/Optional Tipo de dadosData type DescriçãoDescription
StartStart OpcionalOptional LongLong O primeiro caractere no intervalo retornado.The first character in the returned range.
LengthLength OpcionalOptional LongLong O número de caracteres a ser retornado.The number of characters to be returned.

Valor de retornoReturn value

TextRangeTextRange

ComentáriosRemarks

Se Start e Length forem omitidos, o intervalo retornado iniciará com o primeiro caractere e terminará com o último parágrafo no intervalo especificado.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.

Se Start for especificado, mas Length for omitido, o intervalo retornado conterá um caractere.If Start is specified but Length is omitted, the returned range contains one character.

Se Length for especificado, mas Start for omitido, o intervalo retornado começará com o primeiro caractere no intervalo especificado.If Length is specified but Start is omitted, the returned range starts with the first character in the specified range.

Se Start for maior que o número de caracteres no texto especificado, o intervalo retornado começará com o último caractere no intervalo especificado.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.

Se Length for maior que o número de caracteres do caractere inicial especificado ao final do texto, o intervalo retornado conterá todos esses caracteres.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.

ExemploExample

Este exemplo define o texto para a forma dois do slide um da apresentação ativa e, em seguida, torna o segundo caractere subscrito com um deslocamento de 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


Este exemplo formata com negrito cada caractere subscrito na forma dois do slide um.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


Confira tambémSee also

Objeto TextRangeTextRange Object

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.