FrameworkElement.Width Właściwość

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Pobiera lub ustawia szerokość elementu.

public:
 property double Width { double get(); void set(double value); };

[System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public double Width { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.Width : double with get, set

Public Property Width As Double

Wartość właściwości

Double

Szerokość elementu w jednostkach niezależnych od urządzenia (1/96 cala na jednostkę). Wartość domyślna to NaN. Ta wartość musi być równa lub większa niż 0,0. Zobacz uwagi, aby uzyskać informacje o górnej granicy.

Atrybuty

TypeConverterAttribute LocalizabilityAttribute

Uwagi

Jest to jedna z trzech właściwości określających FrameworkElement informacje o szerokości. Pozostałe dwa to MinWidth i MaxWidth. Jeśli między tymi wartościami występuje konflikt, najpierw należy przestrzegać kolejności stosowania rzeczywistej szerokości MinWidth , a następnie MaxWidth, a na koniec, jeśli każda z nich znajduje się w granicach, Width.

Wartość zwracana tej właściwości jest zawsze taka sama jak każda ustawiona na nią wartość. Z kolei wartość ActualWidth elementu może się różnić. Z jakiegoś powodu układ mógł odrzucić sugerowany rozmiar. Ponadto sam system układu działa asynchronicznie względem zestawu Width systemu właściwości i może jeszcze nie przetworzyć tej konkretnej zmiany rozmiaru właściwości.

Oprócz dopuszczalnych Double wartości ta właściwość może również mieć wartość Double.NaN. W ten sposób określasz zachowanie automatycznego określania rozmiaru. W języku XAML ustawisz wartość na ciąg "Auto" (bez uwzględniania wielkości liter), aby włączyć zachowanie automatycznego określania rozmiaru. Zachowanie automatycznego określania rozmiaru oznacza, że element wypełni dostępną szerokość. Należy jednak pamiętać, że określone kontrolki często udostępniają wartości domyślne w ich stylach domyślnych, które wyłączą zachowanie automatycznego określania rozmiaru, chyba że zostaną one ponownie włączone.

Oprócz sprawdzania poprawności istnieje niedeterministyczna górna granica, Width która jest wymuszana przez system układu (jest to bardzo duża liczba, większa niż Single.MaxValue ale mniejsza niż Double.MaxValue). Jeśli przekroczysz tę granicę, element nie zostanie renderowany i nie zostanie zgłoszony wyjątek. Nie należy ustawiać Width wartości, która jest znacznie większa niż maksymalny rozmiar dowolnej możliwej wizualizacji lub może przekroczyć tę niedeterministyczną górną granicę.

Użycie atrybutu języka XAML

<object Width="double"/>  

-lub-

<object Width ="qualifiedDouble"/>  

-lub-

<object Width ="Auto"/>  

Wartości XAML

liczba o podwójnej precyzji
Double

Reprezentacja ciągu wartości równej Double lub większej niż 0,0. Zobacz uwagi, aby uzyskać informacje o górnej granicy. Ta wartość jest interpretowana jako miara niezależna od urządzenia (1/96 cala). Ciągi nie muszą jawnie uwzględniać punktów dziesiętnych. Na przykład wartość jest akceptowalna 1 .

qualifiedDouble
Podwójna wartość opisana powyżej, po której następuje jeden z następujących ciągów deklaracji jednostki: px, , cmin, pt.

px (ustawienie domyślne) to jednostki niezależne od urządzenia (1/96 cala na jednostkę)

in jest cala; 1in==96px

cm to centymetry; 1cm==(96/2.54) px

pt to punkty; 1pt==(96/72) px

Auto
Włącza zachowanie automatycznego określania rozmiaru. Zobacz uwagi.

Informacje dotyczące właściwości zależności

Pole identyfikatora	WidthProperty
Właściwości metadanych ustawione na true	AffectsMeasure