Utilize o comando findText para localizar e opcionalmente substituir o texto em um documento.
Os parâmetros para o comando findText são divididos em dois grupos:
findText [ up | checkStart | replace | all | quiet | noBeep ] [...] [ [ mark | columns col1 col2 | block | wholeWord | noWrap | asis | noEmphasis | regularExpression | replaceWith replaceText ] [...] text ]
para cima | Utilize o parâmetro opcional up para indicar que a procura deve retroceder a partir da posição atual. |
checkStart | Utilize o parâmetro opcional checkStart para indicar que a posição atual do cursor deve ser verificada antes de prosseguir com a procura. |
replace | Utilize o parâmetro opcional replace para indicar que o texto localizado deve ser substituído pelo texto indicado pelo parâmetro findText.replaceText. |
all | Utilize o parâmetro opcional all para indicar que todas as ocorrências do texto procurado devem ser localizadas. A pesquisa ignora a posição atual do cursor, mas segue as restrições de block e columns. |
quiet | Utilize o parâmetro opcional quiet para indicar que nenhum feedback de mensagem ou áudio deve ser emitido. |
noBeep | Utilize o parâmetro opcional noBeep para indicar que nenhum feedback de áudio deve ser emitido. |
mark | Utilize o parâmetro opcional mark para indicar que o texto encontrado deve ser selecionado. |
columns col1 col2 | Utilize o parâmetro opcional columns para restringir o escopo da procura às colunas iniciais e finais especificadas. col1 e col2 devem ser inteiros positivos. |
block | Utilize o parâmetro opcional block para restringir o escopo da procura à seleção de bloco atual. |
wholeWord | Utilize o parâmetro opcional wholeWord para restringir a procura a palavras inteiras. Palavras consistem em letras, dígitos e sublinhados. |
noWrap | Utilize o parâmetro opcional noWrap para indicar que a procura deve parar quando atingir o final do documento. Ou, quando a pesquisa ocorre inversamente no documento, o parâmetro noWrap indica que a pesquisa deve ser interrompida quando atingir a parte superior do documento. |
asis | Utilize o parâmetro opcional asis para indicar que a procura deve fazer distinção entre maiúsculas e minúsculas. |
noEmphasis | Utilize o parâmetro opcional noEmphasis para indicar que o texto localizado não deve ser enfatizado com o estilo de ênfase da visualização de documento. |
regularExpression | Utilize o parâmetro opcional regularExpression para indicar que a cadeia de procura deve ser tratada como um padrão de expressão comum. |
replaceWith replaceText | Utilize o parâmetro opcional replaceWith para indicar que o texto localizado deve ser substituído por replaceText. Se replaceText contiver espaços, ele deverá ser colocado entre aspas ("). Se replaceText contiver aspas, será necessário colocar como prefixo para as aspas uma barra invertida (\"). Se replaceText contiver barras invertidas, será necessário colocar como prefixo para as barras invertidas outra barra invertida (\\). |
text | Utilize o parâmetro text para indicar o texto no qual deseja fazer a procura. Talvez seja necessário colocar a cadeia entre aspas se estiver procurando uma das palavras-chave findText. |
O parâmetro status será definido para um dos seguintes itens:
null Indica que o comando findText localizou com êxito o texto especificado sem quaisquer condições especiais. findText.onlyOccurrence Indica que o comando findText pesquisou o documento inteiro, circulou e localizou o texto especificado na localização original do cursor. findText.wrapped Indica que o comando findText localizou com êxito o texto especificado, mas teve que circular para o início do documento durante a procura. Ou se a procura estava sendo feita de forma inversa, ele teve que circular para o fim do arquivo durante a procura. findText.notFound Indica que o texto especificado não pôde ser encontrado. findText.invalidPattern Indica que o texto especificado não é um padrão de expressão regular válido. Esse status pode ser definido somente quando você tiver indicado que o texto especificado é um padrão de expressão comum.
O comando findText utiliza os seguintes parâmetros:
- findText.asis
- findText.block
- findText.columns
- findText.emphasis
- findText.endColumn
- findText.findText
- findText.mark
- findText.regularExpression
- findText.replaceText
- findText.startColumn
- findText.wholeWord
- findText.wrap.
A menos que o parâmetro all tenha sido especificado, o comando findText afetará apenas os elementos visíveis.
As expressões comuns permitem localizar um texto que corresponda a um padrão especificado. O suporte da expressão comum no editor é aquele fornecido pela linguagem Java. Note, entretanto, que o comando findText opera linha por linha.
A seguir são apresentados alguns padrões de expressão comum:
c Se c não for um caractere especial, então corresponderá a uma instância única desse caractere. \c Corresponde a uma instância única do caractere c que, de outra forma, seria interpretado como um caractere especial. Por exemplo, a expressão \\ corresponde a uma única barra invertida e a expressão \[ corresponde a um colchete esquerdo. \t O caractere de tabulação ('\u0009'). \xhh O caractere com valor hexadecimal 0xhh. Cada h representa um dígito hexadecimal. \uhhhh O caractere com valor hexadecimal 0xhhhh. Cada h representa um dígito hexadecimal. . Corresponde a qualquer caractere simples. [abc] Corresponde a qualquer caractere único incluído em abc. [^abc] Corresponde a qualquer caractere único, exceto aqueles incluídos em abc. [a-z] Corresponde a qualquer caractere único no intervalo de a até z. [^a-z] Corresponde a qualquer caractere único, exceto aqueles incluídos no intervalo de a até z. [a-zA-Z] Corresponde a qualquer caractere único no intervalo de a até z ou de A até Z. \d Um dígito. Ele é equivalente a [0-9]. \D UM não-dígito. Ele é equivalente a [^0-9]. \s Um caractere de espaço em branco. Ele é equivalente a [ \t\x0A\x0B\x0C\x0D]. \S Um caractere diferente de espaço em branco. Ele é equivalente a [^\s]. \w Um caractere de palavra (um alfanumérico). Ele é equivalente a [a-zA-Z0-9_]. \W Um caractere diferente de palavra. Ele é equivalente a [^\w]. ^ Corresponde ao início de uma linha. ^ deve ser o primeiro caractere na expressão. $ Corresponde ao final de uma linha. $ deve ser o último caractere na expressão. \b Corresponde a um limite de palavra. \B Corresponde a um limite não relacionado a palavra. X? Corresponde a zero ou uma ocorrência da expressão X. A maior correspondência possível é localizada (correspondência voraz). X* Corresponde a zero ou mais ocorrências sucessivas da expressão X. A maior correspondência possível é localizada (correspondência voraz). X+ Corresponde a uma ou mais ocorrências sucessivas da expressão X. A maior correspondência possível é localizada (correspondência voraz). X{n} Corresponde exatamente a n ocorrências sucessivas da expressão X. A maior correspondência possível é localizada (correspondência voraz). X{n,} Corresponde pelo menos a n ocorrências sucessivas da expressão X. A maior correspondência possível é localizada (correspondência voraz). X{n,m} Corresponde pelo menos a n mas não mais de m ocorrências sucessivas da expressão X. A maior correspondência possível é localizada (correspondência voraz). X?? Corresponde a zero ou uma ocorrência da expressão X. A menor correspondência é localizada (correspondência não voraz). X*? Corresponde a zero ou mais ocorrências sucessivas da expressão X. A menor correspondência é localizada (correspondência não voraz). X+? Corresponde a uma ou mais ocorrências sucessivas da expressão X. A menor correspondência é localizada (correspondência não voraz). X{n}? Corresponde exatamente a n ocorrências sucessivas da expressão X. A menor correspondência é localizada (correspondência não voraz). X{n,}? Corresponde pelo menos a n ocorrências sucessivas da expressão X. A menor correspondência é localizada (correspondência não voraz). X{n,m}? Corresponde pelo menos a n mas não mais de m ocorrências sucessivas da expressão X. A menor correspondência é localizada (correspondência não voraz). XY Corresponde à expressão X seguida pela expressão Y. X|Y Corresponde à expressão X ou Y.
findText "text" findText replaceWith "new text" "text" findText up findText regularExpression "this|that"
Comandos, ações e parâmetros do editor
Parâmetro emphasisLength
Parâmetro expandHide
parâmetro expanded
Parâmetro findText.asis
Parâmetro findText.block
Parâmetro findText.columns
Parâmetro findText.emphasis
Parâmetro findText.endColumn
Parâmetro findText.findText
Parâmetro findText.mark
Parâmetro findText.regularExpression
Parâmetro findText.replaceText
Parâmetro findText.startColumn
Parâmetro findText.wholeWord
Parâmetro findText.wrap
parâmetro topExpanded
Parâmetro visible
Ação filterSelection
Ação find
Ação findAndReplace
Ação findAndReplaceNext
Ação findAndReplaceUp
Ação findNext
Ação findSelection
Ação findUp
Comandos padrão do editor
Padrões de expressões Java comuns
Copyright IBM Corporation 1992, 2004. Todos os direitos reservados.