Oggetto app in PowerAppsApp object in PowerApps

Fornisce informazioni sull'applicazione attualmente in esecuzione e il controllo sul comportamento dell'app.Provides information about the currently running app and control over the app's behavior.

DescriptionDescription

Analogamente a un controllo, l'oggetto app fornisce proprietà che identificano la schermata visualizzata e che richiedono all'utente di salvare le modifiche in modo che non vadano perse.Like a control, the App object provides properties that identify which screen is showing and that prompt the user to save changes so that they're not lost. Ogni app dispone di un oggetto app .Every app has an App object.

È possibile scrivere formule per alcune proprietà dell'oggetto app .You can write formulas for some properties of the App object. Nella parte superiore del riquadro visualizzazione albero selezionare l'oggetto app come qualsiasi altro controllo o schermata.At the top of the Tree view pane, select the App object as you would any other control or screen. Per visualizzare e modificare una delle proprietà dell'oggetto, selezionarlo nell'elenco a discesa a sinistra della barra della formula.View and edit one of the object's properties by selecting it in the drop-down list to the left of the formula bar.

l'oggetto app nel riquadro visualizzazione alberoThe App object in the Tree view pane

Proprietà ActiveScreenActiveScreen property

La proprietà ActiveScreen identifica la schermata che viene visualizzata.The ActiveScreen property identifies the screen that's showing.

Questa proprietà restituisce un oggetto Screen, che è possibile usare per fare riferimento alle proprietà dello schermo o confrontare con un'altra schermata per determinare la schermata visualizzata.This property returns a screen object, which you can use to reference properties of the screen or compare to another screen to determine which screen is showing. È anche possibile usare l'espressione app.ActiveScreen.Name per recuperare il nome della schermata visualizzata.You can also use the expression App.ActiveScreen.Name to retrieve the name of the screen that's showing.

Usare la funzione back o Navigate per modificare la schermata visualizzata.Use the Back or Navigate function to change the screen that's showing.

Proprietà OnStartOnStart property

La proprietà OnStart viene eseguita quando l'utente avvia l'app.The OnStart property runs when the user starts the app. I creatori di app usano spesso questa proprietà per eseguire queste attività:App makers often use this property to perform these tasks:

  • Recuperare e memorizzare nella cache i dati nelle raccolte usando la funzione Collect .Retrieve and cache data into collections by using the Collect function.
  • Impostare le variabili globali utilizzando la funzione set .Set up global variables by using the Set function.
  • Passare a una schermata iniziale usando la funzione Navigate .Navigate to an initial screen by using the Navigate function.

Questa formula viene valutata prima che venga visualizzata la prima schermata.This formula is evaluated before the first screen appears. Non è stata caricata alcuna schermata, quindi non è possibile impostare le variabili di contesto con la funzione UpdateContext .No screen is loaded, so you can't set context variables with the UpdateContext function. Tuttavia, è possibile passare le variabili di contesto con la funzione Navigate .However, you can pass context variables with the Navigate function.

Dopo aver modificato la proprietà OnStart , testarla posizionando il puntatore del mouse sull'oggetto app nel riquadro visualizzazione albero , selezionando i puntini di sospensione (...) visualizzati e quindi facendo clic su Esegui OnStart.After you change the OnStart property, test it by hovering over the App object in the Tree view pane, selecting the ellipsis (...) that appears, and then selecting Run OnStart. Diversamente da quando l'app viene caricata per la prima volta, le raccolte e le variabili esistenti saranno già impostate.Unlike when the app is loaded for the first time, existing collections and variables will already be set. Per iniziare con raccolte vuote, usare la funzione ClearCollect anziché la funzione Collect .To start with empty collections, use the ClearCollect function instead of the Collect function.

menu di scelta rapida dell'elemento app per Esegui OnStartApp-item shortcut menu for Run OnStart

Proprietà di ConfirmExitConfirmExit properties

Nessuno desidera perdere le modifiche non salvate.Nobody wants to lose unsaved changes. Usare le proprietà ConfirmExit e ConfirmExitMessage per avvisare l'utente prima di chiudere l'app.Use the ConfirmExit and ConfirmExitMessage properties to warn the user before they close your app.

Nota

ConfirmExit non funziona nelle app incorporate in, ad esempio Power bi e SharePoint.ConfirmExit doesn't work in apps that are embedded in, for example, Power BI and SharePoint.

Nota

Al momento, queste proprietà possono fare riferimento ai controlli solo nella prima schermata se è abilitata la funzionalità Anteprima caricamento ritardato (impostazione predefinita per le nuove app).At present, these properties can reference controls on only the first screen if the Delayed load preview feature is enabled (which it is by default for new apps). Se vengono creati riferimenti, PowerApps Studio non visualizza un errore, ma l'app pubblicata risultante non viene aperta in PowerApps mobile o in un browser.If references are made, PowerApps Studio doesn't show an error, but the resulting published app doesn't open in PowerApps Mobile or a browser. Stiamo lavorando attivamente per revocare questa limitazione.We're actively working to lift this limitation. Nel frattempo, è possibile disattivare il caricamento ritardato nelle impostazioni dell'App file > > Impostazioni avanzate (in funzionalità di anteprima).In the meantime, you can turn off Delayed load in File > App settings > Advanced settings (under Preview features).

