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. Consultez la section Notes.
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 été chargé et n’a pas encore été impliqué dans une passe de disposition qui restitue l’interface utilisateur.
Remarques
Notes
Bien qu’il ait un champ de sauvegarde ActualWidthProperty , ActualWidth ne déclenche pas de notifications de modification de propriété et doit être considéré comme une propriété CLR normale et non comme 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é dans la 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 de la valeur en raison d’opérations effectuées par le système de disposition. Si vous obtenez la valeur alors que la disposition est toujours en cours d’itération, le système de disposition peut toujours calculer la mesure d’espace requise pour les objets enfants, les contraintes par l’objet parent, etc. Étant donné que la valeur est basée sur une passe de rendu réelle, elle peut être légèrement en retard par rapport à la valeur définie de propriétés telles que Width, qui peut être la base de la modification d’entrée.
Pour les besoins de la liaison ElementName , ActualWidth ne publie pas de mises à jour lorsqu’il change (en raison de sa nature calculée asynchrone et d’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 .