Controllo Scheda in PowerAppsCard control in PowerApps

Consente la visualizzazione e la modifica di un campo singolo di un controllo Modulo visualizzazione o Modulo modifica .Provides the display and editing experience for a single field of a Display form or Edit form control.

DescrizioneDescription

I controlli Modulo visualizzazione e Modulo modifica fungono da contenitori per la visualizzazione di interi record.Display form and Edit form controls act as containers for displaying and viewing entire records. Ogni contenitore può contenere un set di controlli Scheda che visualizzano o consentono di aggiornare singoli campi.Each container can hold a set of Card controls that display individual fields or provide a way to update those fields. Per ogni scheda, la proprietà DataField specifica su quale campo del record è attivo il controllo.Each card has a DataField property that specifies which field of the record it works on.

Le schede predefinite riguardano tipi di dati ed esperienze utente diversi.Predefined cards are defined for different data types and user experiences. Una scheda, ad esempio, può essere destinata alla modifica di un campo numerico tramite un controllo Input di testo . È ideale per l'uso con la tastiera.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. Un'altra scheda, invece, può supportare la modifica di un numero tramite un controllo Dispositivo di scorrimento .Another card might support editing a number by using a Slider control instead. Dopo aver selezionato il controllo modulo, è possibile selezionare facilmente una scheda nel riquadro a destra in base al campo.With the form control selected, you can, in the right-hand pane, easily select a card based on a field.

Le schede stesse contengono controlli.Cards themselves contain controls. Sono i controlli all'interno della scheda a creare l'esperienza di visualizzazione e modifica di un campo singolo.The controls of a card make up the experience for displaying and editing a single field. Una scheda numerica, ad esempio, può essere costituita da un controllo Etichetta che specifica il nome visualizzato del campo e da un controllo Input di testo che rappresenta l'editor del valore 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 scheda può anche contenere un controllo Etichetta per visualizzare gli eventuali errori di convalida e un altro controllo Etichetta per l'asterisco, che indica comunemente che un campo è obbligatorio.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.

È possibile personalizzare i controlli di una scheda predefinita ridimensionandoli, spostandoli, nascondendoli, aggiungendone altri e modificandoli in altro modo.You can customize the controls of a predefined card by resizing it, moving it, hiding it, adding controls to it, and making other changes. È anche possibile iniziare con una scheda completamente vuota, una "scheda personalizzata", a cui aggiungere controlli da zero.You can also start with an entirely blank card, a "custom card", to which you add controls from scratch.

Le schede predefinite sono bloccate per impostazione predefinita.Predefined cards are locked by default. In una scheda bloccata è possibile modificare solo determinate proprietà della scheda o dei controlli all'interno di questa. Non è possibile eliminare una scheda bloccata.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. È possibile visualizzare il blocco della scheda e sbloccare quest'ultima nella scheda Visualizza della visualizzazione Avanzata.You can show the card lock and unlock it on the View tab of the Advanced view. Se una proprietà è bloccata e non può essere modificata, accanto al nome è visualizzata l'icona di blocco.If a property is locked and can't be modified, it appears with a lock icon next to its name. Lo sblocco di una scheda è un'attività avanzata e deve essere eseguita con prudenza. Per una scheda sbloccata, infatti, non viene più eseguita la generazione automatica delle formule. In più, non è possibile bloccare di nuovo una scheda sbloccata.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.

All'interno del contenitore del modulo è disponibile il record ThisItem, contenente tutti i campi del record.Within the form's container, the ThisItem record is available and contains all the fields of the record. La proprietà Default delle schede, ad esempio, è spesso impostata su ThisItem. NomeCampo.For example, the card's Default property is often set to ThisItem.FieldName.

Per configurare un controllo in modo che faccia riferimento alle proprietà di una scheda, è possibile usare il riferimento Parent.You can use the Parent reference to configure a control to reference the properties of a card. Un controllo, ad esempio, deve usare Parent.Default per leggere lo stato iniziale del campo dall'origine dati.For example, a control should use Parent.Default to read the initial state of the field from the data source. Usando Parent anziché l'accesso diretto alle informazioni volute, l'incapsulamento della scheda è più efficiente ed è possibile cambiare il campo a cui la scheda fa riferimento in un altro campo senza compromettere il funzionamento delle formule interne.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.

Per alcuni esempi di personalizzazione, sblocco e creazione di schede, vedere Informazioni sulle schede dati.See Understand data cards for examples of how to customize, unlock, and create cards.

Proprietà chiaveKey properties

DataField: nome del campo in un record visualizzato e modificato dalla scheda corrente.DataField – The name of the field within a record that this card displays and edits.

  • Specificare il nome come unica stringa statica racchiusa tra virgolette doppie (ad esempio, "Nome"), non come formula.Specify the name as a single static string that's enclosed in double quotation marks (for example, "Name"), not a formula.
  • Annullare l'associazione di una scheda impostando la proprietà DataField su blank.Unbind a card by setting its DataField property blank. Per le schede non associate le proprietà Valid e Update vengono ignorate.The Valid and Update properties are ignored for unbound cards.

