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 procura para procuras 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 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
extensions CDATA #IMPLIED
searchViewHelpContextId CDATA #IMPLIED
showScopeSection (true | false)
enabled (true | false)
canSearchEnclosingProjects (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 uma 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 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.
- searchViewHelpContextId - um ID de contexto de ajuda opcional da visualização Procura exibindo os resultados dessa página. Se esse atributo estiver faltando, o ID de contexto de ajuda de procura padrão (org.eclipse.search.search_view_context) é 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.
- canSearchEnclosingProjects - Se esse atributo estiver faltando ou estiver definido como "false", o escopo de pesquisa "Projetos Incluídos" não é mostrado na parte do escopo do diálogo de pesquisa.
Se o atributo "showScopeSection" estiver faltando ou estiver definido como "false", esse atributo será ignorado.
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=
"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>
Informação sobre API:
A classe contribuída deve implementar org.eclipse.search.ui.ISearchPage
Implementação Fornecida:
A infra-estrutura de pesquisa fornece uma página de procura para procura de texto completo.
Direitos Autorais (c) 2001, 2004 IBM Corporation e outros.
Todos os direitos reservados.
Este programa e os materiais que o acompanham são disponibilizados
sob os termos da Eclipse Public License v1.0 que acompanha esta
distribuição e estão disponíveis no endereço http://www.eclipse.org/legal/epl-v10.html