Control Card en PowerAppsCard control in PowerApps

Proporciona la experiencia de edición y visualización de un solo campo de un control Formulario de presentación o Formulario de edición.Provides the display and editing experience for a single field of a Display form or Edit form control.

DescripciónDescription

Los controles Formulario de presentación y Formulario de edición funcionan como contenedores para mostrar y ver los registros enteros.Display form and Edit form controls act as containers for displaying and viewing entire records. Cada contenedor puede contener un conjunto de controles Card que muestran campos individuales o proporcionan una forma de actualizar esos campos.Each container can hold a set of Card controls that display individual fields or provide a way to update those fields. Cada tarjeta tiene una propiedad DataField que especifica el campo del registro en el que se trabaja.Each card has a DataField property that specifies which field of the record it works on.

Hay definidas tarjetas predefinidas para diferentes tipos de datos y experiencias de usuario.Predefined cards are defined for different data types and user experiences. Por ejemplo, puede haber una tarjeta para editar un campo numérico con un control Entrada de texto, que resulta muy adecuado para usar con el teclado.For example, there may be a card to edit a number field with a Text input control, which is great for use with the keyboard. Otra tarjeta podría permitir la edición de un número usando en su lugar un control Control deslizante.Another card might support editing a number by using a Slider control instead. Con el control de formulario seleccionado, puede seleccionar fácilmente, en el panel derecho, una tarjeta basada en un campo.With the form control selected, you can, in the right-hand pane, easily select a card based on a field.

Las tarjetas contienen controles.Cards themselves contain controls. Los controles de una tarjeta constituyen la experiencia para mostrar y editar un único campo.The controls of a card make up the experience for displaying and editing a single field. Por ejemplo, una tarjeta de número puede estar formada por un control Etiqueta para proporcionar el nombre para mostrar del campo y un control Entrada de texto para proporcionar un editor para el valor del campo.For example, a number card may consist of a Label control to provide the display name of the field and a Text input control to provide an editor for the value of the field. La tarjeta puede tener también un control Etiqueta que muestra los errores de validación que se producen y un control Etiqueta para el asterisco común que indica que es un campo obligatorio.The card may also have a Label control that shows any validation errors that occur and a Label control for the common asterisk to indicate that a field is required.

Puede personalizar los controles de una tarjeta predefinida: cambiar su tamaño, moverla, ocultarla, agregarle controles y realizar otros cambios.You can customize the controls of a predefined card by resizing it, moving it, hiding it, adding controls to it, and making other changes. También puede comenzar con una tarjeta completamente en blanco, una "tarjeta personalizada", a la cual agregar controles desde cero.You can also start with an entirely blank card, a "custom card", to which you add controls from scratch.

Las tarjetas predefinidas están bloqueadas de forma predeterminada.Predefined cards are locked by default. En una tarjeta bloqueada, solo puede modificar determinadas propiedades de la tarjeta o los controles que contiene. No se puede eliminar una tarjeta bloqueada.In a locked card, you can modify only certain properties of the card or the controls within the card, and you can't delete a locked card. Puede mostrar el bloqueo de tarjeta y desbloquearla en la pestaña Ver de la vista Avanzado.You can show the card lock and unlock it on the View tab of the Advanced view. Si una propiedad está bloqueada y no se puede modificar, aparece un icono de candado junto a su nombre.If a property is locked and can't be modified, it appears with a lock icon next to its name. Desbloquear una tarjeta es una actividad avanzada y debe realizarse con cuidado, ya que la generación automática de fórmulas ya no tendrá lugar para la tarjeta, y no se puede volver a bloquear una tarjeta.Unlocking a card is an advanced activity and should be done with care, because automatic formula generation will no longer occur for the card, and you can't relock a card.

Dentro del contenedor del formulario el registro EsteElemento está disponible y contiene todos los campos del registro.Within the form's container, the ThisItem record is available and contains all the fields of the record. Por ejemplo, la propiedad Default con frecuencia se establece en EsteElemento.FieldName.For example, the card's Default property is often set to ThisItem.FieldName.

Puede usar la referencia Parent para configurar un control que haga referencia a las propiedades de una tarjeta.You can use the Parent reference to configure a control to reference the properties of a card. Por ejemplo, un control debe usar Parent.Default para leer el estado inicial del campo del origen de datos.For example, a control should use Parent.Default to read the initial state of the field from the data source. Al usar Parent en lugar de acceder directamente a la información que desea, la tarjeta está mejor encapsulada y puede cambiarla a un campo diferente sin romper fórmulas internas.By using Parent instead of directly accessing the information that you want, the card is better encapsulated, and you can change it to a different field without breaking internal formulas.

Consulte Understand data cards (Introducción a las tarjetas de datos) para ver ejemplos de cómo personalizar, desbloquear y crear tarjetas.See Understand data cards for examples of how to customize, unlock, and create cards.

Propiedades principalesKey properties

DataField: el nombre del campo dentro de un registro que esta tarjeta muestra y edita.DataField – The name of the field within a record that this card displays and edits.

  • Especifique el nombre como una sola cadena estática incluida entre comillas dobles (por ejemplo, "Nombre"), no una fórmula.Specify the name as a single static string that's enclosed in double quotation marks (for example, "Name"), not a formula.
  • Para desenlazar una tarjeta, establezca su propiedad DataFielden blanco.Unbind a card by setting its DataField property blank. Las propiedades Valid y Actualizar se ignoran en las tarjetas desenlazadas.The Valid and Update properties are ignored for unbound cards.

