FrameworkElement.ActualWidth Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient la largeur rendue d’un FrameworkElement. Voir les remarques.
public:
property double ActualWidth { double get(); };double ActualWidth();public double ActualWidth { get; }var double = frameworkElement.actualWidth;Public ReadOnly Property ActualWidth As DoubleValeur de propriété
double
Largeur, en pixels, de l’objet. La valeur par défaut est 0. La valeur par défaut peut être rencontrée si l’objet n’a pas encore été chargé et n’a pas encore été impliqué dans une passe de disposition qui affiche l’interface utilisateur.
Remarques
Note
Bien qu’il ait un champ de stockage ActualWidthProperty , ActualWidth ne déclenche pas de notifications de modification de propriété et doit être considéré comme une propriété CLR standard et non une propriété de dépendance.
ActualWidth est une propriété calculée. Les calculs sont le résultat d’une passe de disposition, où l’objet est dimensionné en disposition en fonction de la logique de ses parents de disposition successifs. Pour plus d’informations, consultez Définir des dispositions avec XAML.
ActualWidth peut avoir plusieurs modifications signalées ou incrémentielles apportées à la valeur en raison d’opérations effectuées par le système de disposition. Si vous obtenez la valeur pendant que la disposition est toujours itérante, le système de disposition peut toujours calculer la mesure requise de l’espace 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 être légèrement derrière la valeur définie des propriétés telles que Width, qui peut être la base de la modification d’entrée.
À des fins de liaison ElementName , ActualWidth ne publie pas de mises à jour lorsqu’elle change (en raison de sa nature calculée asynchrone et au moment de l’exécution). N’essayez pas d’utiliser ActualWidth comme source de liaison pour une liaison ElementName . Si vous avez un scénario qui nécessite des mises à jour basées sur ActualWidth, utilisez un gestionnaire SizeChanged .