Páginas de búsqueda
Identificador: org.eclipse.search.searchPages
Descripción: este punto de extensión permite que un conector
registre páginas de búsqueda para realizar búsquedas especializadas. Cuando se
realiza la acción de búsqueda en un recurso, la infraestructura de búsqueda
localiza la página de búsqueda registrada más adecuada para ella.
Códigos XML de configuración:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED
>
- point: identificador totalmente calificado del punto de extensión destino
- id: identificador opcional de la instancia de extensión
- name: nombre opcional de la instancia de extensión
<!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
showScopeSection (true | false)
enabled (true | false)
>
- id: nombre exclusivo que se utilizará para identificar esta página de búsqueda.
- label: etiqueta traducible que se utilizará en la pestaña de la página
de búsqueda.
- class: nombre de la clase. Es aconsejable crear una
subclase de org.eclipse.jface.dialogs.DialogPage.
- icon: nombre relativo de la imagen que se utilizará para todos los
recursos que coincidan con las extensiones especificadas.
Si se omite, la
pestaña de la página de búsqueda únicamente contendrá una etiqueta.
- sizeHint: sugerencia del tamaño inicial de la página. Es una
serie que indica la altura y la anchura separadas por una coma
(por ejemplo, "50, 60"). En el caso de que se omita esta sugerencia, el tamaño de
la página no será mayor que el de las demás.
- tabPosition: entero que define dónde se colocará la página en el cuaderno
de páginas. El valor no define la posición absoluta, sino la posición relativa
con respecto a las otras páginas. Las páginas se ordenan según estos criterios:
-
si ninguna de las páginas define la posición de las pestañas, se ordenan alfabéticamente de acuerdo con sus etiquetas
-
si ambas páginas tienen especificada la posición de la pestaña, la página que tenga el valor más bajo se colocará en primer lugar. Si los valores son iguales, las páginas se tratarán como si los valores no existieran (ver 1).
-
si sólo una página tiene especificado el valor, dicha página se colocará en primer lugar
- extensions: lista separada por comas de las extensiones de archivo en
las que puede actuar la página de búsqueda. Cada extensión también debe incluir
un peso (siendo 0 el peso menor), lo que permite a la infraestructura de
búsqueda localizar la página más adecuada. El peso se separa de la extensión
mediante el signo de dos puntos. Si una página de búsqueda puede buscar en
todos los recursos posibles, puede utilizarse un asterisco, "*".
- showScopeSection: si falta este atributo o está establecido en
"false", la sección del ámbito no se mostrará en el diálogo
Buscar. Para ver la sección del ámbito, hay que establecer este atributo en
"true". Los conectores que añaden una página de búsqueda propia y
pretenden que se vea la sección del ámbito tienen que añadir este atributo al
correspondiente archivo plugin.xml.
- enabled: si falta este atributo o está establecido en
"false", la página no se mostrará en el diálogo
Buscar. El usuario puede activar la página
por medio del botón "Personalizar..." situado en el diálogo Buscar.
Ejemplos: a continuación figura un ejemplo de definición de extensión de página de búsqueda:
<extension point="org.eclipse.search.searchPages">
<page
id="org.eclipse.search.ui.text.TextSearchPage"
label="Búsqueda 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>
Implementación suministrada: la infraestructura de búsqueda
proporciona una página de búsqueda para buscar en la totalidad del texto.