Botón

www.altova.com Expandir/Contraer todos Imprimir este apartado Página anterior Subir un nivel Página siguiente

Inicio >  Controles y eventos de control > Controles >

Botón

Los controles Botón sirven para ejecutar una acción cuando se hace clic en el botón. El nombre del botón puede ser texto estático (el valor de la propiedad Texto) o un valor dinámico que se obtiene de un nodo de la fuente de página (arrastrando el nodo hasta el botón). También puede, como alternativa o adicionalmente, seleccionar un icono en la lista desplegable de la propiedad Imagen del botón. La altura del botón la determinan (i) la altura del icono o el texto del botón, el mayor de los dos, y (ii) el relleno vertical aplicado al botón. El evento AlHacerClicEnBotón está asociado al control Botón. Para definir una acción para este evento haga clic en el botón Examinar de la propiedad Acción de control. Esto abre el cuadro de diálogo "Acciones para el control", donde puede especificar qué acción debe llevarse a cabo.

 

Haga clic para expandir/contraerNotas
Cuando el control se asocia con un nodo de la fuente de datos (vínculo con la fuente de página), al pasar el cursor por el control (en la vista Diseño de páginas) aparece el nodo asociado.
Todos los vínculos con fuentes de página de la estructura de fuentes de página aparecen en negrita. Los nodos de la estructura que no son vínculos de fuente de página no están en negrita.
Al pasar el cursor por el vínculo con la fuente de página en la estructura del diseño aparece información sobre el control asociado.
Para eliminar una asociación con el nodo de la fuente de datos (y por tanto los datos del control) haga clic con el botón derecho en el control (en la vista Diseño de páginas) y haga clic en Eliminar vínculo con la fuente de la página.
Para restaurar un estilo o una propiedad (en el panel Estilos y propiedades), seleccione el estilo/la propiedad y haga clic en Restaurar en la barra de herramientas del panel.
Los valores de varias propiedades se pueden configurar usando expresiones XPath. Así podrá utilizar valores dinámicos, es decir, valores calculados o tomados de los nodos de la fuente de datos en tiempo de ejecución. Para crear una expresión XPath, haga clic en el botón Editar XPath de la barra de herramientas del panel Estilos y propiedades.
Para editar la expresión XPath de un estilo o de una propiedad (en el panel Estilos y propiedades), seleccione el estilo/la propiedad y haga clic en el botón Editar XPath de la barra de herramientas del panel.
Para copiar un control y pegarlo en otra ubicación del diseño, pulse Ctrl mientras arrastra el control hasta su nueva posición.
Para asignar propiedades a un control, defina clases para el control (con la propiedad Clase CSS del explorador) y después asigne reglas a las clases en un archivo CSS externo (que se elije en el cuadro de diálogo Configuración del explorador).
Las propiedades CSS de los controles se pueden definir en el panel Estilos y propiedades y en archivos CSS externos, pero las que se definan en el panel Estilos y propiedades tienen prioridad.

 

Eventos de controles Botón

Los botones pueden usar el evento AlHacerClicEnBotón. Para definir acciones para este evento haga clic con el botón derecho en el botón y elija Acciones de control para AlHacerClicEnBotón... en el menú contextual. Esto abre el cuadro de diálogo "Acciones para el botón". Para obtener más información sobre las diferentes acciones que puede definir para este evento consulte la sección Acciones.

 

Haga clic para expandir/contraerAlHacerClicEnElBotón (al hacer clic, al hacer clic largo)

El usuario final puede hacer clic en el control de dos maneras: un clic corto (Al hacer clic) y un clic largo (Al hacer clic largo). Por cada tipo de clic puede definir una secuencia diferente de acciones (imágenes siguientes a la izquierda y en el medio). La secuencia que se ejecutará depende del tipo de clic que utilice el usuario final. Además, después de estas acciones se puede lleva a cabo una secuencia de acciones adicional. Esta secuencia adicional debe colocarse después del evento Al hacer clic largo (imagen siguiente a la derecha).

MTDActionOnClick   MTDActionOnLongClick   MTDActionOnClickOnLongClick

Al hacer clic: acciones que se deben llevar a cabo cuando se hace clic en el control (primera imagen).
Al hacer clic largo: acciones que se deben llevar a cabo cuando se hace clic largo en un control (segunda imagen).
Secuencia de acciones adicional: acciones que se deben llevar a cabo después de que se ejecuten las acciones de Al hacer clic y Al hacer clic largo (tercera imagen). Si no define ninguna acción para Al hacer clic ni para Al hacer clic largo, entonces las acciones adicionales se llevan a cabo directamente cuando se haga clic o clic largo.

 

También puede utilizar combinaciones de acciones con los dos tipos de clic. El ejemplo de la imagen siguiente muestra cómo hacerlo con el evento Botón, pero funciona igual para el resto de controles.

MTDActionOnClickMultiple

En el control del ejemplo cada evento de clic tiene definida una secuencia de acciones. Además, después del evento Al hacer clic largo se definió el evento CuadroDeMensaje. Este CuadroDeMensaje se ejecutará cuando finalice la secuencia de acciones de Al hacer clic y Al hacer clic prolongado.

 

Al pulsar Entrar/Escape

