FrameworkElement.ActualWidth Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 DoubleEigenschaftswert
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 .