FrameworkElement.ActualHeight Property

Obtient la hauteur restituée d'un FrameworkElement.

Syntaxe


public double ActualHeight { get; }

Valeur de propriété

Type: System.Double [.NET] | float64 [C++]

Hauteur de l'objet, en pixels. La valeur par défaut est 0. Elle peut être rencontrée si l'objet n'a pas été chargé et s'il a subi une passe de disposition.

Remarques

ActualHeight est une propriété calculée. Les calculs sont le résultat d'une passe de disposition, où l'objet est dimensionné dans la disposition selon la logique de ses parents de disposition successifs. Pour plus d'informations, consultez Quickstart: Defining layouts.

ActualHeight peut comporter des modifications multiples ou incrémentielles signalées pour la valeur, en raison des opérations réalisées par le système de disposition. Si vous obtenez la valeur alors que la disposition est en cours d'itération, le système de disposition peut être en train de calculer la quantité d'espace requise pour les objets enfants, les contraintes par l'objet parent, et ainsi de suite. Étant donné que la valeur est basée sur une passe de rendu réelle, elle peut rester légèrement inférieure à la valeur définie de propriétés telles que Height, qui peut être la base de la modification de l'entrée.

Pour la liaison d'ElementName, ActualHeight ne publie pas de mises à jour en cas de modification (en raison de sa nature asynchrone et calculée au moment de l'exécution). N'essayez pas d'utiliser ActualHeight comme source de liaison pour une liaison ElementName. Si vous avez un scénario qui requiert des mises à jour basées sur ActualHeight, utilisez un gestionnaire SizeChanged.

Exemples

Cet exemple illustre un scénario courant dans lequel vous utilisez la propriété ActualHeight d'un ou plusieurs éléments d'une interface utilisateur pour définir la propriété Height de l'un des éléments impliqués ou d'un élément différent afin que la même hauteur nette soit mise à jour après l'action. Cela est généralement effectué en réponse aux gestionnaires d'événements qui se déclenchent lorsque les éléments sont ouverts ou fermés ou que la zone d'affichage change.


        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();
            }
        }


Configuration requise

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Espace de noms

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Métadonnées

Windows.winmd

Voir aussi

FrameworkElement

 

 

Afficher:
© 2014 Microsoft