Parametro mark

Utilizzare il parametro mark per eseguire una query, impostare o rimuovere un contrassegno denominato o non denominato.  Un contrassegno è un'etichetta che è stata assegnata ad una parte contigua del documento.  Poiché il documento è modificato, l'ubicazione del contrassegno resta con il testo su cui era stata avviata.

Esistono due tipi di contrassegno: contrassegni di elemento e di caratteri.  I contrassegni di elemento non hanno posizioni di colonna e si riferiscono solo ad elementi completi.  I contrassegni di caratteri hanno posizioni di colonna e si possono riferire ad elementi parziali.  Inoltre, è anche possibile specificare se un contrassegno deve essere aderente. Un contrassegno aderente si espanderà se si aggiunge testo immediatamente prima o dopo il contrassegno.

Disponibilità

Comando query
Comando set

Ambito

La vista corrente.

Sintassi

query mark.[name | #id]
set mark.[name | #id] { clear
                      | [ sticky ] element [ element1 [ element2 ] ]
                      | [ sticky ] [ element1 [ column1 [ element2 [ column2 ] ] ] ]
                      } 

Parametri

Name Utilizzare il parametro name per specificare un nome nuovo o il nome del segno esistente.  I nomi possono contenere qualsiasi carattere ma non gli spazi e potrebbero non avviarsi con il carattere #.
Id Utilizzare il parametro id per specificare l'id di un segno esistente.  L'id è un valore intero positivo che identifica unicamente un segno.
Clear Utilizzare il parametro clear per eliminare il segno specificato.
[ sticky ] element
[ element1 [ element2 ] ]
Specificare il parametro sticky se si desidera che questo contrassegno si espanda se vengono aggiunti elementi subito prima o dopo il contrassegno.  Utilizzare il parametro element per indicare che il contrassegno deve essere creato (o ricreato) come contrassegno di elemento.  I contrassegni di elemento si riferiscono solo ad elementi completi.
Specificare i parametri element1 ed element2 per indicare l'intervallo del contrassegno di elemento.  element1 e element2 devono essere interi positivi e fare riferimento a numeri ordinali dell'elemento.  Se non si specifica element2, il contrassegno verrà creato con element1 come inizio e fine del contrassegno.  Se non si specifica element1 o element2, il contrassegno viene creato con l'elemento corrente come inizio e fine del contrassegno.
[ sticky ]
[ element1 [ column1
[ element2 [ column2 ] ] ] ]
Specificare il parametro facoltativo sticky se si desidera che questo contrassegno si espanda se viene aggiunto del testo immediatamente prima o dopo il contrassegno.  Se non si specifica alcun parametro, verrà creato un contrassegno di caratteri. Un contrassegno di carattere ha un elemento iniziale con una colonna iniziale ed un elemento finale con una colonna finale.  Per impostazione predefinita il contrassegno di carattere viene creato con il punto iniziale e finale sull'attuale posizione del cursore. 
Se si specifica solo element1, il contrassegno inizia e termina alla colonna 1 dell'elemento. Se si specifica solo element1 e column1, l'elemento inizia e finisce alla posizione specificata.  Se si specifica solo element1, column1, ed element2, il contrassegno inizia alla column1 dielement1 e finisce alla colonna 1 di element2.

Descrizione

Se non si specifica un nome del segno o un id del segno e non si specifica l'opzione clear, verrà creato un segno non nominato.  Ci si potrà riferire a tale segno non nominato solo attraverso il suo id.  E' possibile determinare l'id del segno immettendo "query markId." (tener presente il punto finale).  "query markId." ripristinerà l'id dell'ultimo segno creato.  Se non si specifica un nome del segno o un id del segno e non si specifica l'opzione clear , verrà eliminato l'ultimo segno creato.

Esempi

query mark.test
set mark.test element 5 10
set mark.test sticky 1 1 1 1
set mark.test clear 

Riferimento correlato
Comando locate
Comando query
Comando set
Parametro headerMark
Parametro markExcluded
Parametro markExcludedHeader
Parametro markHighlight
Parametro markId
Parametro markIncluded
Parametro markProtect
Parametro markStyle
Azione findMark
Azione findQuickMark
Azione nameMark
Azione setQuickMark