Controle Cartão no PowerAppsCard control in PowerApps

Oferece uma experiência de exibição e edição para um único campo do controle Exibir formulário ou Editar formulário.Provides the display and editing experience for a single field of a Display form or Edit form control.

DescriçãoDescription

Os controles Exibir formulário e Editar formulário agem como contêineres para exibir registros inteiros.Display form and Edit form controls act as containers for displaying and viewing entire records. Cada contêiner pode armazenar um conjunto de controles Cartão que exibem campos individuais ou fornecem uma maneira de atualizar esses campos.Each container can hold a set of Card controls that display individual fields or provide a way to update those fields. Cada cartão tem uma propriedade DataField que especifica em qual campo do registro ele funciona.Each card has a DataField property that specifies which field of the record it works on.

Os cartões predefinidos são configurados para diferentes tipos de dados e experiências do usuário.Predefined cards are defined for different data types and user experiences. Por exemplo, pode haver um cartão para editar um campo numérico com um controle Entrada de texto, que é ideal para uso com 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. Outro cartão pode oferecer suporte à edição de um número com um controle Controle deslizante.Another card might support editing a number by using a Slider control instead. Com o controle Formulário selecionado, você pode, no painel direito, selecionar facilmente um cartão com base em um campo.With the form control selected, you can, in the right-hand pane, easily select a card based on a field.

Os cartões contêm controles.Cards themselves contain controls. Os controles de um cartão viabilizam a experiência de exibição e edição de um único campo.The controls of a card make up the experience for displaying and editing a single field. Por exemplo, um cartão numérico pode consistir em um controle Rótulo para fornecer o nome de exibição do campo e em um controle Entrada de texto para fornecer um editor ao valor do 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. O cartão também pode ter um controle Rótulo que mostra os erros de validação ocorridos e um controle Rótulo para o asterisco que indica que um campo é obrigatório.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.

Você pode personalizar os controles de um cartão predefinido redimensionando-o, movendo-o, ocultando-o, adicionando controles a ele e fazendo outras alterações.You can customize the controls of a predefined card by resizing it, moving it, hiding it, adding controls to it, and making other changes. Também é possível começar com um cartão inteiramente em branco, um "cartão personalizado", ao qual você adiciona controles do zero.You can also start with an entirely blank card, a "custom card", to which you add controls from scratch.

Os cartões predefinidos estão bloqueados por padrão.Predefined cards are locked by default. Em um cartão bloqueado, você pode modificar apenas determinadas propriedades do cartão ou os controles no cartão, mas não pode excluir um cartão bloqueado.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. Você pode mostrar o bloqueio do cartão e desbloqueá-lo na guia Exibição da exibição Avançado.You can show the card lock and unlock it on the View tab of the Advanced view. Se uma propriedade estiver bloqueada e não puder ser modificada, ela será exibida com um ícone de bloqueio ao lado do seu nome.If a property is locked and can't be modified, it appears with a lock icon next to its name. Desbloquear um cartão é uma atividade avançada e deve ser feita com cuidado, porque a geração automática da fórmula não ocorrerá mais para o cartão, e você não poderá bloquear um cartão novamente.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 do contêiner do formulário, o registro ThisItem está disponível e contém todos os campos do registro.Within the form's container, the ThisItem record is available and contains all the fields of the record. Por exemplo, a propriedade Default do cartão geralmente está definida para ThisItem.FieldName.For example, the card's Default property is often set to ThisItem.FieldName.

Você pode usar a referência Parent para configurar um controle que consulta as propriedades de um cartão.You can use the Parent reference to configure a control to reference the properties of a card. Por exemplo, um controle pode usar Parent.Default para ler o estado inicial do campo na fonte de dados.For example, a control should use Parent.Default to read the initial state of the field from the data source. Usando Parent em vez de acessar diretamente as informações que você deseja, o cartão é melhor encapsulado, e você pode alterá-lo para um campo diferente sem quebrar 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 Entender cartões de dados para obter exemplos de como personalizar, desbloquear e criar cartões.See Understand data cards for examples of how to customize, unlock, and create cards.

Propriedades-chaveKey properties

DataField – o nome do campo no registro em que esse cartão permite exibições e edições.DataField – The name of the field within a record that this card displays and edits.

  • Especifique o nome como uma única cadeia de caracteres estática, escrita entre aspas duplas (por exemplo, "Nome"), não uma fórmula.Specify the name as a single static string that's enclosed in double quotation marks (for example, "Name"), not a formula.
  • Desassocie um cartão definindo sua propriedade DataField como blank.Unbind a card by setting its DataField property blank. As propriedades Valid e Update são ignoradas para os cartões desassociados.The Valid and Update properties are ignored for unbound cards.