Si la casilla del control Al pulsar Entrar o Al pulsar Escape está seleccionada, entonces las acciones del control se ejecutan cuando se pulsa la tecla correspondiente (Entrar o Escape). Pulsar una de estas teclas es una alternativa a los eventos Al hacer clic y se puede usar además del clic. La imagen siguiente muestra las casillas Al pulsar Entrar y Al pulsar Escape del control Botón. Esta opción tiene un aspecto parecido y funciona de forma similar con otros controles.

 

MTDOnEnterEscapeCheckBoxes

 

También se puede acceder a esta configuración desde la propiedad Al pulsar Entrar/Escape del control, que explicamos más abajo.

 

Nota:        si selecciona el comando de menú Página | Mostrar/Definir orden de tabulación, entonces los controles que se hayan asignado para cuando se pulsen las teclas Entrar o Escape estarán identificados con un símbolo de la tecla correspondiente.

 

Nota:   esta característica está disponible en clientes web y Windows, así como en simulaciones en todos los clientes.

 

 

Propiedades del control Botó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.

 

Click to expand/collapseNombre

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 para expandir/contraerTexto

Estos son los valores que puede tomar esta propiedad:

 

Una cadena de texto de valor fijo que aparecerá en el control.
Una expresión XPath que recupera datos de un nodo de una fuente de página y muestra estos datos en el control.

 

Haga doble clic dentro del campo de edición para editar el texto o haga clic en el botón XPath de la barra de herramientas para introducir una expresión XPath y generar el texto necesario. También puede hacer clic con el botón derecho en la propiedad y elija el método preferido en el menú contextual).

 

Nota:  en el control Texto enriquecido puede introducir una expresión XPath que sea una cadena cifrada en HTML. Si se han definido estilos para elementos HTML en la hoja de estilos Texto enriquecido activa, entonces el valor de texto de esta propiedad se mostrará con el formato apropiado. Consulte el apartado Texto enriquecido para más información.

 

Nota:  la variable $MTControlValue no se puede utilizar para generar el valor de la propiedad Texto. Si la utiliza se producirá un error de validación.

 

Haga clic para expandir/contraerMultilínea

Activa o desactiva la entrada/presentación de texto multilínea (true/false). El valor predeterminado es false.

 

Nota

si esta propiedad está definida como true y si el Ajuste automático del tamaño del texto está habilitado, entonces el texto no ocupará varias líneas; sin embargo, los saltos de línea que haya en el texto sí crearan distintas líneas.
si esta propiedad está definida como true en un control etiqueta, entonces se habilita la propiedad Número máximo de líneas.

 

Haga clic para expandir/contraerCadena de formato de número

Haga clic en el botón Examinar y escriba un formato de número en el cuadro de diálogo que aparece (imagen siguiente).

MTPCNumberFormatString

El formato se aplicará al contenido del control si se trata de contenido numérico y solamente aparecerá en la solución, no en el diseño.

 

Haga clic para expandir/contraerCadena de formato de fecha/hora

Haga clic en el botón Examinar y escriba un formato de fecha, hora o fecha/hora en el cuadro de diálogo que aparece (imagen siguiente).

MTPCDateTimeFormat

El formato elegido se aplicará al contenido del control siempre que tenga el formato léxico correcto de xs:date (para el control Fecha), xs:time (para el control Hora) o xs:dateTime (para los controles Fecha, Hora y FechaHora). Ejemplos básicos son:

 

xs:date: 2014-12-31
xs:time: 23:59:59
xs:dateTime: 2014-12-31T23:59:59

 

Haga clic para expandir/contraerIdioma para formato fecha/hora

Seleccione uno de los idiomas compatibles en la lista desplegable (EN, DE, ES, FR, JA). El idioma seleccionado se utilizará en el formato de la fecha/hora seleccionado en la propiedad Cadena de formato de fecha/hora (ver descripción más arriba). Si se utilizan meses y días de la semana en la cadena de formato, estos aparecerán en el idioma seleccionado en esta propiedad. El idioma predeterminado es inglés.

 

Clic para expandir/contraerImagen del botón

Añade un icono predefinido o una imagen personalizada para visualizar el botón. También puede añadir (en la propiedad Texto) una cadena de texto que aparezca junto a la imagen del botón. Si usa imagen y texto, entonces la propiedad Posición de la imagen del botón indica si el icono se sitúa a la izquierda o a la derecha del texto. La posición horizontal del par icono-texto dentro del botón se indica con la propiedad Alineación horizontal.
 
Para añadir un icono predefinido seleccione uno en la lista desplegable del cuadro combinado de la propiedad. Los iconos disponibles son: Más, Menos, Mayor que, Compartir, Calendario, Eliminar, Editar, Correo electrónico, Exportar, Avance rápido, Retroceso rápido, Importar, Micrófono, Pausa, Reproducir, Reproducir hacia atrás, Imprimir, Continuar, Buscar, Stop y Hora.

 

Para añadir una imagen personalizada seleccione Imagen personalizada. Al hacer esto se habilitan dos propiedades: Fuente de imagen y Tipo de fuente de imagen (véanse las descripciones a continuación).
 
El valor predeterminado de la propiedad Imagen del botón es no usar ningún icono.
 
Cuando se añade un icono predeterminado o una Imagen personalizada para el botón se habilitan las propiedades Color de fondo del botón y Posición de imagen del botón. Estas propiedades permiten definir (i) un fondo transparente o no transparente para el botón y (ii) la posición horizontal del icono en relación al texto del botón.

 

Clic para expandir/contraerColor de fondo del botón

Indica si el fondo del botón es transparente o no. El valor predeterminado es non-transparent.

 

