AppWindow Classe

Definizione

Spazio dei nomi:

Microsoft.UI.Windowing

Rappresenta un contenitore gestito dal sistema per il contenuto di un'app.

public ref class AppWindow sealed

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppWindow final

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AppWindow

Public NotInheritable Class AppWindow

Ereditarietà

Object Platform::Object IInspectable AppWindow

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Commenti

Important

Le API di personalizzazione della barra del titolo sono parzialmente supportate nelle Windows 10 a partire da SDK per app di Windows 1.2 e completamente supportate in Windows 11. Devi controllare AppWindowTitleBar.IsCustomizationSupported nel codice prima di chiamare queste API per assicurarti che l'app non si arresti in modo anomalo in altre versioni di Windows. Per altre informazioni, vedi Personalizzazione della barra del titolo .

Proprietà

Nome	Descrizione
ClientSize	Ottiene le dimensioni correnti dell'area client della finestra nelle coordinate del client Win32.
DispatcherQueue	Ottiene la coda dispatcher associata alla finestra dell'app.
Id	Ottiene l'identificatore per la finestra dell'app.
IsShownInSwitchers	Ottiene o imposta un valore che indica se questa finestra verrà visualizzata in varie rappresentazioni di sistema, ad esempio ALT+TAB e barra delle applicazioni.
IsVisible	Ottiene un valore che indica se viene visualizzata la finestra.
OwnerWindowId	Ottiene l'identificatore del proprietario di questa finestra; o 0 se non è di proprietà.
Position	Ottiene la posizione corrente della finestra nelle coordinate dello schermo.
Presenter	Ottiene il relatore attualmente applicato per la finestra dell'app.
Size	Ottiene le dimensioni correnti della finestra nelle coordinate dello schermo.
Title	Ottiene o imposta il titolo visualizzato della finestra dell'app.
TitleBar	Ottiene la barra del titolo della finestra dell'app.

Metodi

Nome	Descrizione
AssociateWithDispatcherQueue(DispatcherQueue)	Associa la finestra dell'app alla coda del dispatcher specificata.
Create()	Crea una finestra dell'app con gli stili e le proprietà impostati su quello dell'oggetto predefinito OverlappedPresenter.
Create(AppWindowPresenter, WindowId, DispatcherQueue)	Crea una finestra con stili e proprietà, come definito nell'oggetto specificato AppWindowPresenter, padre della finestra specificata e associata all'oggetto specificato DispatcherQueue.
Create(AppWindowPresenter, WindowId)	Crea una finestra con stili e proprietà, come definito nell'oggetto specificato AppWindowPresenter e padre nella finestra specificata.
Create(AppWindowPresenter)	Crea una finestra con stili e proprietà, come definito nell'oggetto specificato AppWindowPresenter.
Destroy()	Tenta di eliminare definitivamente la finestra dell'app.
GetFromWindowId(WindowId)	Restituisce con l'oggetto AppWindow specificato WindowId, se disponibile. Restituisce null se non è possibile associare l'oggetto WindowId a una finestra valida.
Hide()	Nasconde la finestra da tutte le rappresentazioni dell'esperienza utente nel sistema, ma mantiene attivo l'oggetto.
Move(PointInt32)	Sposta la finestra sul punto specificato nelle coordinate dello schermo.
MoveAndResize(RectInt32, DisplayArea)	Sposta la finestra sul punto specificato all'interno dell'area di visualizzazione specificata e la imposta sulla dimensione specificata.
MoveAndResize(RectInt32)	Sposta la finestra sul punto specificato nelle coordinate dello schermo e la imposta sulla dimensione specificata.
MoveInZOrderAtBottom()	Sposta la finestra corrente in modo che sia la finestra inferiore nell'ordine Z.
MoveInZOrderAtTop()	Sposta la finestra corrente in modo che sia la finestra superiore nell'ordine Z.
MoveInZOrderBelow(WindowId)	Sposta la finestra corrente sotto la finestra specificata nell'ordine Z.
Resize(SizeInt32)	Ridimensiona la finestra in base alle dimensioni specificate.
ResizeClient(SizeInt32)	Ridimensiona la finestra in modo da contenere le dimensioni specificate per l'area client.
SetIcon(IconId)	Imposta l'icona per la finestra utilizzando l'ID icona specificato.
SetIcon(String)	Imposta l'icona per la finestra utilizzando il percorso dell'icona specificato.
SetPresenter(AppWindowPresenter)	Applica il relatore specificato alla finestra.
SetPresenter(AppWindowPresenterKind)	Applica il tipo di relatore specificato alla finestra.
SetTaskbarIcon(IconId)	Imposta l'icona per la barra delle applicazioni usando l'ID icona specificato.
SetTaskbarIcon(String)	Imposta l'icona per la barra delle applicazioni usando il percorso dell'icona specificato.
SetTitleBarIcon(IconId)	Imposta l'icona per la barra del titolo della finestra utilizzando l'ID icona specificato.
SetTitleBarIcon(String)	Imposta l'icona per la barra del titolo della finestra utilizzando il percorso dell'icona specificato.
Show()	Mostra la finestra e la attiva.
Show(Boolean)	Mostra la finestra con un'opzione per attivarla o meno.
ShowOnceWithRequestedStartupState()	Mostra la finestra con il relatore predefinito nello stato richiesto.

Eventi

Nome	Descrizione
Changed	Si verifica quando una proprietà della finestra è stata modificata e il sistema si trova in uno stato "stabile" per il tempo.
Closing	Si verifica quando una finestra viene chiusa tramite un invito di sistema.
Destroying	Si verifica quando una finestra viene eliminata definitivamente.

Vedi anche

• Gestire le finestre delle app
• Personalizzazione della barra del titolo