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 de 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
-
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 o org.eclipse.jface.dialogs.IDialogPage.
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 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.
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"
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.