Clic para expandir/contraerPosición de la imagen del botón

Indica si la imagen del botón (icono predefinido o imagen personalizada) se encuentra a la izquierda o a la derecha del texto del botón (que se indica con la propiedad Texto). El valor predeterminado es left of text.

 

Haga clic para expandir/contraerFuente de imagen

El valor de esta propiedad remite a una imagen de varias maneras:

 

La URL de un archivo de imagen binario (PNG, BMP, etc.). El valor de la propiedad debe ser una URL que se selecciona en el cuadro de diálogo "Especificar archivo" (imagen siguiente).
Un archivo de imagen representado como cadena de texto codificada en base64. El valor de la propiedad debe ser una cadena de texto codificada en base64. La cadena viene dada por una expresión XPath y se puede introducir directamente o se puede obtener de un nodo XML.

 

El tipo de fuente de imagen viene dado por la propiedad Tipo de fuente de imagen (ver siguiente propiedad). El valor predeterminado de esta propiedad es url. La propiedad Fuente de imagen abre automáticamente el cuadro de diálogo correspondiente: "Especificar archivo" para url o "Editar expresión XPath/XQuery" para base64 (consulte el apartado Imágenes codificadas en base64).

 

Nota:   si la fuente de imagen es una URL y la URL se cambia durante la simulación o mientras se ejecuta la solución, entonces la imagen se debe recargar de forma explícita con la acción Volver a cargar. Por ejemplo, si cambia la selección en un cuadro combinado para cambiar la selección de imagen, entonces se debe definir una acción Volver a cargar en el cuadro combinado.

 

Aquí puede elegir un archivo del servidor o del cliente. Seleccione el botón de opción que corresponda.

 

El archivo reside en el servidor

Si el archivo de imagen reside en el servidor, puede buscar su ubicación (Ruta de acceso absoluta o relativa) o especificar el archivo a través de un recurso global (Alias del archivo o Alias de la carpeta).

MTDImageFileLoadSaveServer

Ruta de acceso absoluta/relativa: puede introducir una ruta de acceso, buscar el archivo o introducir una expresión XPath que genere la ruta de acceso del archivo. Con el botón Restaurar puede quitar la entrada actual. La ruta de acceso puede ser relativa al archivo de diseño o absoluta. Si el archivo se implementa en el servidor junto con el archivo de diseño, entonces la ruta de acceso relativa/absoluta especificada en el cuadro de diálogo se utilizará de forma interna (en la base de datos del servidor) para acceder al archivo. Si por el contrario el archivo no se implementa, entonces debe almacenarse en un directorio del servidor. En este caso: (i) si selecciona una ruta de acceso relativa en el cuadro de diálogo "Especificar archivo", entonces en tiempo de ejecución la ruta de acceso relativa se resolverá en el servidor con referencia al directorio de trabajo (definido en la configuración de MobileTogether Server); (ii) si selecciona una ruta de acceso absoluta, entonces la carpeta que contiene el archivo en el servidor debe ser una carpeta descendiente del directorio de trabajo. Consulte el apartado Ubicación de los archivos de proyecto para obtener más información. Cuando se trate de guardar archivos, tendrá la opción de especificar una extensión de archivo predeterminada, que se usará si no se especifica ninguna extensión en el nombre de archivo.

 

Crear subcarpetas automáticamente cuando se guarde el archivo: si en la ruta de acceso del archivo del servidor faltan carpetas intermedias, MobileTogether Designer creará estas carpetas cuando el archivo se guarde. Esta opción solamente es relevante a la hora de guardar datos. Si la acción se limita a la carga de archivos, esta opción no aparece.

 

Alias del archivo de recurso global: seleccione un alias de archivo de la lista de alias del cuadro combinado. Los alias de archivo disponibles en este cuadro combinado se toman del archivo de definiciones de recursos globales. Cada alias de archivo apunta a diferentes recursos de archivo dependiendo de la configuración que esté activa en MobileTogether Designer (la configuración activa se selecciona con Herramientas | Configuración activa). Consulte la sección Recursos globales de Altova para obtener más información.

 

 

Alias de carpeta de recurso global con fragmento de ruta: seleccione un alias de carpeta de la lista de alias de carpeta del cuadro combinado (imagen siguiente).
MTDSpecifyFileGRFolderAliases
 

Los alias de carpeta disponibles en este cuadro combinado se toman del archivo de definiciones de recursos globales. Cada alias de carpeta apunta a diferentes recursos de carpeta dependiendo de la configuración que esté activa en MobileTogether Designer (la configuración activa se selecciona con Herramientas | Configuración activa). Consulte la sección Recursos globales de Altova para obtener más información.

 

 

El archivo reside en el cliente

Si el archivo de imagen reside en el cliente, especifique su ruta de acceso escribiendo o seleccionando su ubicación. También puede generar la ruta de acceso con ayuda de una expresión XPath. Para quitar la entrada actual haga clic en el botón Restaurar.

MTDImageFileLoadSaveClient

El archivo que se debe cargar/guardar puede ser especificado por el diseñador de la solución o por el usuario final. Si lo hace el diseñador, la información se almacena en la solución y el archivo se cargará/guardará cuando la acción se desencadene. Si por el contrario permite al usuario final seleccionar qué archivo se debe cargar/guardar, entonces cuando la acción se desencadene se abrirá un cuadro de diálogo en el dispositivo cliente y el usuario podrá indicar/seleccionar qué archivo se carga/guarda.

 

