Share via


Método Selection.HomeKey (Word)

Move ou estende a seleção até o início da unidade especificada. Esse método retorna um inteiro que indica o número de caracteres que a seleção foi realmente movida ou retorna 0 (zero) se a movimentação não tiver sido bem-sucedida. Esse método corresponde à funcionalidade da chave HOME.

Sintaxe

expression. HomeKey( _Unit_ , _Extend_ )

Expressão Uma variável que representa um objeto Selection .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Unit Opcional Variant A unidade pela qual a seleção deve ser movido ou estendido. O valor padrão é wdLine.
Extend Opcional Variant Especifica a maneira como a seleção é movido. Pode ser uma das seguintes constantes WdMovementType. Se o valor desse argumento for wdMove, a seleção é recolhida para um ponto de inserção e movida para o início da unidade especificada. Se for wdExtend, o início da seleção é estendido até o início da unidade especificada. O valor padrão é wdMove.

Exemplo

Este exemplo move a seleção para o início do texto atual. Se a seleção estiver no texto principal, será movida para o início do documento.

Selection.HomeKey Unit:=wdStory, Extend:=wdMove

Este exemplo move a seleção para o início da linha atual e atribui o número de caracteres movidos à variável pos.

pos = Selection.HomeKey(Unit:=wdLine, Extend:=wdMove) 
If pos = 0 Then StatusBar = "Selection was not moved"

Confira também

Objeto Selection

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? 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.