Comando locate

Utilize o comando locate para mover o cursor para o elemento, a linha, a marca, o número de seqüência ou o texto de seqüência especificado no documento.

Sintaxe

locate [ emphasis ] { element n
                   | line n
                   | mark {name | #id}
                   | sequenceNumber n
                   | [ all ] sequenceText textSpec
                    } 

Parâmetros

emphasis Utilize o parâmetro emphasis para indicar que o destino deverá ser enfatizado se encontrado.
element n Utilize o parâmetro element para mover o cursor para o elemento especificado. n deve ser um inteiro positivo. Os elementos incluem as linhas de documento exibição e não-exibição.
line n Utilize o parâmetro line para mover o cursor para a linha de documento especificada. n deve ser um inteiro positivo. As linhas do documento não incluem linhas de exibição.
mark {name | #id} Utilize o parâmetro mark para mover o cursor para a marca especificada. Uma marca pode ser indicada por seu nome ou id. id deve ser um inteiro positivo.
sequenceNumber n Utilize o parâmetro sequenceNumber para mover o cursor para a linha com o número de seqüência especificado. n deve ser um inteiro positivo.
all Utilize o parâmetro opcional all para indicar que todas as ocorrências da parte de texto de números de seqüência procurada devem ser localizadas.
sequenceText
textSpec
Utilize o parâmetro sequenceText para mover o cursor para a linha com a parte de texto de números de seqüência especificada. A parte de texto que será localizada é especificada por um ou mais parâmetros em textSpec como segue:

  string1 [ to string2 [ string3 [ to string4 ]]]

Um ou dois intervalos de cadeia podem ser especificados; nesse caso, o comando procurará uma linha com uma parte textual de números de seqüência que está lexicograficamente entre as cadeias determinadas em qualquer intervalo. Uma pesquisa de correspondência exata é executada quando apenas uma cadeia é especificada.

A menos que o parâmetro all tenha sido especificado, a pesquisa é executada somente em linhas visíveis.

Status

O parâmetro status será definido para um dos seguintes itens:
null Indica que o comando locate localizou com êxito o item especificado.
locate.wrapped Indica que o comando locate localizou com êxito a parte de texto dos números de seqüência especificada, mas teve de circular para o início do documento durante a pesquisa.
locate.notFound Indica que o item especificado não pôde ser encontrado.
locate.noSequenceText Indica que nenhuma parte de texto de números de seqüência foi definida no documento.

Exemplos

locate emphasis element 100
locate mark a
locate sequenceText 041201 to 041231 

Conceitos relacionados
Comandos, ações e parâmetros do editor

Referência relacionada
Parâmetro element
Parâmetro elements
Parâmetro emphasisLength
Parâmetro line
Parâmetro lines
Parâmetro mark
Parâmetro markId
Parâmetro sequenceNumber
parâmetro sequenceNumbers
Parâmetro sequenceText
Ação findMark
Ação findQuickMark
Ação locateLine
Comandos padrão do editor