Controlo de cartão no PowerAppsCard control in PowerApps

Proporciona a experiência de visualização e edição para um único campo de um controlo Mostrar 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 controlos Mostrar formulário e Editar formulário atuam como contentores para a apresentação e visualização de registos completos.Display form and Edit form controls act as containers for displaying and viewing entire records. Cada contentor pode conter um conjunto de controlos de Cartão que apresentam campos individuais ou fornecem uma forma 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 que campo do registo funciona.Each card has a DataField property that specifies which field of the record it works on.

Os cartões predefinidos são definidos para diferentes tipos de dados e experiências de utilizador.Predefined cards are defined for different data types and user experiences. Por exemplo, poderá haver um cartão para editar um campo numérico com um controlo de Entrada de texto, que é excelente para ser utilizado com o 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 poderá suportar a edição de um número através da utilização de um controlo de Deslize.Another card might support editing a number by using a Slider control instead. Com o controlo de formulário selecionado, pode, no painel da direita, selecionar facilmente um cartão com base num campo.With the form control selected, you can, in the right-hand pane, easily select a card based on a field.

Os próprios cartões contêm controlos.Cards themselves contain controls. Os controlos de um cartão compõem a experiência para apresentar e editar 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 ser constituído por um controlo Etiqueta para fornecer o nome a apresentar do campo e um controlo Entrada de texto para fornecer um editor para o 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 controlo Etiqueta que mostra eventuais erros de validação que ocorrem e um controlo Etiqueta para o asterisco comum para indicar 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.

Pode personalizar os controlos de um cartão predefinido ao redimensioná-lo, movê-lo, ocultá-lo, adicionar controlos ao mesmo e fazer 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 pode começar com um cartão totalmente em branco, um "cartão personalizado", ao qual adiciona controlos a partir 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 predefinição.Predefined cards are locked by default. Num cartão bloqueado, só pode modificar algumas propriedades do cartão ou dos controlos no cartão e não é possível eliminar 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. Pode mostrar o bloqueio do cartão e desbloqueá-lo no separador Ver da vista Avançada.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 for possível modificá-la, é apresentada com um ícone de cadeado junto do respetivo 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 realizada com cuidado, porque a geração automática de fórmulas já não irá ocorrer para o cartão e não é possível voltar a bloquear um cartão.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.

No contentor do formulário, o registo ThisItem está disponível e contém todos os campos do registo.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 está, muitas vezes, definida como ThisItem.FieldName.For example, the card's Default property is often set to ThisItem.FieldName.

Pode utilizar a referência Principal para configurar um controlo para fazer referência às 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 controlo deve utilizar Parent.Default para ler o estado inicial do campo a partir da origem de dados.For example, a control should use Parent.Default to read the initial state of the field from the data source. Ao utilizar Principal em vez de aceder diretamente às informações que pretende, o cartão é melhor encapsulado e pode alterá-lo para um campo diferente sem quebrar as 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.

Veja Compreender os cartões 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 principaisKey properties

DataField – O nome do campo num registo que este cartão apresenta e edita.DataField – The name of the field within a record that this card displays and edits.

  • Especifique o nome como uma cadeia estática única entre aspas (por exemplo, "Name") e 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.
  • Para desvincular um cartão, defina a respetiva propriedade DataField como blank.Unbind a card by setting its DataField property blank. As propriedades Valid e Update são ignoradas para cartões desvinculados.The Valid and Update properties are ignored for unbound cards.

Default – o valor inicial de um controlo antes de ser alterado pelo utilizador.Default – The initial value of a control before it is changed by the user.

  • Para cada controlo num cartão, defina esta propriedade como Parent.Default para fazer referência ao valor predefinido do campo, de acordo com a origem 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 controlo de deslize como Parent.Default para se certificar de que o utilizador começa com um valor genérico para esse controlo de deslize.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 Editar, Visualizar ou Desativado.DisplayMode – Values can be Edit, View, or Disabled. Configura se o controlo dentro do cartão permite a intervenção do utilizador (Editar), apenas apresenta os dados (Ver) ou está desativado (Desativado).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 utilizado nos formulários de edição e visualização, ao configurar esta propriedade, que está associada ao comportamento do Formulário por predefiniçã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 de Visualização, os controlos subordinados, tais como Introdução de texto, Menu pendente e Seletor de datas , apenas irão apresentar o valor de texto e não irão apresentar todos os elementos interativos ou decorações.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 amigável de utilizador para um campo numa origem de dados.DisplayName – The user friendly name for a field in a data source.

  • A função DataSourceInfo fornece estes metadados da origem de dados.The DataSourceInfo function provides this metadata from the data source.
  • Os controlos no cartão devem utilizar Parent.DisplayName para fazer referência 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 de utilizador a apresentar para este campo quando ocorre uma falha de validação.Error – The user friendly error message to display for this field when validation fails.

  • Esta propriedade é definida quando SubmitForm é chamada.This property is set when SubmitForm is called.
  • A mensagem descreve problemas de validação com base nos metadados da origem 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, editando o campo de uma origem de dados, tem de 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 necessários da origem de dados.The DataSourceInfo function provides the required metadata from the data source.
  • Os controlos no cartão devem utilizar Parent.Required para determinar se o campo desse cartão é necessário.Controls within the card should use Parent.Required to determine whether that card's field is required.

Update – O valor para efetuar um write back para a origem de dados de um campo.Update – The value to write back to the data source for a field.

  • Utilize a fórmula desta propriedade para extrair os valores dos controlos de edição do cartão para efetuar um write back para a origem 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 origem de dados com um valor do controlo de deslize 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.

Largura – a distância entre as margens esquerda e direita de um controlo.Width – The distance between a control's left and right edges.

WidthFit – Se um controlo aumenta automaticamente na horizontal para preencher qualquer espaço em branco de um controlo de contentor, como um controlo 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 vários cartões tiverem esta propriedade definida como verdadeiro, o espaço é dividido entre eles.If multiple cards have this property set to true, the space is divided between them. Para obter mais informações, veja Compreender o esquema dos formulários de dados.For more information, see Understand data form layout.

Propriedades adicionaisAdditional properties

BorderColor – a cor do limite de um controlo.BorderColor – The color of a control's border.

BorderStyle – se o limite do controlo é Sólido, Tracejado, Com pontos ou Nenhum.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness – a espessura do limite de um controlo.BorderThickness – The thickness of a control's border.

Preenchimento – a cor de fundo de um controlo.Fill – The background color of a control.

Altura – a distância entre as margens superiores e inferiores de um controlo.Height – The distance between a control's top and bottom edges.

Valid – Se um controlo de Cartão ou Editar formulário contiver entradas válidas, prontas para serem submetidas para a origem de dados.Valid – Whether a Card or Edit form control contains valid entries, ready to be submitted to the data source.

Visível – se um controlo é apresentado ou está oculto.Visible – Whether a control appears or is hidden.

X – A distância entre o limite esquerdo de um controlo e o limite esquerdo do respetivo contentor principal (do ecrã, se não existir um contentor principal).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 controlo Cartão num contentor que tem várias colunas, esta propriedade determina a coluna na qual o cartão é apresentado.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 o limite superior de um controlo e o limite superior do contentor principal (do ecrã, se não existir um contentor principal).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 controlo Cartão num contentor que tem várias linhas, esta propriedade determina a linha na qual o cartão aparece.For a Card control in a container that has multiple rows, this property determines the row in which the card appears.

ExemplosExamples

Veja Compreender os cartões dados e Compreender o esquema dos formulários de dados para obter exemplos.See Understand data cards and Understand data form layout for examples.