Con el control Marcador de posición puede añadir una plantilla de control a una página o a una plantilla de control. Consulte la sección Plantillas de control para más información sobre cómo trabajar con las plantillas de control y los marcadores de posición.
Eventos de marcadores de posición
No existen eventos asociados al control Marcador de posición.
Propiedades del control Marcador de posición
Las propiedades del control se pueden editar y consultar en el panel Estilos y propiedades y se describen en este apartado por orden de aparición en el panel.
Se utiliza para hacer referencia al control desde otras partes de la página o del proyecto. Haga doble clic dentro del campo de valor para editar esta propiedad.
|
Haga clic en el botón Examinar para abrir el cuadro de diálogo "Acciones". Aquí puede configurar qué acciones se llevan a cabo cuando se desencadena un evento del control. Los eventos del control están predefinidos y el cuadro de diálogo ofrece una pestaña para cada uno de ellos. En el panel izquierdo del cuadro de diálogo está la biblioteca de acciones. Desde aquí puede arrastrar una acción hasta la pestaña del evento correspondiente. Después puede definir las propiedades de la acción elegida. Por cada evento puede configurar varias acciones, que se ejecutarán en el orden en el que aparecen, de arriba a abajo.
Una vez definidas, las acciones del control se pueden editar en cualquier momento (haciendo clic en el botón Examinar de la propiedad). También puede acceder a un evento del control haciendo clic con el botón derecho del ratón en el control y seleccionando el evento en el menú contextual que aparece.
|
Una expresión XPath que debe dar como resultado true() o false(). Si da como resultado false(), entonces el control no estará visible. Si la expresión da como resultado true() o devuelve algún otro valor, entonces el control estará visible. El valor predeterminado es true(). Haga doble clic en el campo de valor o clic en el botón XPath para escribir o editar la expresión XPath. Esta propiedad se puede usar para presentar en pantalla un objeto visible dependiendo de si la expresión XPath da como resultado true(). Es decir, la presentación en pantalla del objeto se puede configurar de forma dinámica, según el contenido o la estructura de los datos.
Nota: para más información sobre la visibilidad de columnas/filas distribuidas consulte la sección Propiedades de tabla.
Nota: la variable $MTControlValue no se puede usar para evaluar la propiedad Visible. Si la utiliza se producirá un error de validación.
|
Selecciona la plantilla de control que instancia este control Marcador de posición. La lista desplegable del campo de valores de la propiedad muestra todas las plantillas de control que se hayan definido en el diseño hasta ese momento. También puede usar una expresión XPath para seleccionar una plantilla de control. Esta expresión XPath debe evaluar en el nombre de una plantilla de control del diseño. Usar expresiones XPath permite seleccionar plantillas de forma condicional. Puede consultar un ejemplo en el apartado Proyectos de ejemplo.
Cuando selecciona una plantilla de control, sus parámetros aparecen como subpropiedades de la propiedad Plantilla de control (imagen siguiente). Introduzca expresiones XPath para seleccionar o generar los valores de los parámetros. El nodo de contexto de las expresiones será el nodo de contexto del control Marcador de posición cuando se procese el control. El nodo de contexto para evaluar los parámetros y las variables no se ve afectado por la propiedad Contexto XPath del control (véase más abajo).
Si usa una expresión XPath para seleccionar una plantilla de control, entonces esa plantilla no se selecciona hasta el momento de ejecución, cuando se evalúa la expresión. Como la plantilla de control no se conoce en el momento del diseño, en el panel no aparece ningún parámetro. En lugar de la lista de parámetros aparece la propiedad Parámetros de la plantilla. Puede introducir una expresión XPath para generar los valores de los parámetros previstos. Esa expresión debe ser una expresión de matriz o de asignación. Si usa una expresión de matriz debe suministrar los valores de los parámetros en una secuencia que siga el mismo orden que el de la definición de parámetros de la plantilla de control; además, no se pueden omitir los parámetros opcionales. Consulte Proyectos de ejemplo para ver ejemplos de este tipo de expresiones.
|
La propiedad Plantilla de control proporciona los valores de los parámetros para la plantilla de control seleccionada en el marcador de posición de la propiedad de control Plantilla de control.
En la propiedad Parámetros de plantillas puede introducir una expresión XPath para generar los valores de los parámetros previstos. Esa expresión debe ser una expresión de matriz o de asignación. Si usa una expresión de matriz debe suministrar los valores de los parámetros en una secuencia que siga el mismo orden que el de la definición de parámetros de la plantilla de control; además, no se pueden omitir los parámetros opcionales. (En el caso de las asignaciones las claves permiten asignar correctamente los valores.) Consulte los proyectos de ejemplo de las plantillas de control para ver ejemplos de estas expresiones.
|
Esta propiedad se usa para cambiar el nodo de contexto de expresiones XPath que se evalúan en la plantilla de control que instancia el control Marcador de posición. La plantilla de control instanciada es la plantilla que se nombra en la propiedad Plantilla de control (véase más arriba).
Tenga en cuenta estos puntos:
•el contexto en que se evalúan las expresiones XPath de los valores de los parámetros la plantilla es el nodo de contexto del control Marcador de posición (no el nodo de contexto cambiado).
•las expresiones XPath que generan los valores de las variables de la plantilla, en cambio, se evalúan en el contexto indicado por esta propiedad (Control XPath Context). Si no se define ningún valor para esta propiedad, entonces los valores de las variables también se evalúan usando el nodo de contexto del control Marcador de posición.
|