Páginas de Pesquisa
Identificador: org.eclipse.search.searchPages
Descrição: Este ponto de extensão permite que um plug-in registre páginas de pesquisa para pesquisas especializadas. Quando a ação de pesquisa é executada em
um recurso, a infra-estrutura de pesquisa localiza a página de pesquisa registrada
mais específica para ele.
Marcação da Configuração:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED
>
- point - um identificador completo do ponto de extensão de destino
- id - um identificador opcional da instância de extensão
- name - um nome opcional da instância de extensão
<!ELEMENT page EMPTY>
<!ATTLIST page
id CDATA #REQUIRED
label CDATA #REQUIRED
class CDATA #REQUIRED
icon CDATA #IMPLIED
sizeHint CDATA #IMPLIED
tabPosition CDATA #IMPLIED
extension CDATA #IMPLIED
showScopeSection (true | false)
enabled (true | false)
>
- id - um nome exclusivo que será utilizado para identificar essa página de pesquisa.
- label - uma etiqueta traduzível que será utilizada na guia da página de pesquisa.
- class - um nome de classe. Recomenda-se a classe filha org.eclipse.jface.dialogs.DialogPage.
- icon - um nome relativo da imagem que será utilizado para todos os recursos
que correspondem às extensões especificadas. Se omitido, a
guia da página de pesquisa só conterá uma etiqueta.
- sizeHint - uma dica para o tamanho inicial da página. Essa é uma cadeia
que contém a largura e altura separadas por vírgula (por ex., "50, 60"). No caso
de essa dica ser omitida, a página não será maior que as outras páginas.
- tabPosition - um inteiro que define onde a página é colocada no bloco de páginas. O valor não define a posição absoluta mas a posição em relação a outras páginas. A ordenação de páginas é a seguinte:
-
se nenhuma das páginas definir a posição da guia, elas serão ordenadas alfabeticamente de acordo com as suas etiquetas.
-
se ambas as páginas tiverem a posição da guia especificada, a página com o valor menor aparecerá primeiro. Se os valores forem iguais, as páginas serão tratadas como se os valores não existissem (consulte 1).
-
se apenas uma página tiver o valor especificado, essa página aparecerá primeiro.
- extension - uma lista separada por vírgula com extensões de arquivos nas quais
a página de pesquisa pode operar. Cada extensão também deve incluir um peso (0 significa
o menor peso) que permite que a infra-estrutura encontre a página mais
apropriada. O peso é separado da extensão por dois-pontos.
Se uma página de pesquisa puder pesquisar todos os recursos possíveis, então "*" poderá ser utilizado.
- showScopeSection - se este atributo estiver ausente ou definido como "false", a seção de escopo não será mostrada no diálogo Pesquisar.
Para a exibição da seção de escopo, esse atributo deve ser definido como "true".
Os plug-ins que incluem sua própria página Pesquisar e
que deseja ver a seção de escopo, precisam incluir isso em seu plugin.xml.
- enabled - se este atributo estiver ausente ou definido como "false", a página não será inicialmente mostrada no diálogo Pesquisar.
A página pode ser ativada pelo usuário por meio do botão "Personalizar..." do diálogo Pesquisar.
Exemplos: A seguir, um exemplo de definição de extensão de uma página de pesquisa:
<extension point="org.eclipse.search.searchPages">
<page id="org.eclipse.search.ui.text.TextSearchPage"
label="Text Search"
icon="icons/full/obj16/tsearch_pref.gif"
sizeHint="250,160"
tabPosition="1"
extensions="*:1"
showScopeSection="true"
class="org.eclipse.search.ui.text.TextSearchPage">
</page>
</extension>
Implementação fornecida: A infra-estrutura de pesquisa fornece
uma página de pesquisa para pesquisa de texto completo.