Share via

Window.SizeChanged Ereignis

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml
Bearbeiten

Tritt auf, wenn das App-Fenster zuerst gerendert wurde oder seine Renderinggröße geändert hat.

// Register
event_token SizeChanged(TypedEventHandler<IInspectable, WindowSizeChangedEventArgs const&> const& handler) const;

// Revoke with event_token
void SizeChanged(event_token const* cookie) const;

// Revoke with event_revoker
Window::SizeChanged_revoker SizeChanged(auto_revoke_t, TypedEventHandler<IInspectable, WindowSizeChangedEventArgs const&> const& handler) const;
public event TypedEventHandler<object,WindowSizeChangedEventArgs> SizeChanged;
function onSizeChanged(eventArgs) { /* Your code */ }
window.addEventListener("sizechanged", onSizeChanged);
window.removeEventListener("sizechanged", onSizeChanged);
- or -
window.onsizechanged = onSizeChanged;
Public Custom Event SizeChanged As TypedEventHandler(Of Object, WindowSizeChangedEventArgs)

Ereignistyp

TypedEventHandler<Object,WindowSizeChangedEventArgs>

TypedEventHandler<IInspectable,WindowSizeChangedEventArgs>

Hinweise

Dieses Ereignis tritt immer dann auf, wenn Änderungen an den Bounds-Werten für das App-Fenster vorgenommen werden. Dies kann daran zurückzuführen sein, dass der Benutzer die Größe Ihrer App ändert oder die Anzeigeausrichtung ändert. Ein weiterer Trigger ist, wenn der Benutzer Ihre App auf eine neue Anzeige mit einer anderen Auflösung verschiebt und das App-Fenster erweitert wird, um sie auszufüllen.

Window.SizeChanged ist das Zu behandelnde Ereignis, um zu erkennen, dass der Benutzer die Größe Ihrer App absichtlich geändert oder den Bildschirm auf einem PC gedreht hat, der die Ausrichtung erkennt. Möglicherweise möchten Sie feststellen, dass sich das App-Fenster von Querformat zu Hochformat oder umgekehrt geändert hat. Die Ausrichtung des App-Fensters kann beeinflussen, wie die einzelnen Steuerelemente im App-Fenster angezeigt werden sollen. Beispielsweise können Sie Datenlisten in einer ListView für die Ausrichtung im Hochformat, aber in einer GridView für die Querausrichtung anzeigen. In der Regel vergleichen Sie das Verhältnis von Window.Current.Bounds.Width mit Window.Current.Bounds.Height , um die Ausrichtung basierend auf den Begrenzungen zu bestimmen, und sie würden dies bei jedem Auslösen Window.SizeChanged tun. Wie Sie das Verhältnis zwischen Breite und Höhe genau interpretieren, liegt bei Ihnen.

Wenn Sie Handler für Window.SizeChanged auf Seitenebene innerhalb eines Handlers für das FrameworkElement.Loaded-Ereignis anfügen, sollten Sie diese Handler in einem FrameworkElement.Unloaded-Ereignishandler von dieser Seite trennen. Die Window.Current-instance bleibt zwischen Seitennavigationen aktiv und sollte nur einen Handler für den aktuellen Seitencode haben.

Mit einem Window.SizeChanged Handler erzwingen Sie nicht die Mindestgröße, in die die Größe Ihrer App geändert werden kann. Dies wird vom App-Manifest gesteuert. Ihre Logik zum Ändern der visuellen Zustände sollte jedoch in der Lage sein, einen Zustand zu laden, der für die von Ihnen gewünschte Mindestbreite konzipiert ist, und Sie würden in der Regel die Begrenzungswerte und Window.SizeChanged die Verarbeitung verwenden, um zu erkennen, wann das App-Fenster die Mindestbreite verwendet.

Weitere Informationen zur Verwendung von Window.SizeChanged zum Erkennen von Änderungen in der App-Fensterumgebung und zum Laden der entsprechenden visuellen Zustände für Ihre App finden Sie unter Responsive Layouts mit XAML.

Es gibt ein anderes Ereignis mit dem Namen SizeChanged , das für von FrameworkElement abgeleitete Typen vorhanden ist (Window ist kein FrameworkElement-Typ ). FrameworkElement.SizeChanged-Ereignisse können unter vielen der gleichen Umstände ausgelöst werden, die zum Auslösen führen Window.SizeChanged . Eine Änderung der Größe des App-Fensters kann dazu führen, dass das visuelle Stammelement (in der Regel eine Seite oder ein Bereich) seine Größe ändert. Dies löst eine Kaskade von Layoutinvalidierungen für alle Unterelemente aus, die das adaptive Layout verwenden, um den verfügbaren Platz zu füllen. Jedes Element, das aufgrund eines Layoutdurchlaufs neue Dimensionen aufweist, löst sein eigenes FrameworkElement.SizeChanged-Ereignis aus .

Gilt für:

Weitere Informationen