Predeterminado: el valor inicial de un control antes de que lo cambie el usuario.Default – The initial value of a control before it is changed by the user.

  • Para cada control de una tarjeta, establezca esta propiedad en Parent.Default para hacer referencia al valor predeterminado del campo según el origen de datos.For each control in a card, set this property to Parent.Default to refer to the default value of the field according to the data source. Por ejemplo, establezca la propiedad Default de un control deslizante en Parent.Default para garantizar que el usuario comienza con un valor genérico para ese control deslizante.For example, set a slider's Default property to Parent.Default to ensure that the user starts with a generic value for that slider.

DisplayMode: los valores pueden ser Edit, View o Disabled.DisplayMode – Values can be Edit, View, or Disabled. Permite configurar si el control de la tarjeta permite entradas de usuario (Edit), solo muestra datos (View) o si está deshabilitado (Disabled).Configures whether the control inside the card allows user input (Edit), only displays data (View) or is disabled (Disabled).

  • Mediante la configuración de esta propiedad, que está vinculada al comportamiento predeterminado del formulario, se permite que se pueda usar una sola tarjeta en los formularios Edit y View.Allows a single card to be used in both edit and view forms, by configuring this property, which is tied to the Form's behavior by default.
  • En el modo View, los controles secundarios como Entrada de texto, Lista desplegable y Selector de fecha solo mostrarán el valor del texto y no representarán ninguna otra decoración ni elemento interactivo.In View mode, child controls such as Text input, Drop down, Date Picker will only display the text value and will not render any interactive elements or decorations.

DisplayName: el nombre descriptivo de un campo en un origen de datos.DisplayName – The user friendly name for a field in a data source.

  • La función DataSourceInfo proporciona estos metadatos desde el origen de datos.The DataSourceInfo function provides this metadata from the data source.
  • Los controles de la tarjeta deben usar Parent.DisplayName para hacer referencia al nombre del campo.Controls within the card should use Parent.DisplayName to refer to the name of the field.

Error: el mensaje de error descriptivo para mostrar de este campo cuando se produce un error de validación.Error – The user friendly error message to display for this field when validation fails.

  • Esta propiedad se establece cuando se llama a SubmitForm.This property is set when SubmitForm is called.
  • El mensaje describe los problemas de validación basándose en los metadatos del origen de datos y la comprobación de la propiedad Required de la tarjeta.The message describes validation problems based on the data source's metadata and checking the card's Required property.

Required: indica si una tarjeta, al editar el campo de un origen de datos, debe contener un valor.Required – Whether a card, editing the field of a data source, must contain a value.

  • La función DataSourceInfo proporciona los metadatos necesarios desde el origen de datos.The DataSourceInfo function provides the required metadata from the data source.
  • Los controles dentro de la tarjeta deben usar Parent.Required para determinar si el campo de la tarjeta es obligatorio.Controls within the card should use Parent.Required to determine whether that card's field is required.

Actualizar: el valor para escribir en el origen de datos de un campo.Update – The value to write back to the data source for a field.

  • Use la fórmula de esta propiedad para extraer los valores de los controles de edición de la tarjeta con el fin de escribir en el origen de datos.Use this property's formula to pull the values from the edit controls of the card in order to write back to the data source. Por ejemplo, establezca la propiedad Actualizar en Slider.Value para actualizar el origen de datos con un valor del control deslizante de esa tarjeta.For example, set a card's Update property to Slider.Value to update the data source with a value from the slider in that card.

Width: la distancia entre los bordes derecho e izquierdo de un control.Width – The distance between a control's left and right edges.

WidthFit: indica si un control crece automáticamente en la horizontal para rellenar el espacio vacío de un control de contenedor como el control Formulario de edición.WidthFit – Whether a control automatically grows horizontally to fill any empty space in a container control such as an Edit form control. Si varias tarjetas tienen esta propiedad establecida en true, el espacio se divide entre ellas.If multiple cards have this property set to true, the space is divided between them. Para más información, consulte Understand data form layout in Microsoft PowerApps (Introducción al diseño de formularios de datos en Microsoft PowerApps).For more information, see Understand data form layout.

Propiedades adicionalesAdditional properties

BorderColor: el color de un borde del control.BorderColor – The color of a control's border.

BorderStyle: si el borde del control es Solid, Dashed, Dotted o None.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness: el grosor de un borde del control.BorderThickness – The thickness of a control's border.

Fill: el color de fondo de un control.Fill – The background color of a control.

Height: la distancia entre los bordes superior e inferior de un control.Height – The distance between a control's top and bottom edges.

Valid: indica si un control Card o Edit form contiene entradas válidas listas para enviarse al origen de datos.Valid – Whether a Card or Edit form control contains valid entries, ready to be submitted to the data source.

Visible: indica si un control aparece o está oculto.Visible – Whether a control appears or is hidden.

X: la distancia entre el borde izquierdo de un control y el borde izquierdo de su contenedor primario (la pantalla si no hay un contenedor primario).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container). Para un control Tarjeta en un contenedor con varias columnas, esta propiedad determina la columna en la que aparece la tarjeta.For a Card control in a container that has multiple columns, this property determines the column in which the card appears.

Y: la distancia entre el borde superior de un control y el borde superior de su contenedor primario (la pantalla si no hay un contenedor primario).Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container). Para un control Tarjeta en un contenedor con varias filas, esta propiedad determina la fila en la que aparece la tarjeta.For a Card control in a container that has multiple rows, this property determines the row in which the card appears.

EjemplosExamples

Encontrará ejemplos en Tarjetas de datos y la introducción al diseño de los formularios de datos.See Understand data cards and Understand data form layout for examples.