Nota: la opción para permitir que el usuario final seleccione qué archivo se carga/guarda está disponible en estas acciones: Imprimir en (opciones Archivo de origen y Archivo de destino), Cargar o guardar archivo, Cargar o guardar imagen y Cargar o guardar archivo binario.

 

Nota: los archivos que residen en el cliente también se pueden guardar en una tarjeta SD en el dispositivo móvil.

 

El nombre de archivo se define aquí (por el diseñador de la solución)

 

Extensión de archivo predeterminada opcional: cuando se trate de guardar archivos, tendrá la opción de especificar una extensión de archivo predeterminada, que se usará si no se indica ninguna extensión en el nombre del archivo.

 

Crear subcarpetas automáticamente cuando se guarde el archivo: si en la ruta de acceso del archivo del dispositivo cliente faltan carpetas intermedias, MobileTogether Designer creará estas carpetas cuando el archivo se guarde. Esta opción solamente es relevante a la hora de guardar datos. Esta opción no aparece si se trata de una acción de carga de archivos.

 

Directorios según el dispositivo: seleccione el directorio del dispositivo en la lista desplegable. En Windows Phone/RT y iOS los directorios permitidos están predefinidos. En dispositivos Android, además de los directorios de la lista desplegable del cuadro combinado Android, puede introducir la carpeta que usted quiera. En Android y Windows Phone/RT, si selecciona la opción Predet. (selección predeterminada), se selecciona el directorio del entorno de pruebas de la aplicación MobileTogether. En dispositivos iOS MobileTogether crea dos directorios: (i) un Directorio con copia de seguridad para los archivos que se guardan en el iCloud y que se pueden volver a descargar y (ii) un Directorio sin copia de seguridad para los archivos que no necesitan copia de seguridad. Seleccione la opción correspondiente en la lista desplegable. En exploradores web la ubicación de los archivos es relativa al entorno de pruebas del explorador.

 

Ubicaciones de archivo para simulaciones: como los archivos situados en el cliente no estarán disponible durante la simulación, puede especificar qué carpeta hará las funciones de carpeta cliente durante las simulaciones. Obviamente los archivos que estén en esta carpeta deben llamarse como lo archivos especificados en el diseño. Esta carpeta se especifica en la pestaña Simulación del cuadro de diálogo "Opciones" (Herramientas | Opciones).

 

Nota: en los clientes web los archivos se guardan temporalmente en el servidor y se eliminan cuando termina la sesión del servidor. Una sesión de servidor termina después de un periodo definido de inactividad; este periodo se define en la opción Sesiones, el panel Varios de la pestaña Configuración del servidor (véase el manual de usuario de MobileTogether Server).

 

El nombre de archivo se define por el usuario final (en el dispositivo cliente)

 

Extensión de archivo predeterminada opcional: cuando se trate de guardar archivos, tendrá la opción de especificar una extensión de archivo predeterminada, que se usará si no se indica ninguna extensión en el nombre del archivo.

 