Default – o valor inicial de um controle antes de ele ser alterado pelo usuário.Default – The initial value of a control before it is changed by the user.

  • Para cada controle em um cartão, defina essa propriedade como Parent.Default para consultar o valor padrão do campo de acordo com a fonte de dados.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 exemplo, defina a propriedade Default de um controle deslizante como Parent.Default para garantir que o usuário comece com um valor genérico para esse controle 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 – os valores podem ser Edição, Exibição ou Desabilitado.DisplayMode – Values can be Edit, View, or Disabled. Configura se o controle dentro do cartão permite entrada do usuário (Edição), apenas exibe dados (Exibição) ou está desabilitado (Desabilitado).Configures whether the control inside the card allows user input (Edit), only displays data (View) or is disabled (Disabled).

  • Permite que um único cartão seja usado em formulários de edição e exibição por meio da configuração dessa propriedade, que é vinculada a um comportamento do Formulário por padrão.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.
  • No modo Exibição, controles filho como Entrada de texto, Lista suspensa e Seletor de Data só exibirão o valor de texto e não renderizarão nenhum elemento interativo nem decoração.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 – o nome de usuário amigável para um campo da fonte de dados.DisplayName – The user friendly name for a field in a data source.

  • A função DataSourceInfo fornece esses metadados da fonte de dados.The DataSourceInfo function provides this metadata from the data source.
  • Os controles no cartão devem usar Parent.DisplayName para se referir ao nome do campo.Controls within the card should use Parent.DisplayName to refer to the name of the field.

Error – a mensagem de erro amigável ao usuário que é exibida para esse campo quando a validação falhar.Error – The user friendly error message to display for this field when validation fails.

  • Essa propriedade é definida quando a função SubmitForm é chamada.This property is set when SubmitForm is called.
  • A mensagem descreve problemas de validação com base nos metadados da fonte de dados e na verificação da propriedade Required do cartão.The message describes validation problems based on the data source's metadata and checking the card's Required property.

Required – se um cartão, que está editando o campo de uma fonte de dados, deve conter um valor.Required – Whether a card, editing the field of a data source, must contain a value.

  • A função DataSourceInfo fornece os metadados exigidos da fonte de dados.The DataSourceInfo function provides the required metadata from the data source.
  • Os controles no cartão devem usar Parent.Required para determinar se o campo do cartão é obrigatório.Controls within the card should use Parent.Required to determine whether that card's field is required.

Update – o valor para fazer write-back para um campo da fonte de dados.Update – The value to write back to the data source for a field.

  • Use a fórmula dessa propriedade para obter os valores dos controles de edição do cartão para fazer write-back na fonte de dados.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 exemplo, defina a propriedade Update de um cartão como Slider.Value para atualizar a fonte de dados com um valor do controle deslizante nesse cartão.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 – a distância entre das bordas esquerda e direita de um controle.Width – The distance between a control's left and right edges.

WidthFit – indica se um controle cresce na horizontal automaticamente para preencher espaços vazios em um controle de contêiner, como o controle Editar formulário.WidthFit – Whether a control automatically grows horizontally to fill any empty space in a container control such as an Edit form control. Se diversos cartões tiverem essa propriedade definida como true, o espaço será dividido entre eles.If multiple cards have this property set to true, the space is divided between them. Para obter mais informações, consulte Entender o layout de formulário de dados.For more information, see Understand data form layout.

Propriedades adicionaisAdditional properties

BorderColor – a cor da borda do controle.BorderColor – The color of a control's border.

BorderStyle – se a borda do controle é Solid, Dashed, Dotted ou None.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness – a espessura da borda do controle.BorderThickness – The thickness of a control's border.

Fill – a cor da tela de fundo de um controle.Fill – The background color of a control.

Height – a distância entre a parte superior do controle e as bordas inferiores.Height – The distance between a control's top and bottom edges.

Valid – se um controle Cartão ou Editar formulário contém entradas válidas prontas para serem enviadas à fonte de dados.Valid – Whether a Card or Edit form control contains valid entries, ready to be submitted to the data source.

Visible – se um controle é exibido ou está oculto.Visible – Whether a control appears or is hidden.

X – a distância entre a borda esquerda de um controle e a borda esquerda de seu contêiner pai (tela, se não houver contêiner pai).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container). Para um controle Cartão em um contêiner com diversas colunas, essa propriedade determina a coluna em que o cartão aparecerá.For a Card control in a container that has multiple columns, this property determines the column in which the card appears.

Y – a distância entre a borda superior de um controle e a borda superior de seu contêiner pai (tela, se não houver contêiner pai).Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container). Para um controle Cartão em um contêiner com diversas linhas, essa propriedade determina a linha em que o cartão aparecerá.For a Card control in a container that has multiple rows, this property determines the row in which the card appears.

ExemplosExamples

Consulte Entender cartões de dados e Entender o layout de formulário de dados para obter exemplos.See Understand data cards and Understand data form layout for examples.