Retornando um objeto de uma coleção (Word)Returning an Object from a Collection (Word)

O método Item retorna um único objeto de uma coleção.The Item method returns a single object from a collection. O exemplo a seguir define docFirst a variável para um objeto Document que representa o primeiro documento da coleção Documents .The following example sets the docFirst variable to a Document object that represents the first document in the Documents collection.

Sub SetFirstDoc() 
    Dim docFirst As Document 
    Set docFirst = Documents.Item(1) 
End Sub

O método Item é o método padrão para a maioria das coleções, de forma que você pode escrever a mesma instrução de maneira abreviada omitindo a palavra-chave Item.The Item method is the default method for most collections, so you can write the same statement more concisely by omitting the Item keyword.

Sub SetFirstDoc() 
    Dim docFirst As Document 
    Set docFirst = Documents(1) 
End Sub

Objetos nomeadosNamed Objects

Ainda que em geral você possa especificar um valor inteiro com o método Item, pode ser mais conveniente retornar um objeto pelo nome.Although you can usually specify an integer value with the Item method, it may be more convenient to return an object by name. O exemplo a seguir transfere o foco para um documento chamado Sales.doc.The following example switches the focus to a document named Sales.doc.

Sub ActivateDocument() 
    Documents("Sales.doc").Activate 
    MsgBox ActiveDocument.Name 
End Sub

O exemplo a seguir retorna o texto associado ao primeiro indicador do documento ativo.The following example selects the text marked by the first bookmark in the active document.

Sub SelectBookmark() 
    ActiveDocument.Bookmarks(1).Select 
    MsgBox Selection.Text 
End Sub

Nem todas as coleções podem ser indexadas por nome.Not all collections can be indexed by name. Para determinar os valores válidos de índice das coleções, consulte o tópico referente ao objeto da coleção.To determine the valid collection index values, see the collection object topic.

Valores de índice predefinidosPredefined Index Values

Algumas coleções têm valores de índice predefinidos que você pode usar para retornar objetos individuais.Some collections have predefined index values that you can use to return single objects. Cada valor de índice predefinido é representado por uma constante.Each predefined index value is represented by a constant. Por exemplo, você especifica uma constante WdBorderType com a propriedade Borders para retornar um único objeto Border .For example, you specify a WdBorderType constant with the Borders property to return a single Border object.

O exemplo a seguir adiciona uma única borda de 0,75 pontos abaixo do primeiro parágrafo na seleção.The following example adds a single 0.75-point border below the first paragraph in the selection.

Sub AddBorderToFirstParagraphInSelection() 
    With Selection.Paragraphs(1).Borders(wdBorderBottom) 
        .LineStyle = wdLineStyleSingle 
        .LineWidth = wdLineWidth300pt 
        .Color = wdColorBlue 
    End With 
End Sub

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.