Freigeben über

FrameworkElement.ActualWidth Eigenschaft

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml
Bearbeiten

Ruft die gerenderte Breite eines FrameworkElement ab. Siehe Hinweise.

public:
 property double ActualWidth { double get(); };
double ActualWidth();
public double ActualWidth { get; }
var double = frameworkElement.actualWidth;
Public ReadOnly Property ActualWidth As Double

Eigenschaftswert

Double

double

Die Breite des Objekts in Pixel. Die Standardeinstellung ist 0. Der Standardwert kann gefunden werden, wenn das Objekt nicht geladen wurde und noch nicht an einem Layoutdurchlauf beteiligt war, der die Benutzeroberfläche rendert.

Hinweise

Hinweis

Obwohl es über ein ActualWidthProperty-Unterstützungsfeld verfügt, löst ActualWidth keine Eigenschaftsänderungsbenachrichtigungen aus, und es sollte als reguläre CLR-Eigenschaft und nicht als Abhängigkeitseigenschaft betrachtet werden.

ActualWidth ist eine berechnete Eigenschaft. Die Berechnungen sind das Ergebnis eines Layoutdurchlaufs, bei dem das Objekt im Layout entsprechend der Logik seiner aufeinanderfolgenden Layouteltern dimensioniert wird. Weitere Informationen finden Sie unter Definieren von Layouts mit XAML.

Bei ActualWidth können aufgrund von Vorgängen des Layoutsystems mehrere oder inkrementelle Änderungen am Wert gemeldet werden. Wenn Sie den Wert erhalten, während das Layout noch iteriert wird, berechnet das Layoutsystem möglicherweise weiterhin das erforderliche Maß an Platz für untergeordnete Objekte, Einschränkungen durch das übergeordnete Objekt usw. Da der Wert auf einem tatsächlichen Renderingdurchlauf basiert, kann er leicht hinter dem festgelegten Wert von Eigenschaften wie Width zurückbleiben, der die Grundlage der Eingabeänderung sein kann.

Für Zwecke der ElementName-Bindung postiert ActualWidth keine Aktualisierungen, wenn es sich ändert (aufgrund seiner asynchronen und berechneten Laufzeit). Versuchen Sie nicht, ActualWidth als Bindungsquelle für eine ElementName-Bindung zu verwenden. Wenn Sie ein Szenario haben, für das Updates basierend auf ActualWidth erforderlich sind, verwenden Sie einen SizeChanged-Handler .

Gilt für:

Weitere Informationen