Expresiones booleanas y filtros de acciones

Cuando un conector aporta una acción a la UI del entorno de trabajo mediante uno de los puntos de extensión de menú, puede especificar las condiciones que deben darse para que el elemento de menú quede habilitado (o visible) en el menú.  Además de suministrar condiciones simples de habilitación, como la cuenta de selecciones y las clases de selección, los conectores pueden emplear expresiones booleanas para habilitar la acción o hacerla visible.

Expresiones booleanas

Las expresiones booleanas pueden contener operadores booleanos simples (NOT, AND, OR) y expresiones predefinidas que pueden evaluar las siguientes condiciones:

Por ejemplo, los siguientes fragmentos de código representan expresiones de habilitación que se podrían usar en una acción hipotética de un conjunto de acciones:

<action id="org.eclipse.examples.actionEnablement.class" 
       label="Elemento rojo" 
       menubarPath="additions" 
       class="org.eclipse.examples.actionEnablement.ObjectTestAction"> 
       <enablement> 
	 <and>
	   <objectClass name="org.eclipse.examples.actionEnablement.TestElement"/> 
           <objectState name="name" value="red"/> 
	 </and>
       </enablement> 
        </action> 
<action id="org.eclipse.examples.actionEnablement.property" 
       label="Propiedad"
       menubarPath="additions" 
       class="org.eclipse.examples.actionEnablement.PropertyTestAction"> 
       <enablement> 
           <systemProperty name="MyTestProperty" value="puppy"/> 
       </enablement> 
        </action> 
<action id="org.eclipse.examples.actionEnablement.pluginState" 
       label="Instalado" 
       menubarPath="additions" 
       class="org.eclipse.examples.actionEnablement.PluginTestAction"> 
       <enablement> 
           <pluginState id="x.y.z.anotherPlugin" value="installed"/> 
       </enablement> 
        </action> 

Consulte la documentación de los puntos de extensión que se indican más abajo para obtener ejemplos más elaborados de estas expresiones y una descripción completa de los códigos XML.

En la siguiente tabla figuran los puntos de extensión que contribuyen con acciones; en ella se da un resumen de cómo se utilizan los atributos y las expresiones booleanas de los códigos XML para aplicar la habilitación.

Nombre del punto de extensión

Atributos que afectan a la habilitación

Expresiones booleanas

viewActions,

editorActions,

actionSets

enablesFor: especifica la cuenta de selecciones que se debe cumplir para que se habilite la acción.

selection class: clase que los objetos seleccionados deben implementar (o de la que deben ser una subclase) para que se habilite la acción.

selection name: filtro comodín que se puede aplicar a los objetos de la selección.

visibility: expresión booleana.  Controla si la opción es visible en el menú.

enablement: expresión booleana.  Controla si la opción está habilitada en el menú.  Para que se aplique la expresión de habilitación, primero deben satisfacerse el atributo enablesFor y selection class y name.

popupMenus

(Solo para las contribuciones de objeto)

objectClass: especifica la clase que los objetos de la selección deben implementar (o de la que deben ser una subclase).

(Para las contribuciones de objeto y de visor)

enablesFor: especifica la cuenta de selecciones que se debe cumplir para que se habilite la acción.

selection class: clase que los objetos seleccionados deben implementar (o de la que deben ser una subclase) para que se habilite la acción.

selection name: filtro comodín que se puede aplicar a los objetos de la selección.

 

(Para las contribuciones de objeto y de visor)

visibility: expresión booleana.  Controla si la opción es visible en el menú.

enablement: expresión booleana.  Controla si la opción está habilitada en el menú.  Para que se aplique la expresión de habilitación, primero deben satisfacerse el atributo enablesFor y selection class y name.

Copyright IBM Corporation y otros 2000, 2003.