ConfirmExitConfirmExit

ConfirmExit è una proprietà booleana che, se impostata su true, apre una finestra di dialogo di conferma prima che l'app venga chiusa.ConfirmExit is a Boolean property that, when true, opens a confirmation dialog box before the app is closed. Per impostazione predefinita, questa proprietà è falsee non viene visualizzata alcuna finestra di dialogo.By default, this property is false, and no dialog box appears.

Utilizzare questa proprietà per visualizzare una finestra di dialogo di conferma se l'utente ha apportato modifiche ma non è stato salvato.Use this property to show a confirmation dialog box if the user has made changes but not saved them. Usare una formula che consente di controllare le variabili e le proprietà del controllo, ad esempio la proprietà non salvata del controllo modifica modulo .Use a formula that can check variables and control properties (for example, the Unsaved property of the Edit form control).

La finestra di dialogo di conferma viene visualizzata in qualsiasi situazione in cui i dati potrebbero andare perduti, come negli esempi seguenti:The confirmation dialog box appears in any situation where data could be lost, as in these examples:

  • Esecuzione della funzione Exit .Running the Exit function.
  • Se l'app è in esecuzione in un browser:If the app is running in a browser:
    • Chiudere il browser o la scheda del browser in cui è in esecuzione l'app.Closing the browser or the browser tab in which the app is running.
    • Selezione del pulsante indietro del browser.Selecting the browser's back button.
  • Se l'app è in esecuzione in PowerApps mobile (iOS o Android):If the app is running in PowerApps Mobile (iOS or Android):
    • Esecuzione della funzione Launch .Running the Launch function.
      La funzione Launch non attiva la finestra di dialogo in un browser perché si apre un'altra scheda in modo che i dati non vadano perduti.The Launch function doesn't trigger the dialog box in a browser because another tab opens so that data isn't lost.
    • Scorrimento rapido per passare a un'altra app in PowerApps mobile.Swiping to switch to a different app in PowerApps Mobile.
    • Selezione del pulsante indietro in un dispositivo Android.Selecting the back button on an Android device.

L'aspetto esatto della finestra di dialogo di conferma potrebbe variare tra i dispositivi e le versioni di PowerApps.The exact look of the confirmation dialog box might vary across devices and versions of PowerApps.

La finestra di dialogo di conferma non viene visualizzata in PowerApps Studio.The confirmation dialog box doesn't appear in PowerApps Studio.

ConfirmExitMessageConfirmExitMessage

Per impostazione predefinita, nella finestra di dialogo di conferma viene visualizzato un messaggio generico, ad esempio "è possibile che siano presenti modifiche non salvate".By default, the confirmation dialog box shows a generic message, such as "You may have unsaved changes." nella lingua dell'utente.in the user's language.

Utilizzare ConfirmExitMessage per fornire un messaggio personalizzato nella finestra di dialogo di conferma.Use ConfirmExitMessage to provide a custom message in the confirmation dialog box. Se questa proprietà è vuota, viene utilizzato il valore predefinito.If this property is blank, the default value is used. I messaggi personalizzati vengono troncati in base alle esigenze per adattarsi alla finestra di dialogo di conferma, quindi è consigliabile lasciare al massimo il messaggio.Custom messages are truncated as necessary to fit within the confirmation dialog box, so keep the message to a few lines at most.

In un browser, la finestra di dialogo di conferma potrebbe essere visualizzata con un messaggio generico dal browser.In a browser, the confirmation dialog box might appear with a generic message from the browser.

EsempioExample

  1. Creare un'app che contiene due controlli modulo, AccountForm e ContactForm.Create an app that contains two form controls, AccountForm and ContactForm.

  2. Impostare la proprietà ConfirmExit dell'oggetto app su questa espressione:Set the App object's ConfirmExit property to this expression:

    AccountForm.Unsaved Or ContactForm.Unsaved
    

    Questa finestra di dialogo viene visualizzata se l'utente modifica i dati in un form, quindi tenta di chiudere l'app senza salvare le modifiche.This dialog box appears if the user changes data in either form and then tries to close the app without saving those changes.

    finestra di dialogo di conferma genericaGeneric confirmation dialog box

  3. Impostare la proprietà ConfirmExitMessage dell'oggetto app sulla formula seguente:Set the App object's ConfirmExitMessage property to this formula:

    If( AccountsForm.Unsaved;
        "Accounts form has unsaved changes.";
        "Contacts form has unsaved changes."
    )
    

    Questa finestra di dialogo viene visualizzata se l'utente modifica i dati nel form dell'account e tenta di chiudere l'app senza salvare le modifiche.This dialog box appears if the user changes data in the Account form and then tries to close the app without saving those changes.

    finestra di dialogo di conferma specifica del moduloForm-specific confirmation dialog box