Window.SetTitleBar(UIElement) Metodo

Definizione

Spazio dei nomi:

Windows.UI.Xaml

Crea un elemento XAML che interagisce con il sistema come se fosse la barra del titolo.

public:
 virtual void SetTitleBar(UIElement ^ value) = SetTitleBar;

void SetTitleBar(UIElement const& value);

public void SetTitleBar(UIElement value);

function setTitleBar(value)

Public Sub SetTitleBar (value As UIElement)

Parametri

value

UIElement

Contenuto XAML personalizzato che deve fungere da barra del titolo. Per usare più oggetti, eseguirne il wrapping in un elemento contenitore, ad esempio uno derivato da Panel.

Commenti

Questo metodo consente di specificare un elemento XAML che interagisce con il sistema come se si tratta della barra del titolo della finestra dell'app. Quando si usa questo metodo, in genere si imposta la proprietà CoreApplicationViewTitleBar.ExtendViewIntoTitleBar su true per nascondere la barra del titolo di sistema predefinita. Tuttavia, anche quando la barra del titolo di sistema predefinita non è nascosta, questo può essere usato per rendere altre aree nell'app si comportano come la barra del titolo.

Usare la proprietà CoreApplicationView.TitleBar per ottenere l'istanza di CoreApplicationViewTitleBar per la finestra dell'app, come illustrato di seguito.

// Requires using Windows.ApplicationModel.Core
CoreApplicationView coreView = CoreApplication.GetCurrentView();
CoreApplicationViewTitleBar coreTitleBar = coreView.TitleBar;
coreTitleBar.ExtendViewIntoTitleBar = true;

// -- OR --

CoreApplication.GetCurrentView().TitleBar.ExtendViewIntoTitleBar = true;

Nota

Questo metodo non ha alcun effetto quando un'app viene eseguita in un dispositivo mobile, perché le app sono sempre a schermo intero nei dispositivi mobili e non hanno una barra del titolo della finestra.

Input

Quando si chiama questo metodo per impostare un UIElement XAML come barra del titolo, consente a Windows di gestire l'input sulla barra del titolo UIElement allo stesso modo in cui gestisce l'input sulla barra del titolo di sistema predefinita. Ad esempio, un utente può spostare la finestra trascinando XAML UIElement o richiamando il menu di scelta rapida della finestra facendo clic con il pulsante destro del mouse.

Ciò significa che l'app non riceve più l'input puntatore quando l'utente interagisce con UIElement di destinazione o i relativi figli usando tocco, mouse o penna. Tuttavia, è necessario gestire (o impedire) l'input della tastiera e determinare se il contenuto nella barra del titolo può ricevere lo stato attivo tramite tabulazione con la tastiera.

Layout e aspetto

È necessario aggiornare il contenuto visivo e il layout dell'UIElement di destinazione in risposta alle modifiche della barra del titolo, ad esempio visibilità e dimensioni.

Per corrispondere alla visibilità della barra del titolo di sistema, gestire l'evento CoreApplicationViewTitleBar.IsVisibleChanged e rispettare la proprietà CoreApplicationViewTitleBar.IsVisible visualizzando e nascondendo la barra del titolo personalizzata in base alle esigenze. Ciò garantisce che il contenuto della barra del titolo personalizzato sia nascosto correttamente quando la barra del titolo di sistema è nascosta; ad esempio, quando l'utente sceglie di visualizzare l'app in modalità schermo intero.

Per assicurarsi che la barra del titolo corrisponda alle dimensioni di altri elementi della barra del titolo, ad esempio il sistema always-present Ridurre, Ottimizzare e Chiudere i pulsanti, gestire l'evento CoreApplicationViewTitleBar.LayoutMetricsChanged e rispettare le proprietà CoreApplicationViewTitleBar.Height, SystemOverlayLeftInset e SystemOverlayRightInset.

I pulsanti predefiniti della barra del titolo, ad esempio Riduci, Ingrandisci e Chiudi, vengono sempre visualizzati dal sistema, quindi potresti anche voler modificare il colore in modo che corrisponda al contenuto della barra del titolo XAML personalizzato. A tale scopo, usare la proprietà Windows.UI.ViewManagement.ApplicationView.TitleBar per ottenere l'istanza di ApplicationViewTitleBar per la finestra dell'app. È quindi possibile impostare le varie proprietà dei colori in ApplicationViewTitleBar per modificare i pulsanti predefiniti.