Source: http://www.provisio.com/helpconsole/SiteKiosk%20Ayuda/es-ES/keyboard_layout.htm
Timestamp: 2019-08-25 02:48:16+00:00

Document:
Diseños Teclado - SiteKiosk Ayuda
Home > Personalización (Skins) > Diseños Teclado
Documentación Archivo de definición de Diseños de Teclado
El archivo de definición XML para los teclados en pantalla, mediante sus elementos y atributos, define el área para cada tecla que puede presionarse en el teclado de pantalla táctil, y la función asociada que debe ejecutarse.
Es preciso un conocimiento básico para crear un diseño de teclado nuevo. Por razones obvias no podemos (a parte de esta documentación) proporcionar soporte gratuito para crear sus skins personalizados.
Por favor, tenga en cuenta que la siguiente documentación solo está disponible en inglés.
1. Recomendaciones sobre las Resoluciones de Pantalla
Los los diseños de teclado incluidos con SiteKiosk se han optimizado para una resolución de 1600x1200 pixels.
Si utiliza resolución diferente en SiteKiosk, entonces SiteKiosk convertirá autormáticamente todos los para la resolución apropiada que también permite mostrarse en 800x600. Tenga en cuenta que bajo circunstancias normales un teclado no se mostrará en un tamaño superior al tamaño original de la imagen de teclado.
Definiendo de forma explícita el elemento painting, puede optimizar la forma en la que se mostrará para una determinada resolución.
Para una mejor calidad de la imagen le recomendamos crear un diseño de teclado con una resolución de al menos 1024x768 si está pensando en un diseño de teclado para uso general. Si está creando uno para un uso específico planificado, debería decidir la resolución en la fase inicial.
2. Estructura general del archivo de definición
La forma más sencilla es comenzar a partir de un modelo de archivo completo de los diseños de teclado en pantalla ya existentes. El diseño de barras de desplazamiento estándar (en inglés) es un teclado en pantalla muy simple. Descargue la definición del diseño y revise el archivo "standard_english_scroll.xml" en el directorio .\SiteKiosk\skins\default\englishscroll con un editor de texto.
Este es un extracto de las principales áreas del archivo:
3. Documentación de los Elementos y Atributos
Cada diseño de teclado se divide en una sección keydef (para definir las teclas) con varias secciones subkeydef sections y una sección opcional de dibujo. Las secciones subkeydef describen los diferentes estados posibles de las teclas en un teclado, por ejemplo contraído (pequeño) o extendido (grande).
El único atributo de la sección es el keydef name define el nombre del teclado. El contenido de este atributo se muestra en la configuración de SiteKiosk. El atributo name (nombre) debe ser único para cada diseño de teclado.
Las seccionessubkeydef describen los distintos estados posibles del teclado, por ejemplo, contraído (pequeño), o extendido (grande).
El atributo name especifica un nombre único para el sublayout. El nombre se necesita cuando crea teclados que cambien en ejecución a tiempo real. Por ejemplo, con los teclados multi-idioma, en los que se utiliza este atributo name.
El atributotype determina si la definición de teclado es para un teclado grande (extendido) o pequeño (contraído). Esto es principalmente para asegurar que SiteKiosk pueda detectar en tiempo real de ejecución si el teclado ya está en posición contraida, por ejemplo cuando se abre una nueva ventana.
El cambio desde un teclado extendido a contraído o viceversa sólo puede ocurrir de forma automática si hay disponible un área de tecla tipo "2" (botón para alternar entre ambos). Con un cambio automático todas las entradas de tipo "2" se realizan eligiendo el primero que se encuentra.
Importante: Las teclas deben definir completamente para tamaño grande y pequeño, es decir, algunas teclas visibles en tamaño pequeño y grande se deben definir dos veces.
El atributo language especifica el idioma para el cual se ha definido el diseño de teclado. Es importante para un cambio automático de idioma comprobar si el diseño deseado puede incluir ya el ajuste correcto de idioma. Utilice el 0 si quiere crear un teclado que pueda cambiar entre todos los idiomas configurados en el teclado de Windows. En caso contrario, introduzca el ID del idioma deseado.
El atributo docked determina si el teclado debe anclarse. Esto significa que al contrario del teclado FLOTANTE, un teclado anclado (docked) hace la ventana del navegador más pequeña de tal forma que se posiciona fuera del navegador o áreas no definidas de sobreposición en dockrect.
Un teclado ANCLADO (en inglés, DOCKED) asegura que el teclado no cubre la ventana del navegador. Por el contrario un teclado cubre parcialmente el navegador. -1 Significa que el teclado está anclado. , 0 significa que no está anclado (que es flotante).
El atributo forcewinkeyboard está obsoleto.
Si un teclado está anclado, el valor dockrect define el rango en el que el teclado puede extenderse en la ventana del navegador. Este área también es la parte visible del teclado contraído. Normalmente hay botones para "(desplegar/contraer) Teclado" además de los botones de desplazamiento. El código de ejemplo es de 1024 píxeles de ancho y 58 píxles de alto de solapamiento en el navegador. Si no se define el parámetro dockrect, el navegador se repliega sobre el teclado entonces no se posiciona sobre el navegador.
Los atributos de dockrect son coordenadas para las dimensiones del área. Estos valores también son importantes para centrar el teclado.
Coordenadas para la esquina superior izquierda del área dockrect.
Coordenadas para la esquina inferior derecha del área dockrect.
Este elemento especifica el aspecto del fondo del teclado en su estado anclado. Aquí puede definir un color o una imagen.
Si el tipo es "1", entonces el atributo color espera un valor decimal que especifique el color de fondo.
Si el tipo se define como "2", entonces es necesario proporcionar un nombre de archivo para el archivo..
Si type es "1", entonces el atributo de color espera un valor decimal para definir el color o filename.
Si type es "2", entonces el atributo debe especificar el filename. Puede utilizar color o bien filename.
Este elemento tiene dos posibles ubicaciones en la definición del teclado. Puede ser un hijo del elemento keydef element o del elemento subkeydef.
Como elemento hijo de keydef element se utiliza para implementar el los valores de color por defecto para un teclado, que tiene colores que permiten personalizarse en la configuración de SiteKiosk, por ejemplo el diseño de teclado TouchBrowser. Los valores se pueden dejar como están, pues serán sobreescritos en la configuración de SiteKiosk. Por tanto no se detallarán más en este este documento.
Ejemplo: sección Painting del elemento keydef.
Sin embargo el elemento painting como hijo del elemento subkeydef es necesario si quiere crear un teclado que pueda cambiar automáticamente entre todos los idiomas configurados para funcionar en Windows. Entonces los archivos de imagen del teclado no contienen letras, sirven para el idioma especificado para valores de color (en estado presionado y no presionado), fuente, etc, a dibujar.
Ejemplo: Extracto del archivo natural.xml. Un diseño de teclado independiente del idioma.
Color del fuente de la etiqueta del botón (tecla) cuando no está presionado.
Color del fuente de la etiqueta del botón cuando se está presionando.
Fuente de la etiqueta del botón.
Valor weight del fuente de la etiqueta de la tecla.
Tamaño de fuente de la etiqueta de la tecla.
Otros atributos posibles son resolution-x y resolution-y. Esto le permite especificar a qué tamaño se debe ajustar el teclado. Si no se especifica ningún valor, SiteKiosk utilizará 1600x1200. Para resoluciones más grandes o más pequeñas será escalado de acuerdo con esas proporciones.
Ejemplo: Datos para un teclado que se adaptará a una resolución de pantalla de 1024x768.
Ancho de resolución en pixels.
Alto de la resolución en pixels.
Este elemento sólo se necesita si quiere crear un teclado que pueda cambiar automáticamente entre los idiomas configurados en Windows. Este elemento representa los idiomas disponibles a elegir y pueden ser defidios en la tecla correspondiente a type 19. La imagen del siguiente código de ejemplo contiene elementos opcionales, que en caso de no ser especificados, el idioma se escribirá con un texto. Imagerect yTextRect definen la posición de la imagen en el área de texto de un elemento.
Ejemplo: Extracto del archivo natural.xml. A diseño de teclado independiente del idioma.
Elección del fuente dentro del área de selección de idioma.
Peso del Fuente del área de selección de idioma.
Tamaño del fuente del área de selección de idioma.
Imagen tipo icono que marca el idioma seleccionado.
Pisión del menú de selección de idioma. El valor decimal es opcional. Valor por defecto: 32. Posiciones del menú de selección de idioma en la parte superior izquierda del teclado.
El valor es la suma de valores hexadecimales, cuyo resultado se a convertido a un valor decimal.
Ejemplo: la posición debería ser la esquina superior derecha del botón de selección de idioma del teclado. Esto significa 0x01 + 0x80 + 0x20 = A1. El valor decimal que se tiene que utiizar es 161.
Los siguientes parámetros están disponibles dentro del languageselector:
Define la posición del área de la imagen del elementolanguageselector.
Define la posición del área de texto del elemento languageselector.
Especifica la ruta a un archivo de imagen que representa el dicioma, por ejemplo, la bandera de un país.
Esto le permite definir un punto que permanecerá invariable ante los cambios en el teclado. Si alterna entre dos teclados similares, esto impiede un representación desplazada del teclado. Si el elemento hotspot no se puede fijar aquí, el punto (x=0, y=0) se definirá automáticamente como un hotspot.
Los teclados fijos, que se muestran centrados, no están influenciados por el elemento hotspot.
Define las coordenadas de un hotspot.
Un alemento shape element especifica el contorno de un diseño de teclado entero (Ejemplo 1) o una tecla individual (Ejemplo 2). Los elementos geométricos disponibles para una tecla se describen aquí.
Ejemplo 1: Especifica que el diseño de teclado es de 1024 pixels de ancho por 58 pixels desde el punto superior visible del gráfico del teclado contraído.
Ejemplo 2: Definición de la tecla "Scroll up / Re Pág" (Type 5). En el diseño de teclado se realiza definiendo una forma (aquí es un polígono mediante 5 puntos), lo que determina la posición y el tamaño del botón a partir de los 5 valores de coordenadas. Al hacer clic el archivo de sonido identificado con el ID 5 se reproducirá cuando la tecla "Scroll Up /Re Pág." sea presionada.
el elmento shape tiene incluso un atributo opcional mode, que determina cómo cada elemento sub-o elementos-hijo se acoplan para obtener la forma final. El mode puede contener los siguientes valores​: "or" (por defecto), "and", "xor" y"diff". Cada elemento hijo puede tener un atributo mode, que sobreescribe atributo mode el elemento padre. Los elementos hijo se acoplan de arriba a abajo para conformar un diseño de teclado completo.
3.9 Areas Define Key
Utilizando varios elementos geométricos puede definir áreas en el teclado para hacer clic.
Ejemplo de polóigono: Un polígono consiste en un número cualquiera de puntos interconectados (5 en este caso).
Están disponibles las siguientes formas geométicas:
Con rect, definirá un rectángulo. Los atributos son el punto "x1", "y1" para el extremo superior izquierdo, y el punto "x2" "y2" para el inferior derecho.
Con elipses, puede definir un area elíptica. La elipse se describe mediante un rectánculo, que toca la elipse por cuatro puntos desde el interior. De nuev, los atributos son las coordenadas "x1" "y1" y "x2" "y2".
Esto le permite especificar un rectángulo redondeado. Además de los atributos para las coordinadas rectangulares ("x1", "y1" y "x2", "y2") se puede utilizar para determinar en qué grado el rectángulo tendría las esquinas redondeadas.
Un polígono define un área mediante varios puntos. El polígono se puede formar con dos atributos Polymode distintos. Si el Polymode es "winding" is (por defecto), entonces todas las zonas son rellenadas. Si Polymode fuera "alternate", entonces las regiones entre los lados impares y pares se rellenarán.
Usando puntos se proporcionarán algunos de los conforman el polígono mediante las coordenadas con atributos x, y.
Este campo opcional especifica zonas a las que el usuario no podrá arrastrar el teclado. El elemento nondragarea se construye igual que el elmento shape.
Nota: Este elemento no se necesita si quiere crear un teclado que pueda conmutar automáticamente entre los idiomas configurados en Windows. En ese caso utilice el languageselector-Element.
Con el elemento opciocional de idioma, es posible crear distintos diseños de teclados por idioma. Cuando se produce un cambio automático de idioma se utilizarán todos los que coincidan con el código de identificación de idioma ("ID").
Ejemplo: extracto del archivo tx82_ultra_universal_floating.xml; diseño de teclado tri-lingüe (Inglés, Alemán, Francés).
El diseño de teclado se cargará donde se especifique en target. Target es necesario en atributo nombre del elemento subkeydef.
El atributo id especifica la lengua del diseño de teclado cargado en target.
Los IDs de idiomas son los sguientes:
El elemento jpeg las imágenes con dos variaciones: teclas no pulsadas (type="normal") y teclas pulsadas (type="pressed"). Los dibujos pueden ser archivos jpeg y también archivos png.
La imagen para type="normal" se muestran completamente. Mientras que la imagen para el tipo type="pressed" sólo se muestra la parte del botón que está pulsada (presionada). Esta sección se define en el área key. Para que un teclado en pantalla funcione es necesaria la especificación de ambas imágenes.
Tenga en cuenta que hay un tercer tipo llamado mask, que se utiliza para teclados con colores personalizados. Los colores se definen en la configuración de SiteKiosk. Un ejemplo sería el diseño de teclado TouchBrowser.
Tendrá el valor normal, para teclas no pulsadas, o pressed para las teclas pulsadas. Type mask se utiliza además de forma opcional en teclados para personalizar el color. Se aplica en las imágenes a blanco y negro, negro para el cuerpo del teclado y blanco para las teclas. Si se utiliza mask el uso de normal y pressed es opcional y entonces se refería a las imágenes con escalas de grises en canal alfa (formato tga).
Entre la etiqueta de apertura <sound> y de cierre </sound> se define el archivo de sonido a reproducir. Introduzca tantos elementos de sonido como necesite. Sin embargo, debe establecer los atributos id para cada uno.
El id del elemento sonido determina cuándo se reproduce el sonido. En los elementos key- o macro con el atributo de sonido se define el sonido de sonido para el elemento.
Los elementos nonshiftkeys, son todas aquellas teclas o botones que pueden utilizarse sin necesidad de las teclas shift. Estos incluyen por ejemplo "a", "b", "+", "-", "." or "," y también las que sirven para cambiar el diseño de teclado, teclas / botones de desplazamiento, etc.
Cada tecla individual se define con la ayuda de key-Elements.
3.15 Elemento keyswithoutshift y Element keyswithshift
Esto le permite determinar qué teclas/funciones deben asimilarse en key sin función Shift (keyswithoutshift) o con la función Shift. Como elementos hijo sólo se proporcionan los elementos key, como se describe en KEY y SHAPE.
Los botones del área keyswithoutshift y keyswithshift se definen respectivamente con los elementos key.
El elemento key tiene varios atributos. No todos se tienen que definir.
Ejemplo 2: Define la tecla "Scroll up /Re Pág" (Type 5). En el diseño de teclado es la forma (aquí un Polygono con 5 puntos), la que determina la posición y el tamaño del botón mediante los 5 valores de coordenadas. Haciendo clic el archivo de sonido con el ID 5 se reproducirá si la teclas "Scroll Up /Re Pág" se pulsa.
El atributo sonido especifica qué sonido se reproducirá cuando se pulsa una tecla/botón. Aquí se especifica el correspondiente Sound-ID.
El atributo vkey puede determinar qué tecla virtual debe simularse al pulsar un botón. Por favor lea esta nota y también la documentación del API Window.
El atributo scancode puede determinar alternativamente qué virtual key debe simularse al pulsar un botón. Por favor consulta la documentación del API Window.
Con shift, puede determinar si el shift ket debe simularse.
Este atributo sólo se utiliza cuando el botón que invoca el elemento de selector de idioma (Type 19). En este momento el único valor aceptado es -1.
En la mayoría de los casos, el atributo char es suficiente, simplemente porque porque este es el carácter especial que se especifica, entonces se simula la pulsación completa de la tecla del correspondiente botón (incluyendo Shift, Ctrl y Alt).
En target se puede asignar una URL o un diseño de teclado. El destino deseado se mostrará en al tocar un botón. Para controlar el diseño de teclado introduzca el el nombre del teclado en subkeydef .
El elemento key puede tener distintos atributos que pueden definir cada tipo: type.
Representa una tecla normal. Es la tecla a pulsar como mkey element o simulado.
Es el bloqueo de mayúsculas / Caps Lock que cambia el estado interno en SiteKiosk. Si el estado interno es "Shift", entonces cuando el usuario hace clic en el teclado todos las simulaciones se hacen como keyswhithshift, mientras que si el estado no es "Shift", entonces las teclas se definen sin shift en nonshiftkeys y en keyswithoutshift. Observe que type = "1" siempre se combina con vkey = "16" para simular la tecla de bloqueo de mayúsculas.
Este botón es para cambiar el tamaño del teclado. Sólo debería aparecer en lugar del propio teclado. El diseño se define en el atributo target. Para cambiar entre idiomas o para cambios generales de diseño utilice el Type 17.
Simula el desplazamiento de contenidos de todos los marcos a la izquierda.
Simula el desplazamiento de contenidos a la derecha.
Simula el desplazamiento de contenidos hacia arriba.
Simula desplazamiento / scroll de los contenidos hacia abajo.
Este tipo no se puede utilizar (reservado).
Simula un clic en el botón atrás.
Simula un clic en el botón adelante.
Simula un clic en el botón parar.
Simula un clic en el botón refrescar.
Simula un clic en el botón start page / home page.
Simula un clic en el botón Imprimir.
Simula un clic en el botón Buscar.
No se puede utilizar (reservado).
Cambia al diseño de teclado especificado en target.
Es para la selección de idioma, si quiere crear un teclado que pueda cambiar de forma dinámica entre los distintos teclados de los idiomas configurados en Windows, y esto siempre se combina con language="-1" en el atributo language de cada elemento key. Normalmente no son posibles otros valores para language. El atributo language de subkeydef se establecerá a 0 y se adaptará dinámicamente al idioma del diseño de teclado de Windows.
Simula Alt Gr.
Simula shift (Shift).
Simula Strg-Taste.
Sugerencia: Para imprimir el atributo char usando caracteres especiales, es necesario utilizar Unicode. Por favor tenga en cuenta que sólo se pueden utilizar caracteres que también existan en el diseño de teclado oficial para el idioma seleccionado.
Ejemplo: Define una tecla para el carácter "€".
Este elemento permite crear macros, lo que significa que presionando una única tecla / botón se pueden simular automáticamente varias acciones de tecla individual.
Ejemplo: Acitivando esta macro se escribirá el conjunto que compone el emoticono ";-)".
En elemento macro tiene un atributo de sonido, que se asigna bajo el elemento de sonido asociado al ID para el archivo de sonido.
El elemento macro también se compone del sub-elemtno shape, que determina las coordenadas para el área que se registrará ante la presión de esa tecla / botón. El elemento shape se ha descrito aquí.
Una macro contiene como elemento hijo cualquier número de elementos mkey. Estos definen las teclas individuales que forman la macro.
El atributo mkey puede contender vkey, press, char o shift.
El atributo vkey attribute determina que tecla virtual (ver la documentación de Window API aquí) para simularse con el Tastentendruck.
Presionado uno determina la acción correspondiente a la pulsación, es decir, si el botón se pulsa o no: pressed ("1"), released ("0"); o se pulsa y se suelta ("-1") (por defecto).
Con shift podemos determinar si debe simularse que se ha pulsado la tecla Shift previamente.
En la mayoría de los casos, sin embargo, el atributo char es suficiente, simplemente porque el carácter deseado se se espeficia, en cuyo caso se simula la pulsación completa de las teclas necesarias In most cases, however, the char attribute is sufficient, simply because the desired character is specified, then the entire necessarias (incluuendo Shift, Ctrl y Alt).
El elemento icon es opcional (se utiliza para teclados con color personalizable) y se puede utilizar para asignar un icono a una tecla o macro. La forma del icono debería coincidir con la de la tecla a la que se asigna. Puede encontrar más información aquí.
La ruta del elemento icon se define mediante path, determinando así la imagen del icono. La imagen necesita ser blanco y negro. El fono es negro y el símbolo de icono blanco. el símbolo se rellenará con el color seleccionado en la configuracón de SiteKiosk.
virtkeys.exe es una herramienta de software que puede descargar gratuitamente. Con esta herramienta, puede comprobar fácilmente los códigos de las teclas virtuales que necesite para un diseño de teclado en pantalla.
Los keycodes más importante en un vistazo son los siguientes:
4.2 Conversión de diseños de teclado antiguos
Nota: La herramienta aquí mencionada no está soportada oficialmente.
Ofrecemos una herramienta de conversión gratuita para descargar. Con este programa podría convertir antiguos archivos .kbd (4.8 de SiteKiosk) en un nuevo formato .xml format. Sin embargo es necesario siempre un rediseño para asegurar y garantizar el funcionamiento completo con las últimas versiones de SiteKiosk.

References: resolución 
 resolución 
 resolución 
 resolución 
 resolución 
 resolución 
 resolución 
 resolución