Filtro de archivo opcional: el cuadro de diálogo que aparece en el dispositivo cliente filtrará los tipos de archivo que se pueden cargar/guardar de modo que el usuario solamente pueda seleccionar las extensiones de archivo definidas aquí. Puede introducir: (i) una lista de extensiones separadas por comas o puntos y comas (p. ej. txt,html;xml) o (ii) una expresión XPath que devuelva una secuencia de cadenas, donde cada cadena equivale a una extensión de archivo (p. ej. 'txt','html,'xml').

 

Archivo predeterminado opcional: aquí puede introducir un nombre de archivo predeterminado, directamente o con una expresión XPath. Este nombre predeterminado servirá de guía al usuario.

 

Cuadro de mensaje web: antes de que se abra el cuadro de diálogo "Abrir/Guardar archivo", aparecerá un cuadro de mensaje. Aquí puede introducir el texto que aparecerá en lugar del texto predeterminado en este cuadro de mensaje. Puede introducir el texto directamente o con una expresión XPath.

 

Crear subcarpetas automáticamente cuando se guarde el archivo: si en la ruta de acceso del archivo del dispositivo cliente faltan carpetas intermedias, MobileTogether Designer creará estas carpetas cuando el archivo se guarde. Esta opción solamente es relevante a la hora de guardar datos. Esta opción no aparece si se trata de una acción de carga de archivos.

 

Nota:  en dispositivos iOS permitir al usuario que seleccione el archivo solo funciona como importación/exportación en iCloud. Los usuarios no tienen permiso para examinar la carpeta con copia de seguridad ni la carpeta sin copia de seguridad.

 

Haga clic para expandir/contraerTipo de fuente de imagen

Establece el tipo de imagen que selecciona la propiedad Fuente de imagen. Hay dos opciones:

 

url: un archivo de imagen binario (p. ej. PNG o BMP)
base64: una cadena de texto codificada en base64

 

Valor predeterminado: url.

 

Haga clic para expandir/contraerAcción de control

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.

 

Haga clic para expandir/contraerVisible

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.

 

Haga clic para expandir/contraerHabilitado/Editable

El control se habilita o se puede editar dependiendo del valor de esta propiedad: true (habilitado) o false (deshabilitado). El valor se puede introducir directamente (seleccionándolo en el cuadro combinado o haciendo doble clic en el campo de valor e introduciendo el valor deseado). El valor también puede ser una expresión XPath que dé como resultado true o false. Por lo general la expresión XPath de esta propiedad comprobará la presencia o el valor de un nodo. Si la expresión da como resultado true, el control se habilitará.

 

Haga clic para expandir/contraerColor del texto

Define el color del texto del control cuando éste está habilitado. El color se puede seleccionar de varias formas:

 

Haciendo clic en la paleta de colores.
Seleccionando un color en la lista desplegable del cuadro combinado.
Haciendo doble clic en el campo de valor e introduciendo un código de color (p. ej. #FF0000) o haciendo clic en el botón XPath de la barra de herramientas e introduciendo una expresión XPath para generar el código del color.

 

Nota: los controles pueden habilitarse o deshabilitarse en función del contexto. Por ejemplo, si en un formulario sobre datos personales, a la pregunta de si tiene un seguro de vida, el usuario contesta afirmativamente, entonces se pueden habilitar los campos donde debe introducir los datos sobre el seguro de vida. De lo contrario, estos campos estarán deshabilitados. Para habilitar/deshabilitar un campo, use la propiedad Habilitado/Editable del correspondiente control. Para establecer el color del texto del control cuando éste está deshabilitado use la propiedad Color del texto (Deshabilitado).

 

Haga clic para expandir/contraerColor del texto (Deshabilitado)

Define el color del texto del control cuando éste está deshabilitado. El color se puede seleccionar de varias formas:

 

Haciendo clic en la paleta de colores.
Seleccionando un color en la lista desplegable del cuadro combinado.
Haciendo doble clic en el campo de valor e introduciendo un código de color (p. ej. #FF0000) o haciendo clic en el botón XPath de la barra de herramientas e introduciendo una expresión XPath para generar el código del color.

 

Nota: los controles pueden habilitarse o deshabilitarse en función del contexto. Por ejemplo, si en un formulario sobre datos personales, a la pregunta de si tiene un seguro de vida, el usuario contesta afirmativamente, entonces se pueden habilitar los campos donde debe introducir los datos sobre el seguro de vida. De lo contrario, estos campos estarán deshabilitados. Para habilitar/deshabilitar un campo, use la propiedad Habilitado/Editable del correspondiente control. Para establecer el color del texto del control cuando éste está habilitado use la propiedad Color del texto.

 

Haga clic para expandir/contraerTamaño del texto

Seleccione un tamaño de la lista desplegable del cuadro combinado. Los valores permitidos son: smallest|small|medium|large|largest. Cada plataforma o dispositivo tiene definido el alto en píxeles por cada tamaño literal. De modo que el tamaño del texto predeterminado en píxeles es el alto en píxeles propio del cliente que corresponda al valor medium.

 

También puede generar otros valores con la función mt-font-height. Por ejemplo, para obtener un tamaño que sea un 120 por ciento mayor que el tamaño numérico que corresponde al valor literal largest del dispositivo, utilice esta expresión XPath: mt-font-height('largest', 'px') * 1.2. Esta función genera el valor numérico (en píxeles) que corresponde al tamaño largest. Después multiplica este valor por 1.2 para obtener el valor numérico que sea un 120 por ciento del valor que corresponde a largest.

 

Si introduce valores en píxeles para las propiedades que definen la longitud de un control, debe tener en cuenta que en dispositivos iOS estos valores se leerán como puntos del espacio de coordenadas del área de visualización. El espacio de coordenadas del área de visualización es el lienzo donde se dibujan los componentes de diseño y un punto es la unidad de longitud en este espacio (es decir, aquí los puntos no equivalen a la unidad tipográfica igual a 1/72 de una pulgada). El dispositivo iOS asigna automáticamente puntos del espacio de coordenadas del área de visualización a píxeles del espacio de coordenadas del dispositivo. Al asignar los valores de esta manera (de valores del área de visualización a valores del dispositivo) garantiza que los componentes de diseño conserven la misma relación de tamaño tanto con el lienzo como entre ellos, independientemente de la resolución del dispositivo iOS o de qué unidades se usen.

 

En MobileTogether Designer puede utilizar las variables dinámicas $MT_CanvasX y $MT_CanvasY para averiguar las dimensiones del área de visualización (lienzo de dibujo) actual y obtener así distancias relativas a esas dimensiones. Para dispositivos iOS las variables devuelven valores que se calculan de esta manera: las dimensiones en píxeles del espacio actual de coordenadas del dispositivo se convierten (usando un factor de conversión apropiado) en valores de puntos del espacio de coordenadas del área de visualización. Las variables devuelven estos valores de puntos en píxeles para utilizarlos en el diseño. Por ejemplo, si desea que una imagen sea la mitad del ancho del área de visualización, basta con asignarle un ancho en píxeles igual a $MT_CanvasX * 0.5; la expresión XPath para el ancho de esta imagen sería concat($MT_CanvasX * 0.5, 'px').

 

Clic para expandir/contraerAjuste automático del tamaño del texto

Determina si el tamaño del texto debe reducirse para ajustarse al ancho del control. Los valores de la propiedad son:

 

Off (el tamaño del texto no se ajusta automáticamente; es el valor predeterminado)
Puntos suspensivos (añade puntos suspensivos al final del texto visible del control si el texto es demasiado largo para mostrarlo por completo)
Individualmente (solo se ajustará automáticamente el tamaño del texto de este control)
Grupo X (donde X=1 a 9). Puede agregar un control a uno de los nueve grupos de ajuste automático del tamaño del texto (cada grupo está identificado con un número de 1 al 9). El tamaño del texto de todos los controles de un grupo se ajustará automáticamente al del control que tenga el texto de menor tamaño. Esto garantiza que un conjunto de controles tenga un tamaño de texto homogéneo y adecuado sin que tenga que ir probando hasta encontrar el tamaño ideal.
 

En la vista Diseño el texto puede reducirse como mucho al 50% del tamaño de la fuente, incluso aunque el tamaño del ajuste automático sea menor. En tiempo de ejecución, sin embargo, sí se mostrará el tamaño establecido en la propiedad de ajuste automático-

 
Notas

si la propiedad Multilínea está definida en true, entonces: (i) si el ajuste automático está deshabilitado, el texto ocupará varias líneas; (ii) si el ajuste automático está habilitado, el texto se adaptará al espacio y no abarcará varias líneas; no obstante, los saltos de línea que contenga el texto sí crearán líneas distintas.
esta propiedad no se puede habilitar si se ha definido la propiedad de etiqueta Número máximo de líneas. Debe elegir entre definir un número máximo de líneas o dejar que el tamaño del texto se ajuste automáticamente.
la función Ajuste automático del tamaño del texto no está disponible en clientes web.

 

Haga clic para expandir/contraerTexto en negrita

Seleccione true o false de la lista desplegable del cuadro combinado. También puede utilizar una expresión XPath. El valor predeterminado es false.

 

Haga clic para expandir/contraerTexto en cursiva

Seleccione true o false de la lista desplegable del cuadro combinado. El valor también se puede generar de forma dinámica con una expresión XPath. El valor predeterminado es false.

 

Haga clic para expandir/contraerTexto subrayado

Seleccione true o false de la lista desplegable del cuadro combinado. El valor también se puede generar de forma dinámica con una expresión XPath. El valor predeterminado es

false.

 

Haga clic para expandir/contraerColor de fondo

Define el color de fondo que tiene el objeto cuando está habilitado. El color se puede definir de varias formas:

 

haciendo clic en la paleta de colores.
seleccionando un color en la lista desplegable del cuadro combinado; para seleccionar el color de fondo del control, seleccione el elemento Color de fondo del control en el cuadro combinado.
haciendo doble clic en el campo de valor e introduciendo un código de color (p. ej. #FF0000) o haciendo clic en el botón XPath de la barra de herramientas e introduciendo una expresión XPath para generar el código del color. Para aplicar el color de fondo del control, introduzca la expresión XPath "control".

 

Nota:   para hacer que el color de fondo de la celda sea el mismo que el del control en el que se encuentra la celda, (i) seleccione Color de fondo del control en el cuadro combinado de la propiedad o (ii) introduzca la expresión XPath "control" en el campo del valor de la propiedad.

 

Nota:   los controles pueden habilitarse o deshabilitarse en función del contexto. Por ejemplo, si en un formulario sobre datos personales, a la pregunta de si tiene un seguro de vida, el usuario contesta afirmativamente, entonces se pueden habilitar los campos donde debe introducir los datos sobre el seguro de vida. De lo contrario, estos campos estarán deshabilitados. Para habilitar/deshabilitar un campo, use la propiedad Habilitado/Editable del correspondiente control. Para establecer el color de fondo que debe tener el control cuando está deshabilitado use la propiedad Color de fondo (Deshabilitado).

 

Haga clic para expandir/contraerColor de fondo (Deshabilitado)

Define el color de fondo que tiene el objeto cuando está deshabilitado. El color se puede seleccionar de varias formas:

 

Haciendo clic en la paleta de colores.
Seleccionando un color en la lista desplegable del cuadro combinado.
Haciendo doble clic en el campo de valor e introduciendo un código de color (p. ej. #FF0000) o haciendo clic en el botón XPath de la barra de herramientas e introduciendo una expresión XPath para generar el código del color.

 

Nota: los controles pueden habilitarse o deshabilitarse en función del contexto. Por ejemplo, si en un formulario sobre datos personales, a la pregunta de si tiene un seguro de vida, el usuario contesta afirmativamente, entonces se pueden habilitar los campos donde debe introducir los datos sobre el seguro de vida. De lo contrario, estos campos estarán deshabilitados. Para habilitar/deshabilitar un campo, use la propiedad Habilitado/Editable del correspondiente control. Para establecer el color de fondo que debe tener el control cuando está habilitado use la propiedad Color de fondo.

 

Haga clic para expandir/contraerAlineación horizontal

Establece la alineación horizontal a la izquierda, en el centro o a la derecha. El valor predeterminado es center. También puede configurar el valor con una expresión XPath (lo cual permite generar el valor de forma dinámica).

 

Haga clic para expandir/contraerAncho del control

Establece el ancho del control. Seleccione un valor del cuadro combinado:

 

rellenar_principal: ajusta el ancho del control al ancho del elemento principal (por ejemplo, la celda de tabla o la página donde se incluye el control).
ajuste_automático_línea: ajusta el ancho del control al contenido. Cuando se selecciona este valor, se habilita la propiedad Ancho máximo del control.
valor porcentual: un porcentaje del ancho de la página. Seleccione un valor de la lista o escriba un valor directamente.
valor en píxeles: seleccione un valor en píxeles de la lista desplegable o escriba un valor directamente.

 

En efecto, fill_parent genera el ancho máximo, mientras que wrap_content crea el ancho mínimo.

 

El valor predeterminado para todos los controles es fill_parent, excepto para estos:

 

Image y Chart: el valor predeterminado de estos controles es wrap_content.
Geolocation Map: el valor predeterminado es el menor de los valores de $MT_CanvasX y $MT_CanvasY. Estas dos variables dinámicas dan, respectivamente, el ancho y el alto del área de visualización del dispositivo. El valor predeterminado de ambos controles es el mismo (en ambos casos, el menor de los valores de $MT_CanvasX y $MT_CanvasY), por lo que el área de visualización del control siempre será un cuadrado cuyo lado es igual a min($MT_CanvasX, $MT_CanvasY).

 

Si introduce valores en píxeles para las propiedades que definen la longitud de un control, debe tener en cuenta que en dispositivos iOS estos valores se leerán como puntos del espacio de coordenadas del área de visualización. El espacio de coordenadas del área de visualización es el lienzo donde se dibujan los componentes de diseño y un punto es la unidad de longitud en este espacio (es decir, aquí los puntos no equivalen a la unidad tipográfica igual a 1/72 de una pulgada). El dispositivo iOS asigna automáticamente puntos del espacio de coordenadas del área de visualización a píxeles del espacio de coordenadas del dispositivo. Al asignar los valores de esta manera (de valores del área de visualización a valores del dispositivo) garantiza que los componentes de diseño conserven la misma relación de tamaño tanto con el lienzo como entre ellos, independientemente de la resolución del dispositivo iOS o de qué unidades se usen.

 

En MobileTogether Designer puede utilizar las variables dinámicas $MT_CanvasX y $MT_CanvasY para averiguar las dimensiones del área de visualización (lienzo de dibujo) actual y obtener así distancias relativas a esas dimensiones. Para dispositivos iOS las variables devuelven valores que se calculan de esta manera: las dimensiones en píxeles del espacio actual de coordenadas del dispositivo se convierten (usando un factor de conversión apropiado) en valores de puntos del espacio de coordenadas del área de visualización. Las variables devuelven estos valores de puntos en píxeles para utilizarlos en el diseño. Por ejemplo, si desea que una imagen sea la mitad del ancho del área de visualización, basta con asignarle un ancho en píxeles igual a $MT_CanvasX * 0.5; la expresión XPath para el ancho de esta imagen sería concat($MT_CanvasX * 0.5, 'px').

 

Clic para expandir/contraerAncho de control máximo

Esta propiedad solamente está disponible cuando la propiedad Ancho del control del control tiene el valor ajuste_automático_línea. La propiedad Ancho de control máximo establece el ancho máximo del control. Seleccione un valor del cuadro combinado de la propiedad. Estos son los valores disponibles:

 

valor porcentual: un porcentaje del ancho de la página. Seleccione un valor de la lista desplegable o escriba un valor directamente.
valor en píxeles: seleccione un valor en píxeles de la lista desplegable o escriba un valor directamente.

 

Haga clic para expandir/contraerMargen

Indica el margen máximo del control en relación a los objetos que lo rodean o al borde del objeto que lo contiene. Seleccione un valor en píxeles de la lista desplegable del cuadro combinado o haga doble clic en el campo del valor para escribir un valor en píxeles. La configuración definida se aplicará a los cuatro lados del control. Para definir un margen distinto para alguno de los cuatro lados, expanda la propiedad Margen para mostrar las propiedades individuales de ancho (izquierda, derecha, superior e inferior) e indique el valor deseado. Por ejemplo, si indica que el Margen es de 6px y el Margen inferior es de 12px, entonces el margen será de 6px en los lados izquierdo, derecho e inferior, y de 12px en el lado inferior.

 

Si introduce valores en píxeles para las propiedades que definen la longitud de un control, debe tener en cuenta que en dispositivos iOS estos valores se leerán como puntos del espacio de coordenadas del área de visualización. El espacio de coordenadas del área de visualización es el lienzo donde se dibujan los componentes de diseño y un punto es la unidad de longitud en este espacio (es decir, aquí los puntos no equivalen a la unidad tipográfica igual a 1/72 de una pulgada). El dispositivo iOS asigna automáticamente puntos del espacio de coordenadas del área de visualización a píxeles del espacio de coordenadas del dispositivo. Al asignar los valores de esta manera (de valores del área de visualización a valores del dispositivo) garantiza que los componentes de diseño conserven la misma relación de tamaño tanto con el lienzo como entre ellos, independientemente de la resolución del dispositivo iOS o de qué unidades se usen.

 

En MobileTogether Designer puede utilizar las variables dinámicas $MT_CanvasX y $MT_CanvasY para averiguar las dimensiones del área de visualización (lienzo de dibujo) actual y obtener así distancias relativas a esas dimensiones. Para dispositivos iOS las variables devuelven valores que se calculan de esta manera: las dimensiones en píxeles del espacio actual de coordenadas del dispositivo se convierten (usando un factor de conversión apropiado) en valores de puntos del espacio de coordenadas del área de visualización. Las variables devuelven estos valores de puntos en píxeles para utilizarlos en el diseño. Por ejemplo, si desea que una imagen sea la mitad del ancho del área de visualización, basta con asignarle un ancho en píxeles igual a $MT_CanvasX * 0.5; la expresión XPath para el ancho de esta imagen sería concat($MT_CanvasX * 0.5, 'px').

 

Clic para expandir/contraerRelleno

Define el relleno del control, que es el espacio entre el borde del control y su contenido. Seleccione un valor en píxeles de una lista desplegable del cuadro combinado o haga doble clic en el campo del valor para introducir en él un valor en píxeles. El relleno se aplicará a los cuatro lados del control.

 

Para definir un relleno distinto para alguno de los cuatro lados, expanda la propiedad Relleno para mostrar las propiedades individuales de ancho (izquierda, derecha, superior e inferior) e indique el valor deseado. Por ejemplo, si indica que el Relleno es de 6px y el Relleno inferior es de 12px, entonces el margen será de 6px en los lados izquierdo, derecho e inferior, y de 12px en el lado inferior.

 

Si introduce valores en píxeles para las propiedades que definen la longitud de un control, debe tener en cuenta que en dispositivos iOS estos valores se leerán como puntos del espacio de coordenadas del área de visualización. El espacio de coordenadas del área de visualización es el lienzo donde se dibujan los componentes de diseño y un punto es la unidad de longitud en este espacio (es decir, aquí los puntos no equivalen a la unidad tipográfica igual a 1/72 de una pulgada). El dispositivo iOS asigna automáticamente puntos del espacio de coordenadas del área de visualización a píxeles del espacio de coordenadas del dispositivo. Al asignar los valores de esta manera (de valores del área de visualización a valores del dispositivo) garantiza que los componentes de diseño conserven la misma relación de tamaño tanto con el lienzo como entre ellos, independientemente de la resolución del dispositivo iOS o de qué unidades se usen.

 

En MobileTogether Designer puede utilizar las variables dinámicas $MT_CanvasX y $MT_CanvasY para averiguar las dimensiones del área de visualización (lienzo de dibujo) actual y obtener así distancias relativas a esas dimensiones. Para dispositivos iOS las variables devuelven valores que se calculan de esta manera: las dimensiones en píxeles del espacio actual de coordenadas del dispositivo se convierten (usando un factor de conversión apropiado) en valores de puntos del espacio de coordenadas del área de visualización. Las variables devuelven estos valores de puntos en píxeles para utilizarlos en el diseño. Por ejemplo, si desea que una imagen sea la mitad del ancho del área de visualización, basta con asignarle un ancho en píxeles igual a $MT_CanvasX * 0.5; la expresión XPath para el ancho de esta imagen sería concat($MT_CanvasX * 0.5, 'px').

 

Clic para expandir/contraerOrden de tabulación

La propiedad Orden de tabulación toma como valor un número entero o una expresión XPath que evalúa con un número entero. Este número entero es la posición del control en la secuencia del orden de tabulación.

 

El orden de tabulación es la secuencia en que se resaltan los controles cuando el usuario del dispositivo cliente pulsa la tecla Tabulador. Todo el orden de tabulación de la secuencia se puede configurar rápidamente y dentro del contexto visual de todos los controles de la página con el comando de menú Página | Mostrar/Definir orden de tabulación. La propiedad Orden de tabulación de cada control solo define la posición secuencial de ese control.

 

Nota: la característica Orden de tabulación solo está disponible para clientes web y Windows.

 

Clic para expandir/contraerAl pulsar Entrar/Escape

Se da uno de tres valores:

 

OnEnter: especifica que las acciones de este control se ejecuten al pulsar la tecla Entrar.
OnEscape: especifica que las acciones de este control se ejecuten al pulsar la tecla Escape.
Ninguno: ninguna acción al pulsar las teclas Entrar o Escape. Este es el valor predeterminado.

 

Si se usan expresiones XPath para generar valores, las expresiones deben evaluar con "AlPulsarEntrar" o "AlPulsarEscape". Si se da el mismo valor ("AlPulsarEntrar" o "AlPulsarEscape") a más de un control en la misma página, al pulsar la tecla se selecciona el primer control visible y habilitado de ese valor. (Véanse las propiedades Visible y Habilitado/Editable).

 

Esta configuración también se puede aplicar con el cuadro de diálogo para configurar las acciones AlHacerClic (véase la descripción de los eventos del control, más arriba).

 

Nota: si selecciona el comando de menú Mostrar/Definir orden de tabulación, entonces los controles que se hayan asignado para cuando se pulsen las teclas Entrar o Escape estarán identificados con un símbolo de la tecla correspondiente.

 

Nota: esta característica solo está disponible en clientes web y Windows, así como en simulaciones en todos los clientes.

 

Clic para expandir/contraerHoja de estilos

La propiedad Hoja de estilos establece qué hoja de estilos se debe usar para el control. La lista desplegable del cuadro combinado de esta propiedad incluye todas las hojas de estilos creadas por el usuario definidas en el proyecto. Seleccione la hoja de estilos que desea usar para el control. Si lo prefiere, también puede usar una expresión XPath para seleccionar la hoja de estilos. La ventaja de usar una XPath es que la selección de la hoja de estilos puede ser condicional (véase Aplicar hojas de estilos creadas por el usuario). Para más información consulte la sección Hojas de estilos.

 

Haga clic para expandir/contraerClase CSS del explorador

El nombre de la clase CSS que quiere asociar con este control. Si quiere asociar varias clases con el control, sepárelas por medio de espacios (p. ej. Clase1 Clase2). Después puede usar estas clases en un archivo CSS (el que se especifica en el cuadro de diálogo "Configuración del explorador") para asignar propiedades para este control concretamente. También puede usar una expresión XPath para generar los nombres de clase o recuperarlos.

 

 


© 2019 Altova GmbH