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 page EMPTY>
<!ATTLIST page
id CDATA
#REQUIRED
label CDATA #REQUIRED
class CDATA #REQUIRED
icon CDATA #IMPLIED
sizeHint CDATA #REQUIRED
tabPosition CDATA #IMPLIED
extensions CDATA #IMPLIED
showScopeSection CDATA #IMPLIED
enabled CDATA #IMPLIED
>
- 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 que implementa
org.eclipse.search.ui.ISearchPage. Le recomendamos que cree 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 no se especifica tabPosition para una página, se utilizará
Integer.MAX_VALUE / 2.
- La página que tenga el valor más bajo estará en primer
lugar. Si los valores son idénticos, las páginas se ordenan alfabéticamente
según sus etiquetas.
-
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á inicialmente 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: El siguiente es un ejemplo de la definición de
extensión de una 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.