Default: valore iniziale di un controllo prima della modifica da parte dell'utente.Default – The initial value of a control before it is changed by the user.

  • Per ogni controllo in una scheda, impostare questa proprietà su Parent.Default per fare riferimento al valore predefinito del campo in base all'origine dati.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. Ad esempio, impostare la proprietà Default di un dispositivo di scorrimento su Parent.Default per garantire che all'inizio il dispositivo di scorrimento presenti all'utente un valore generico.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: i valori possono essere Edit, View o Disabled.DisplayMode – Values can be Edit, View, or Disabled. Configura se il controllo all'interno della scheda consente l'input dell'utente (Edit), visualizza solo i dati (View) o è disabilitato (Disabled).Configures whether the control inside the card allows user input (Edit), only displays data (View) or is disabled (Disabled).

  • Consente di usare una sola scheda nei moduli di modifica e di visualizzazione, con la configurazione di questa proprietà, che è collegata al comportamento del modulo per impostazione predefinita.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.
  • In modalità Visualizzazione, i controlli figlio come Input di testo, Elenco a discesa e Selezione data visualizzeranno solo il valore del testo e non eseguiranno il rendering di nessun elemento o decorazione interattivi.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: nome descrittivo per un campo in un'origine dati.DisplayName – The user friendly name for a field in a data source.

  • La funzione DataSourceInfo ricava questi metadati dall'origine dati.The DataSourceInfo function provides this metadata from the data source.
  • Per fare riferimento al nome del campo, i controlli all'interno della scheda devono usare Parent.DisplayName.Controls within the card should use Parent.DisplayName to refer to the name of the field.

Error: messaggio di errore descrittivo da visualizzare se la convalida non riesce.Error – The user friendly error message to display for this field when validation fails.

  • Questa proprietà viene impostata quando viene chiamato il metodo SubmitForm.This property is set when SubmitForm is called.
  • Il messaggio descrive i problemi di convalida in base ai metadati dell'origine dati e alla proprietà Requireddella scheda.The message describes validation problems based on the data source's metadata and checking the card's Required property.

Required: indica se dopo la modifica del campo dell'origine dati la scheda deve contenere un valore.Required – Whether a card, editing the field of a data source, must contain a value.

  • La funzione DataSourceInfo ricava i metadati obbligatori dall'origine dati.The DataSourceInfo function provides the required metadata from the data source.
  • Per determinare se il campo della scheda è obbligatorio, i controlli all'interno della scheda devono usare Parent.Required.Controls within the card should use Parent.Required to determine whether that card's field is required.

Update: valore da scrivere nuovamente nell'origine dati per un campo.Update – The value to write back to the data source for a field.

  • Usare la formula di questa proprietà per estrarre dai controlli di modifica della scheda i valori da scrivere di nuovo nell'origine dati.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. Ad esempio, impostare la proprietà Update di una scheda su Slider.Value per aggiornare l'origine dati con un valore del dispositivo di scorrimento della scheda stessa.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: distanza tra i bordi sinistro e destro di un controllo.Width – The distance between a control's left and right edges.

WidthFit: indica se un controllo si espande automaticamente in senso orizzontale per riempire lo spazio vuoto in un controllo del contenitore, ad esempio un controllo Modulo di modifica.WidthFit – Whether a control automatically grows horizontally to fill any empty space in a container control such as an Edit form control. Se più schede hanno questa proprietà impostata su true, lo spazio è suddiviso tra di esse.If multiple cards have this property set to true, the space is divided between them. Per altre informazioni, vedere Informazioni sul layout dei moduli dati.For more information, see Understand data form layout.

Proprietà aggiuntiveAdditional properties

BorderColor: colore del bordo di un controllo.BorderColor – The color of a control's border.

BorderStyle: indica se il bordo di un controllo è Solid (Tinta unita), Dashed (Tratteggiato), Dotted (Punteggiato) o None (Nessuno).BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness: spessore del bordo di un controllo.BorderThickness – The thickness of a control's border.

Fill: colore dello sfondo di un controllo.Fill – The background color of a control.

Height: distanza tra i bordi superiore e inferiore del controllo.Height – The distance between a control's top and bottom edges.

Valid: indica se un controllo Scheda o Modulo modifica contiene voci valide pronte per l'invio all'origine dati.Valid – Whether a Card or Edit form control contains valid entries, ready to be submitted to the data source.

Visible: indica se un controllo viene visualizzato o è nascosto.Visible – Whether a control appears or is hidden.

X: distanza tra il bordo sinistro di un controllo e il bordo sinistro del contenitore padre, schermata se non c'è un contenitore padre.X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container). Per un controllo Scheda in un contenitore che comprende più colonne, questa proprietà determina la colonna in cui verrà visualizzata la scheda.For a Card control in a container that has multiple columns, this property determines the column in which the card appears.

X: distanza tra il bordo superiore di un controllo e il bordo superiore del contenitore padre, schermata se non c'è un contenitore padre.Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container). Per un controllo Scheda in un contenitore che comprende più righe, questa proprietà determina la riga in cui verrà visualizzata la scheda.For a Card control in a container that has multiple rows, this property determines the row in which the card appears.

EsempiExamples

Vedere Informazioni sulle schede dati e Informazioni sul layout dei moduli dati per gli esempi.See Understand data cards and Understand data form layout for examples.