Comando locate

Utilizzare il comando locate per spostare il cursore all'elemento, alla riga, al segno, al numero di sequenza o al testo di sequenza specificato nel documento.

Sintassi

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

Parametri

emphasis Utilizzare il parametro emphasis per indicare che l'obiettivo deve essere enfatizzato se non viene trovato.
element n Utilizzare il parametro element per spostare il cursore all'elemento specificato.  n deve essere un numero intero positivo.  Tra gli elementi sono compresi le righe show e non show del documento.
line n Utilizzare il parametro line per spostare il cursore alla riga specificata del documento.  n deve essere un numero intero positivo.  Tra le righe del documento sono escluse le righe show.
mark {name | #id} Utilizzare il parametro mark per spostare il cursore al segno specificato.  Un segno può essere indicato dal suo stesso nome o id.  id deve essere un valore intero positivo.
sequenceNumber n Utilizzare il parametro sequenceNumber per spostare il cursore alla riga con i numeri di sequenza specificati.  n deve essere un valore intero positivo.
Tutte Utilizzare il parametro facoltativo all per indicare che devono essere individuate tutte le ricorrenze della parte testo del numero di sequenza ricercato.
sequenceText
textSpec
Utilizzare il parametro sequenceText per spostare il cursore alla riga con la parte di testo numeri di sequenza specificata.  La parte di testo per da localizzare é specificata da uno o più parametri in textSpec come segue:

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

Si devono specificare uno o due intervalli di stringa;  in questo caso, il comando cercherà una riga con una parte di testo sequenza di numeri che si trova lessicograficamente tra le stringhe date in ciascun intervallo.  Una ricerca di corrispondenza esatta viene eseguita solo quando si specifica una stringa.

A meno che il parametro all non era specificato, la ricerca viene eseguita solo sulle righe visibili.

Status

Il parametro status sarà impostato ad una delle seguenti situazioni:
null Indica che il comando locate ha localizzato con esito positivo l'elemento specificato.
locate.wrapped Indica che il comando locate ha localizzato con esito positivo la parte di testo numeri di sequenza specificato, ma deve tornare all'inizio del documento durante la ricerca.
locate.notFound Indica che é impossibile trovare l'elemento specificato.
locate.noSequenceText Indica che non é stata impostata nel documento nessuna parte di testo numeri di sequenza.

Esempi

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

Argomenti correlati
Comandi, azioni e parametri dell'editor

Riferimento correlato
Parametro element
Parametro elements
Parametro emphasisLength
Parametro line
Parametro lines
Parametro mark
Parametro markId
Parametro sequenceNumber
Parametro sequenceNumbers
Parametro sequenceText
Azione findMark
Azione findQuickMark
Azione locateLine
Comandi predefiniti dell'editor