Condividi tramite


ContentPage

<.NET MAUI ContentPage.>

L'interfaccia utente dell'app multipiattaforma .NET (.NET MAUI) ContentPage visualizza una singola vista, che è spesso un layout come Grid o StackLayout, ed è il tipo di pagina più comune.

ContentPage definisce le proprietà seguenti:

  • Content, di tipo View, definisce la vista che rappresenta il contenuto della pagina.
  • HideSoftInputOnTapped, di tipo bool, che indica se toccando un punto qualsiasi della pagina verrà nascosta la tastiera virtuale, qualora sia visibile su Android e iOS.
  •  <a href="/dotnet/api/microsoft.maui.controls.contentpage.content#microsoft-maui-controls-contentpage-content" class="no-loc" data-linktype="absolute-path">Proprietà</a>, del tipo <a href="/dotnet/api/microsoft.maui.controls.view" class="no-loc" data-linktype="absolute-path">View</a>, che definisce la vista che rappresenta il contenuto della pagina.
  • HideSoftInputOnTapped, di tipo bool, che indica se toccando un punto qualsiasi della pagina, la tastiera di input soft verrà nascosta se è visibile in Android, iOS e Mac Catalyst.

Queste proprietà sono supportate da BindableProperty oggetti, il che significa che possono essere la destinazione di data binding e possono essere stilizzate.

Inoltre, eredita le proprietà associabili Title, IconImageSource, BackgroundImageSource, IsBusy, e Padding dalla classe Page.

Nota

La proprietà Content è la proprietà di contenuto della classe ContentPage, e pertanto non deve essere impostata in modo esplicito da XAML.

Le app .NET MAUI in genere contengono più pagine che derivano da ContentPage, e lo spostamento tra queste pagine può essere eseguito. Per ulteriori informazioni sulla navigazione delle pagine, vedere NavigationPage.

Un ContentPage può essere modellato utilizzando un modello di controllo. Per ulteriori informazioni, vedere Modelli di controllo.

Creare una pagina di contenuto

Per aggiungere un ContentPage a un'app .NET MAUI:

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto o sulla cartella nel progetto e selezionare Nuovo elemento....

  2. Nella finestra di dialogo Aggiungi Nuovo Elemento, espandere Elementi C# Installati, selezionare .NET MAUI, e selezionare il modello di elemento .NET MAUI ContentPage (XAML), immettere un nome di pagina appropriato e fare clic sul pulsante Aggiungi:

    Modello di elemento .NET MAUI ContentPage.

Visual Studio crea quindi una nuova pagina derivata da ContentPage, simile all'esempio seguente:

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MyMauiApp.MyPage"
             Title="MyPage"
             BackgroundColor="White">
    <StackLayout>
        <Label Text="Welcome to .NET MAUI!"
                VerticalOptions="Center"
                HorizontalOptions="Center" />
        <!-- Other views go here -->
    </StackLayout>
</ContentPage>

L'elemento figlio di un ContentPage è tipicamente un layout, come un Grid o StackLayout, e il layout in genere contiene più viste. Tuttavia, l'elemento figlio di ContentPage può essere una visualizzazione che visualizza una raccolta, ad esempio CollectionView.

Nota

Il valore della proprietà Title verrà visualizzato sulla barra di navigazione quando l'app esegue lo spostamento usando un NavigationPage. Per ulteriori informazioni, vedere NavigationPage.