|
Es necesario actualizar la salida de los servicios de datos existentes para el widget de rejilla (Avanzada) a JSON.
|
|
El widget de rejilla también está disponible como componente Web en ThingWorx Web Component SDK.
|
Clave | Rejilla | Rejilla de árbol |
---|---|---|
TABULADOR | Se cambia el cuadro del foco para realzar los elementos de la rejilla principal, tales como el filtro, las casillas de selección y los botones de clasificación de la cabecera. | Se cambia el cuadro del foco para realzar los elementos de la rejilla principal, tales como el filtro, las casillas de selección y los botones de clasificación de la cabecera. El enfoque se puede configurar mediante el elemento Focus. |
Teclas de flecha | Las teclas de flecha arriba, abajo, izquierda y derecha se utilizan para cambiar el foco vertical u horizontalmente. | DERECHA: permite expandir la fila enfocada. IZQUIERDA: permite contraer la fila enfocada. ARRIBA y ABAJO: permite pasar a la fila o celda enfocada siguiente y anterior. |
INICIO FIN | Se pone el foco en la primera o última celda de la fila actual. | Permite enfocar la primera o la última celda o fila. |
RE PÁG AV PÁG | Se pone el foco en la primera o última celda visible de la columna o fila actual. | Permite enfocar la primera o la última celda o fila visible de la vista de rejilla actual. |
ESPACIO INTRO | Se activa un evento RowClicked o se selecciona la fila actual cuando la selección de filas está activada. | Permite expandir o contraer las filas padre. |
Las propiedades marcadas con un asterisco (*) se soportan en la configuración dinámica de la rejilla. Para obtener más información acerca de la configuración dinámica, consulte Configuración de la rejilla mediante datos JSON. |
Propiedad | Descripción | Tipo base | Valor por defecto | Enlace | Localizable | ||
---|---|---|---|---|---|---|---|
CacheRuntimeChanges | Permite almacenar las opciones de clasificación de la rejilla en la caché del explorador, que se conservan cuando un usuario navega a otra página o mashup. Cuando se muestran varias rejillas en un mashup, los cambios de cada rejilla se almacenan en caché mediante el ID de widget. | BOOLEAN | Verdadero | N/D | N | ||
ClearFilteredSelection | Permite controlar si se conserva la selección de filas al filtrar o clasificar los datos de la rejilla. Active esta propiedad para despejar las selecciones cuando una fila seleccionada se encuentra fuera de la vista de rejilla.
| BOOLEAN | N/D | N/D | N | ||
Data | El origen de datos de infotable que se debe mostrar cuando se visualiza la rejilla en tiempo de ejecución. | INFOTABLE | N/D | Dentro | N | ||
ChildData | Una infotable que define el origen de datos de los nodos hijo que se cargan dinámicamente cuando se expanden los nodos del árbol. Solo rejilla de árbol. | Infotable | N/D | Y | N | ||
ChildDataServiceEvent | Permite activar un evento ServiceInvokeCompleted para el servicio que está enlazado con la propiedad ChildData al expandir nodos de una rejilla de árbol. | BOOLEAN | Falso | N | N | ||
DoubleClicked | Evento que se activa cuando se pulsa dos veces en el widget en todos los modos de selección: Ninguno, Único o Varios. Este evento se puede utilizar para ejecutar otros servicios o funciones en el mashup. Cuando esta propiedad está enlazada a un servicio, no se aplica el comportamiento por defecto de la selección de texto del explorador. | Evento | N/D | Y | N | ||
ParentIDFieldName* | Permite especificar la columna de infotable en los datos de la rejilla de árbol que contiene el ID padre de cada hijo. Este ID se utiliza para crear la estructura de árbol jerárquica. Solo rejilla de árbol. | STRING | parentId | Y | N | ||
HasChildrenFieldName* | Permite especificar el nombre de la columna de infotable que indica si una fila tiene datos hijo disponibles. Para indicar que una fila no tiene hijos, introduzca uno de los siguientes elementos: ‘0’, 0, ‘false’, false, una cadena vacía o undefined. Cualquier otro valor significa que la fila tiene hijos. Solo rejilla de árbol. | STRING | hasChildren | N | N | ||
IncludeRowExpansionParents* | Permite determinar si las filas padre que no se incluyen en los datos del lado del cliente cargados previamente se incluyen al seleccionar o expandir filas hijo. Cuando es verdadero, las filas padre se recuperan con las filas hijo y se mantiene la jerarquía. Solo rejilla de árbol. | BOOLEAN | Falso | N | Y | ||
ExpandableRows | Una infotable que contiene los ID de los nodos de árbol que se pueden expandir. Para que una fila de la rejilla sea ampliable, solo se necesita la columna ID de la fila. Cuando AlwaysExpanded se selecciona, se desestiman estos datos y se expanden todas las filas. Solo rejilla de árbol. | Infotable | N/D | Y | N | ||
AlwaysExpanded* | Permite expandir todos los nodos del árbol de la rejilla. Para utilizar la propiedad PreserveRowExpansion, defina esta propiedad en falso. Solo rejilla de árbol. | BOOLEAN | Falso | N | N | ||
ExpandCollapseAll* | Permite añadir controles para expandir y contraer todos los nodos de árbol de la rejilla. Solo rejilla de árbol.
| BOOLEAN | Falso | N | N | ||
PreserveRowExpansion* | Permite conservar las filas expandidas cuando se renueva la rejilla. Cuando AlwaysExpanded es verdadero, se expanden todas las filas cargadas previamente. Se debe definir la propiedad CacheRuntimeChanges para conservar las filas expandidas al cambiar la vista de la rejilla o navegar entre las páginas. Solo rejilla de árbol. | BOOLEAN | Falso | N | N | ||
ExpandCollapseIcon* | Permite controlar el tipo de icono que se utiliza para expandir y contraer los nodos de árbol de la rejilla cuando no hay datos enlazados a la propiedad ChildData. Solo rejilla de árbol. Opciones soportadas: Signo de intercalación, Flecha, Más/menos | STRING | Signo de intercalación | N | N | ||
ExpandLoadedRows | Permite expandir automáticamente todos los datos cargados previamente cuando se inicia la rejilla. Esta propiedad debe estar desactivada para utilizar la propiedad PreserveRowExpansion. Solo rejilla de árbol. | BOOLEAN | Falso | Y | N | ||
SelectFocusedItem* | Cuando el valor es verdadero, el cuadro de enfoque se utiliza para seleccionar elementos. Cuando es falso, los estados enfocado y seleccionado se establecen por separado. Solo rejilla de árbol. | BOOLEAN | Falso | N | N | ||
SelectParentOnly | Permite desactivar la selección automática de nodos hijo cuando se selecciona un padre. Solo rejilla de árbol. | BOOLEAN | N | N | |||
FocusNavigationMode* | Permite controlar el elemento en el que se centrará inicialmente cuando se cambie el enfoque. Puede navegar primero por las filas, por las celdas o solo por las celdas. Solo rejilla de árbol. | STRING | Primero la fila | N | N | ||
PrimaryColumnFixedSize* | Permite desactivar el cambio de tamaño de la columna principal y la define en un tamaño fijo. Solo rejilla de árbol. Esta propiedad se desestima cuando ResizeColumns es verdadero. | BOOLEAN | Falso | N | N | ||
IDPathSeparator* | Permite especificar el carácter que se utiliza para separar la ruta de ID. El carácter separador de la ruta se utiliza en la rejilla de árbol para las selecciones de filas que la rejilla carga dinámicamente, pero que no se cargan en el lado del cliente. Solo rejilla de árbol. | STRING | :; | N | N | ||
AllowDisabledNodes | Permite desactivar los nodos de la rejilla del árbol. | BOOLEAN | Falso | N | N | ||
DisableChildNodes | Permite desactivar las filas hijas de los nodos padre que están desactivados. | BOOLEAN | Falso | N | N | ||
DisabledStateField | Permite especificar la columna de infotable que se utiliza para definir el estado desactivado de cada fila de la rejilla del árbol. | INFOTABLE | N/D | N | N | ||
LegacyConfiguration | Una propiedad enlazable que permite configurar la rejilla dinámicamente mediante una cadena de configuración en lugar de las propiedades del widget. Esta propiedad se utiliza para soportar la migración desde el widget de rejilla (avanzada). Para añadir una nueva configuración, utilice en su lugar la propiedad de configuración JSON. | STRING | N/D | Y | N | ||
ResetButtonClicked | Evento enlazable que se activa cuando se pulsa en el botón Redefinir. | Evento | N/D | Y | N | ||
ColumnsMenuOptions* | Permite controlar las opciones que se deben mostrar en el menú de configuración de columnas en tiempo de ejecución. Seleccione Ninguno para ocultar el menú. • Ninguno: permite ocultar el botón de menú. • Visibilidad: se muestra una casilla junto a cada nombre de columna, que permite controlar la visibilidad de las columnas. • Orden: se muestra un icono de arrastrar junto a cada nombre de columna, que permite reordenar las columnas. • Visibilidad y orden: se muestran las dos opciones anteriores. | STRING | Ninguno | No | N | ||
ColumnsMenuVisibleItems* | Permite definir el número de elementos que se deben mostrar inicialmente cuando se abre el menú de configuración de columnas en tiempo de ejecución. Utilice esta propiedad para restringir la altura del menú. Se muestra una barra de desplazamiento para columnas adicionales. | NUMBER | 6 | No | N | ||
DefaultSelectedRows* | Permite especificar los números de fila que se deben seleccionar por adelantado cuando se carga la rejilla. Se puede escribir un rango numérico, por ejemplo, 1-10, o una lista separada por comas, como 2, 4, 5. | STRING | N/D | Dentro | N | ||
IsEditable* | Permite a los usuarios editar los datos de rejilla en tiempo de ejecución. Por defecto, los datos de la rejilla se guardan automáticamente cuando el modo editar se aplica a toda la rejilla. | BOOLEAN | Falso | Dentro/Fuera | N | ||
EditLevel* | Permite controlar el modo en que los usuarios pueden editar los datos de rejilla en tiempo de ejecución. Seleccione Toda la rejilla para editar y guardar todos los cambios a la vez, Una sola fila para editar y guardar los cambios de una fila a la vez, o bien Una sola celda para editar y guardar los cambios de una celda cada vez. | STRING | Una sola celda | No | N | ||
EditButton* | Permite mostrar un control de edición en la barra de herramientas para que los usuarios puedan activar o desactivar la edición. | BOOLEAN | Falso | No | N | ||
RowAddButton* | Permite mostrar un botón Añadir en la barra de herramientas de la rejilla para que los usuarios puedan añadir nuevas filas a la rejilla mediante un formulario. | BOOLEAN | Falso | No | N | ||
RowDeleteButton* | Permite mostrar un botón de la barra de herramientas de rejilla para que los usuarios puedan borrar las filas seleccionadas. | BOOLEAN | Falso | No | N | ||
ConfirmDelete | Un servicio enlazable que permite enlazar el botón Borrar fila a una función de confirmación. | Servicio | N/D | Dentro | N | ||
DeleteRowClicked | Un evento que se activa cuando se pulsa en el botón Borrar fila de la barra de herramientas de rejilla. | Evento | N/D | Fuera | N | ||
RowEditFormTitle* | Permite especificar el título que se debe mostrar para el formulario de edición de filas. Para ocultar el título y utilizar el área del formulario, deje este campo vacío. | STRING | N/D | Dentro | Y | ||
EditControlVisibility* | Permite especificar cuándo se deben mostrar los controles de edición en la rejilla. Las opciones soportadas son: Al pasar sobre o poner el foco, Siempre, Nunca. | STRING | Al pasar sobre o poner el foco | Dentro | N | ||
EditControlType* | Permite definir el elemento de control que se va a usar para editar la rejilla. Las opciones disponibles son Icono o Vínculo. Se puede elegir un icono o definir el texto del vínculo mediante las propiedades EditControlIcon y EditControlLabel. | STRING | Vínculo | No | N | ||
EditControlLabel* | Permite definir el rótulo para el control de edición cuando EditControlType se define en Vínculo. | STRING | Editar | Dentro | Y | ||
EditControlIcon* | El icono que se mostrará para el control de edición cuando EditControlType se establece en Icono. | IMAGE | N/D | No | N | ||
EditCellStarted | Un evento que se activa cuando un usuario empieza a editar una celda en la rejilla. | Evento | N/D | Fuera | N | ||
EditCellCompleted | Un evento que se activa cuando un usuario termina de editar una celda en la rejilla. | Evento | N/D | Fuera | N | ||
EditRowStarted | Un evento que se activa cuando un usuario empieza a editar una fila en la rejilla. | Evento | N/D | Fuera | N | ||
EditRowCompleted | Un evento que se activa cuando un usuario termina de editar una fila en la rejilla. | Evento | N/D | Fuera | N | ||
EditCanceled | Un evento que se activa cuando un usuario pulsa en el botón Cancelar. | Evento | N/D | Fuera | N | ||
Cancel | Un servicio de datos enlazable que cancela las ediciones actuales de la rejilla sin guardar. | Servicio | N/D | Dentro | N | ||
EditStarted | Un evento que se activa cuando se pulsa en el botón Editar. | Evento | N/D | Fuera | N | ||
EditCompleted | Un evento que se activa cuando se pulsa en el botón Guardar después de realizar las modificaciones. | Evento | N/D | Fuera | N | ||
EditedData | Una infotable que contiene los elementos editados en la rejilla. | INFOTABLE | N/D | Fuera | N | ||
DeletedData | Una infotable que contiene los elementos borrados en la rejilla. Para borrar los datos del servidor, enlace la infotable a un servicio de datos personalizado. | INFOTABLE | N/D | Fuera | N | ||
HighlightDraftState | Permite enlazar las celdas con cambios no guardados con un color diferente al editar en un nivel de celda. | BOOLEAN | Falso | No | N | ||
HighlightNewRows | Permite realzar las filas nuevas que se añaden a la rejilla en tiempo de ejecución. | BOOLEAN | Falso | N | N | ||
ShowFilter | Permite mostrar un cuadro de filtro en la rejilla. | BOOLEAN | Falso | Y | N | ||
Filter | Un evento que se activa cuando se clasifica o filtra la rejilla. | Evento | N/D | N/D | N | ||
FilterLabel* | Permite definir el rótulo del cuadro de filtro. | STRING | N/D | Dentro | Y | ||
FilterString* | La cadena de filtro del cuadro de filtro simple. | STRING | N/D | Dentro/Fuera | N | ||
HeaderVerticalAlignment | Permite controlar la alineación vertical del contenido dentro de la fila de cabecera. | STRING | Arriba | N/D | N | ||
HideHeaderRow* | Permite ocultar la fila de cabecera. | BOOLEAN | Falso | Dentro | N | ||
IDFieldName* | Permite seleccionar la columna de infotable que contiene la clave principal o el ID de cada fila de la rejilla. | STRING | id | N/D | N | ||
Label* | Permite especificar el texto del rótulo de rejilla. | STRING | Título de rejilla | Dentro | Y | ||
LabelType* | Permite definir el tipo de rótulo de rejilla. | STRING | Subcabecera | N/D | N | ||
LastClickedRow | Una infotable que contiene los datos de la última fila en la que se ha pulsado en la rejilla. | INFOTABLE | N/D | N/D | N | ||
LinkClicked | Evento que se activa cuando se pulsa en un hipervínculo dentro de una celda de la rejilla. | Evento | N/D | Y | N | ||
ClickedLinkData | Una infotable que contiene los datos de fila para el hipervínculo. | Infotable | N/D | Y | N | ||
ClickedLinkColumn | Se devuelve el nombre de columna del último hipervínculo en el que se ha pulsado. Esta propiedad se puede utilizar cuando la rejilla contiene más de una columna con hipervínculos. | STRING | N/D | Y | N | ||
MaxHeaderHeight | La altura máxima de la cabecera de la rejilla en píxeles. | NUMBER | Automático | Dentro | N | ||
MaxRowHeight | Permite especificar la altura máxima de las filas de la rejilla en píxeles. Por defecto, el valor de la altura se define en función del contenido de cada fila. | NUMBER | Automático | Dentro | N | ||
MinRowHeight | Permite especificar la altura mínima de las filas de la rejilla en píxeles. | NUMBER | 48 | Dentro | N | ||
QueryFilter | Una propiedad enlazable que contiene la consulta de filtro que se debe aplicar a los datos de la rejilla. La propiedad se puede enlazar a un widget de filtro de datos y a un servicio de datos para filtrar datos en la rejilla. | QUERY | N/D | Dentro/Fuera | N | ||
Reset | Un servicio enlazable que permite redefinir el widget de rejilla con su configuración inicial en tiempo de ejecución. | Servicio | N/D | N/D | N | ||
RowClicked | Un evento que se activa cuando se pulsa en una fila de la rejilla. | Evento | N/D | N/D | N | ||
RowFormat | Permite abrir un cuadro de diálogo para seleccionar una definición de estado que se puede aplicar a las filas de la rejilla. Se puede reemplazar este formato de estado para las celdas aplicando formato de estado a las columnas en el cuadro de diálogo de configuración de widgets. | Definición de estado | N/D | N/D | N | ||
RowSelection* | Permite controlar el número de filas de datos de la rejilla que un usuario puede seleccionar al mismo tiempo. Las opciones disponibles son las siguientes: Ninguna (por defecto), Única y Varias. | STRING | Ninguno | Dentro | N | ||
RowSelected | Devuelve verdadero cuando se seleccionan una o más filas de la rejilla. Por ejemplo, esta propiedad se puede utilizar para mostrar acciones personalizadas en la barra de herramientas cuando se seleccionan una o más filas. | BOOLEAN | Falso | Y | N | ||
RowsVerticalAlignment | Permite controlar la alineación vertical del contenido dentro de las filas. | STRING | Arriba | N/D | N | ||
SelectedRows | Una propiedad de infotable que permite definir o recuperar las filas de datos seleccionadas en la rejilla. Esta propiedad no conserva los datos de la fila seleccionada al mover entre las páginas de una rejilla paginada. Para pasar las filas seleccionadas de todas las páginas, utilice la propiedad SelectedRowsIDs en su lugar. | INFOTABLE | N/D | Dentro/Fuera | N | ||
SelectedRowsChanged | Un evento que se activa cuando cambian las filas seleccionadas. | Evento | N/D | N/D | N | ||
SelectedRowsChangedCallback* | Permite activar el evento SelectedRowsChanged cuando las filas seleccionadas se cambian manualmente o mediante un servicio de datos. Si se define en False, el evento solo se activa cuando las selecciones de filas se cambian manualmente. | BOOLEAN | Verdadero | N/D | |||
SelectedRowsIDs | Una infotable que contiene el valor IDFieldName de todas las filas seleccionadas en la rejilla. Cuando se paginan los datos de la rejilla, esta propiedad devuelve los valores de ID seleccionados de todas las páginas. Esta propiedad se puede utilizar para conservar las filas seleccionadas cuando se cambia la página.
| Infotable | N/D | Y | N | ||
SelectionCheckBoxHeaderAlignment | Permite controlar la alineación vertical de la casilla de selección en la fila de cabecera. | STRING | Arriba | N/D | N | ||
SelectionCheckboxRowAlignment | Permite controlar la alineación vertical de las casillas de la columna de selección de filas. | STRING | Arriba | N/D | N | ||
ShowValidationSuccess* | Permite mostrar un mensaje de operación correcta si los datos introducidos se han validado correctamente. | BOOLEAN | Falso | No | N | ||
ValidationSuccessIcon* | El icono que se muestra junto al mensaje de operación correcta. | selector multimedia | Icono de operación correcta | No | N | ||
ShowValidationFailure* | Permite mostrar un mensaje de fallo cuando los datos introducidos no superen la validación. | BOOLEAN | Falso | No | N | ||
ValidationFailureIcon* | El icono que se muestra junto al mensaje de fallo. | selector multimedia | Icono de información | No | N | ||
ShowValidationCritera* | Permite mostrar un mensaje de sugerencia sobre el patrón de entrada necesario al editar una celda en la rejilla. | BOOLEAN | Falso | No | N | ||
ValidationCriteriaIcon* | El icono que se muestra junto al mensaje de sugerencia para los criterios de validación. | selector multimedia | Icono de información | No | N | ||
ShowFooter* | Permite añadir un área de pie de página a la rejilla. | BOOLEAN | Falso | No | N | ||
ShowHeaderRowInFooter* | Se muestra la fila de cabecera en el pie de página de la rejilla cuando ShowFooter se define en Verdadero. | BOOLEAN | Falso | No | N | ||
FooterData* | Una infotable que contiene los datos de configuración del pie de página de la rejilla. | INFOTABLE | N/D | Dentro | N | ||
ShowRowNumbers* | Se muestran los números de fila en una columna independiente en la rejilla. | BOOLEAN | Falso | N/D | N | ||
SingleLineHeader* | Permite mostrar el texto de la fila de cabecera en una sola línea. El texto se trunca cuando supera el espacio disponible. Por defecto, el texto de la cabecera se muestra en varias líneas. | BOOLEAN | Falso | Dentro | N | ||
SingleLineRows* | Permite mostrar el contenido de cada fila en una sola línea. Se muestran puntos suspensivos cuando el contenido completo no se puede ajustar en una fila. Por defecto, el contenido se muestra en varias líneas.
| BOOLEAN | Falso | Dentro | N | ||
SortSelectionColumn* | Permite añadir un botón de clasificación a la columna de selección de casillas. De este modo, las filas de datos se pueden clasificar según si están seleccionadas o no. | BOOLEAN | Falso | N/D | N | ||
TabSequence | El número de secuencia del widget al pulsar el tabulador. | NUMBER | 0 | N/D | N | ||
ToolbarActionsData | Una infotable en la que se definen las acciones personalizadas que se deben mostrar en la barra de herramientas de la rejilla. Cuando se enlaza un servicio a esta propiedad, al panel Propiedades se añaden propiedades adicionales para cada acción personalizada. | Infotable | Y | N | |||
ToolbarActionsPosition | Permite controlar la posición de las acciones personalizadas de la barra de herramientas en relación con los botones de editar, añadir y borrar de la rejilla. Opciones: Ninguno, Antes, Después.
| STRING | Después | N |