Parâmetro mark

Utilize o parâmetro mark para consultar, definir ou remover uma marca nomeada ou não.  Uma marca é um rótulo atribuído a uma parte adjacente do documento. Como o documento é editado, a localização da marca é mantida de forma que ela permaneça com o texto no qual foi iniciada.

Há dois tipos de marcas: marcas de elemento e marcas de caractere. As marcas de elementos não têm posições de colunas e referem-se apenas a elementos completos. As marcas de caracteres têm posições de colunas e podem fazer referência a elementos parciais. Você também pode especificar se uma marca deve ser uma marca de aderência ou não. Uma marca de aderência será expandida se o texto for incluído imediatamente antes ou depois da marca.

Disponibilidade

comando query
comando set

Escopo

A visualização atual.

Sintaxe

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

Parâmetros

name Utilize o parâmetro name para especificar um novo nome ou o nome de uma marca existente. Os nomes podem conter quaisquer caracteres, exceto espaços, e não podem começar com o caractere #.
id Utilize o parâmetro id para especificar o id de uma marca existente. O id é um valor inteiro positivo que identifica exclusivamente uma marca.
clear Utilize o parâmetro clear para remover a marca especificada.
[ sticky ] element
[ element1 [ element2 ] ]
Especifique o parâmetro opcional sticky se quiser que esta marca seja expandida, se elementos forem incluídos logo após ou antes da marca. Utilize o parâmetro element para indicar que a marca deve ser criada (ou recriada) como uma marca de elemento. As marcas de elementos referem-se apenas a elementos completos.
Especifique os parâmetros opcionais element1 e element2 para indicar o intervalo de marca de elemento. element1 e element2 devem ser inteiros positivos e devem fazer referências aos números ordinais do elemento. Se você não especificar element2, a marca será criada com element1 como o início ou fim da marca. Se você não especificar element1 ou element2, a marca será criada com o elemento atual como o início e fim da marca.
[ sticky ]
[ element1 [ column1
[ element2 [ column2 ] ] ] ]
Especifique o parâmetro opcional sticky se quiser que esta marca seja expandida, se o texto for incluído imediatamente antes ou depois da marca. Se você não especificar nenhum parâmetro, uma marca de caractere será criada. Uma marca de caractere tem um elemento inicial com uma coluna inicial e um elemento final com uma coluna final. Por padrão, a marca de caractere é criada com o seu ponto inicial e final na posição atual do cursor. 
Se você especificar element1, a marca iniciará e terminará na coluna 1 do elemento especificado. Se você especificar somente element1 e column1, o elemento será iniciado e finalizado na posição especificada. Se você especificar somente element1, column1 e element2, a marca será iniciada em column1 deelement1 e finalizada na coluna 1 de element2.

Descrição

Se um nome ou id de marca ou a opção clear não forem especificados, você criará uma marca não nomeada. Você só poderá fazer referência a essa marca não nomeada pelo seu id. É possível determinar o id da marca emitindo "query markId." (observe o ponto final). "query markId." retornará o id da última marca criada. Se um nome ou id de marca não forem especificados e a opção clear for especificada, você removerá a última marca criada.

Exemplos

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

Referência relacionada
Comando locate
comando query
comando set
Parâmetro headerMark
parâmetro markExcluded
Parâmetro markExcludedHeader
Parâmetro markHighlight
Parâmetro markId
parâmetro markIncluded
Parâmetro markProtect
Parâmetro markStyle
Ação findMark
Ação findQuickMark
Ação nameMark
Ação setQuickMark