FrameworkElement.ActualWidth Propriété

Définition

Obtient la largeur rendue de cet élément.

C#
public double ActualWidth { get; }

Valeur de propriété

Double

Largeur de l’élément, comme valeur dans les unités indépendantes de l’appareil (1/96ème pouce par unité). La valeur par défaut est 0 (zéro).

Exemples

L’exemple suivant affiche différentes propriétés de largeur.

C#
private void changeWidth(object sender, SelectionChangedEventArgs args)
{
    ListBoxItem li = ((sender as ListBox).SelectedItem as ListBoxItem);
    Double sz1 = Double.Parse(li.Content.ToString());
    rect1.Width = sz1;
    rect1.UpdateLayout();
    txt1.Text = "ActualWidth is set to " + rect1.ActualWidth;
    txt2.Text = "Width is set to " + rect1.Width;
    txt3.Text = "MinWidth is set to " + rect1.MinWidth;
    txt4.Text = "MaxWidth is set to " + rect1.MaxWidth;
}
private void changeMinWidth(object sender, SelectionChangedEventArgs args)
{
    ListBoxItem li = ((sender as ListBox).SelectedItem as ListBoxItem);
    Double sz1 = Double.Parse(li.Content.ToString());
    rect1.MinWidth = sz1;
    rect1.UpdateLayout();
    txt1.Text = "ActualWidth is set to " + rect1.ActualWidth;
    txt2.Text = "Width is set to " + rect1.Width;
    txt3.Text = "MinWidth is set to " + rect1.MinWidth;
    txt4.Text = "MaxWidth is set to " + rect1.MaxWidth;
}
private void changeMaxWidth(object sender, SelectionChangedEventArgs args)
{
    ListBoxItem li = ((sender as ListBox).SelectedItem as ListBoxItem);
    Double sz1 = Double.Parse(li.Content.ToString());
    rect1.MaxWidth = sz1;
    rect1.UpdateLayout();
    txt1.Text = "ActualWidth is set to " + rect1.ActualWidth;
    txt2.Text = "Width is set to " + rect1.Width;
    txt3.Text = "MinWidth is set to " + rect1.MinWidth;
    txt4.Text = "MaxWidth is set to " + rect1.MaxWidth;
}

Remarques

Cette propriété est une valeur calculée basée sur d’autres entrées de largeur et le système de disposition. La valeur est définie par le système de disposition lui-même, en fonction d’un passage de rendu réel, et peut donc se trouver légèrement derrière la valeur définie des propriétés telles que Width celles qui sont la base du changement d’entrée.

Étant donné ActualWidth qu’il s’agit d’une valeur calculée, vous devez savoir qu’il peut y avoir plusieurs modifications signalées ou incrémentielles en raison de diverses opérations effectuées par le système de disposition. Celui-ci peut en effet calculer l’espace de mesure requis pour les éléments enfants, les contraintes de l’élément parent, et ainsi de suite.

Bien que vous ne puissiez pas définir cette propriété à partir de XAML, vous pouvez baser une Trigger valeur sur sa valeur dans un style.

Informations sur les propriétés de dépendance

Champ d’identificateur ActualWidthProperty
Propriétés de métadonnées définies sur true Aucun

S’applique à

Produit Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop 3.0, 3.1, 5, 6, 7