FrameworkElement.ActualHeight Eigenschaft

public:
 property double ActualHeight { double get(); };

double ActualHeight();

public double ActualHeight { get; }

var double = frameworkElement.actualHeight;

Public ReadOnly Property ActualHeight As Double

Eigenschaftswert

Die Höhe des Objekts in Pixel. Der Standardwert lautet 0. Die Standardeinstellung kann auftreten, wenn das Objekt noch nicht geladen wurde und noch nicht an einem Layoutdurchlauf beteiligt war, der die Benutzeroberfläche rendert.

Beispiele

Dieses Beispiel zeigt ein gängiges Szenario, in dem Sie die ActualHeight eines oder mehrerer Elemente in der Benutzeroberfläche verwenden, um die Höhe eines der beteiligten Elemente oder eines anderen Elements festzulegen, sodass die gleiche Nettohöhe nach der Aktion beibehalten wird. Dies erfolgt in der Regel als Reaktion auf Ereignishandler, die aufgerufen werden, wenn Elemente geöffnet oder geschlossen werden oder sich der Anzeigebereich ändert.

void SDKSample::WebViewControl::PageWithAppBar::BottomAppBar_Opened(Object^ sender, Object^ obj)
{
    // AppBar has Opened so we need to put the WebView back to its
    // original size/location.
    AppBar^ bottomAppBar = (AppBar^) sender;
    if (bottomAppBar != nullptr)
    {
        // Force layout so that we can guarantee that our AppBar's
        // actual height has height
        this->UpdateLayout();
        // Get the height of the AppBar
        double appBarHeight = bottomAppBar->ActualHeight;
        // Reduce the height of the WebView to allow for the AppBar
        WebView8->Height = WebView8->ActualHeight - appBarHeight;
        // Translate the WebView in the Y direction to reclaim the space occupied by the AppBar.  
        TranslateYOpen->To = -appBarHeight / 2.0;
        // Run our translate animation to match the AppBar
        OpenAppBar->Begin();
    }
}

void BottomAppBar_Opened(object sender, object e)
{
    // AppBar has Opened so we need to put the WebView back to its
    // original size/location.
    AppBar bottomAppBar = sender as AppBar;
    if (bottomAppBar != null)
    {
        // Force layout so that we can guarantee that our AppBar's
        // actual height has height
        this.UpdateLayout();
        // Get the height of the AppBar
        double appBarHeight = bottomAppBar.ActualHeight;
        // Reduce the height of the WebView to allow for the AppBar
        WebView8.Height = WebView8.ActualHeight - appBarHeight;
        // Translate the WebView in the Y direction to reclaim the space occupied by 
        // the AppBar.  Notice that we translate it by appBarHeight / 2.0.
        // This is because the WebView has VerticalAlignment and HorizontalAlignment
        // of 'Stretch' and when we reduce its size it reduces its overall size
        // from top and bottom by half the amount.
        TranslateYOpen.To = -appBarHeight / 2.0;
        // Run our translate animation to match the AppBar
        OpenAppBar.Begin();
    }
}

Hinweise

ActualHeight ist eine berechnete Eigenschaft. Die Berechnungen sind ein Ergebnis eines Layoutdurchlaufs, bei dem das Objekt in der Layoutgröße entsprechend der Logik der aufeinanderfolgenden Layout-übergeordneten Elemente angepasst wird. Weitere Informationen finden Sie unter Definieren von Layouts mit XAML.

ActualHeight kann mehrere oder inkrementelle gemeldete Änderungen am Wert aufgrund von Vorgängen durch das Layoutsystem aufweisen. Wenn Sie den Wert erhalten, während das Layout noch durchlaufen wird, berechnet das Layoutsystem möglicherweise trotzdem 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, liegt er möglicherweise geringfügig hinter dem festgelegten Wert von Eigenschaften wie Height, was die Grundlage der Eingabeänderung sein kann.

Für die ElementName-Bindung stellt ActualHeight keine Aktualisierungen bereit, wenn sie sich ändert (aufgrund der asynchronen und laufzeitbasierten berechneten Natur). Versuchen Sie nicht, ActualHeight als Bindungsquelle für eine ElementName-Bindung zu verwenden. Wenn Sie über ein Szenario verfügen, das Updates basierend auf ActualHeight erfordert, verwenden Sie einen SizeChanged-Handler .

Weitere Informationen

• ActualWidth
• Height
• SizeChanged