Páginas de Pesquisa
Identificador: org.eclipse.search.searchPages
Descrição: Esse 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 page EMPTY>
<!ATTLIST page
id CDATA
#REQUIRED
label CDATA #REQUIRED
class CDATA #REQUIRED
icon CDATA #IMPLIED
sizeHint CDATA #REQUIRED
tabPosition CDATA #IMPLIED
extension CDATA #IMPLIED
showScopeSection CDATA #IMPLIED
enabled CDATA #IMPLIED
>
- 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 que implementa org.eclipse.search.ui.ISearchPage.
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 tabPosition não for especificado para uma página, então, Integer.MAX_VALUE / 2 será utilizado
- a página com o valor menor aparecerá primeiro. Se os valores forem iguais,
as páginas serão ordenadas alfabeticamente de acordo com seus rótulos
-
extension - uma lista com extensões de arquivo, separadas por vírgula, em que
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 faltando ou definido como "falso", a
seção de escopo não será mostrada no diálogo Pesquisar. Para ver a seção de escopo, este
atributo precisa ser definido como "verdadeiro". 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 faltando ou estiver definido como "falso"
a página não será, inicialmente, mostrada no diálogo Pesquisar. A página pode
ser ativada pelo usuário através do botão "Personalizar..." no diálogo Pesquisar.
Exemplos:
Segue um exemplo de definição de extensão de página de pesquisa:
<extension point="org.eclipse.search.searchPages">
<page
id="org.eclipse.search.ui.text.TextSearchPage"
label="Pesquisa de Texto"
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.