Páginas de Pesquisa
Identificador:
org.eclipse.search.searchPages
Descrição:
Este ponto de extensão permite a um plug-in registar páginas de pesquisa para pesquisas especializadas. Quando se executa a acção de pesquisa num recurso, a infra-estrutura de pesquisa localiza a página de pesquisa registada mais específica para a acção.
Marcação da Configuração:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - um identificador totalmente qualificado 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 esta página de pesquisa
- label - uma etiqueta traduzível que será utilizada no separador de página de pesquisa
- class - um nome da classe que implementa org.eclipse.search.ui.ISearchPage. Recomendamos criar uma subclasse de org.eclipse.jface.dialogs.DialogPage.
- icon - um nome relativo da imagem que será utilizado em todos os recursos que correspondam às extensões especificadas. Caso seja omitido, o separador da página de pesquisa só irá conter uma etiqueta.
- sizeHint - uma sugestão do tamanho inicial da página. Consiste numa sequência contendo a largura e altura separadas por uma vírgula (por exemplo, "50, 60"). No caso desta sugestão ser omitida, a página será maior do que as restantes páginas.
- tabPosition - um número inteiro que define onde se coloca a página no bloco de páginas. O valor não define a posição absoluta e sim a posição em relação a outras páginas. A ordem das páginas é a seguinte:
-
caso nenhuma página defina a posição dos separadores, então estas serão colocadas por ordem alfabética, de acordo com as suas etiquetas
-
caso ambas as páginas tenham a posição dos separadores especificada, então em primeiro lugar virá a página com o valor mais baixo. Caso os valores sejam iguais, então as páginas são processadas como se os valores não existissem (consultar 1.)
-
Caso apenas uma página possua o valor especificado, então esta página virá em primeiro lugar
- extensions - Uma lista de extensões de ficheiros separadas por vírgulas nas quais a página de pesquisa pode operar. Cada extensão também tem de incluir um peso (sendo 0 o peso mais baixo), que permita à infra-estrutura de pesquisa encontrar a página mais adequada. O peso é separado da extensão por dois pontos. Caso uma página de pesquisa possa pesquisar todos os recursos possíveis, então pode utilizar-se "*".
- searchViewHelpContextId - um ID de contexto de ajuda opcional da vista Pesquisar, que apresenta resultados desta página. Caso falte este atributo, é utilizado o ID de contexto de ajuda predefinido (org.eclipse.search.search_view_context).
- showScopeSection - Caso falte este atributo ou esteja definido como "false", então a secção de âmbito não é mostrada na caixa de diálogo Pesquisar.
Para ver a secção de âmbito, este atributo tem de ser definido como "true".
Os plug-ins que adicionam a sua página de pesquisa e que pretendem ver a secção de âmbito têm de adicionar esta tributo ao seu ficheiro plugin.xml.
- enabled - Caso falte este atributo ou esteja definido como "false", então a página não é mostrada inicialmente na caixa de diálogo Pesquisar.
A página pode ser activada pelo utilizador através do botão"Personalizar..." na caixa de diálogo Pesquisar.
- canSearchEnclosingProjects - Caso falte este atributo ou esteja definido como "false", então o âmbito de pesquisa "Projectos Englobantes" não é mostrado na área de âmbito da caixa de diálogo Pesquisar.
Caso falte o atributo "showScopeSection" ou esteja definido como "false", este atributo será ignorado.
Exemplos:
De seguida é apresentado um exemplo de um ponto 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>
Informações de API:
A classe contribuída tem de implementar org.eclipse.search.ui.ISearchPage
Implementação Facultada:
A infra-estrutura de pesquisa faculta uma página de pesquisa para pesquisar textos completos.
Copyright (c) 2001, 2004 IBM Corporation e outros.
Todos os direitos reservados. Este programa e os materiais que o acompanham estão disponíveis sob os termos da Eclipse Public License v1.0, que acompanha esta distribuição, e estão disponíveis em http://www.eclipse.org/legal/epl-v10.html