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 występuje konflikt między tymi wartościami, kolejność stosowania rzeczywistej determinacji szerokości musi MinWidth być najpierw honorowana, 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 wartość ustawiona na tę właściwość. 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 nie przetworzyć tej konkretnej zmiany właściwości rozmiaru jeszcze.

Oprócz dopuszczalnych Double wartości ta właściwość może również mieć Double.NaNwartość . 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 zostanie ona ponownie włączona.

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

Użycie atrybutu XAML

<object Width="double"/>

— lub —

<object Width ="qualifiedDouble"/>

— lub —

<object Width ="Auto"/>

Wartości XAML

PodwójneDouble

Reprezentacja Double ciągu wartości równej lub większej niż 0,0. Zobacz Uwagi, aby uzyskać informacje o górnej granicy. Ta wartość jest interpretowana jako jednostka 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 .

qualifiedDoublePodwójna wartość, jak opisano powyżej, a następnie jeden z następujących ciągów deklaracji jednostki: px, , incm, 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 autoskalowania. Zobacz uwagi.

Informacje o właściwości zależności

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