FrameworkElement.Width Свойство

Определение

Получение или установка ширины элемента.

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

Значение свойства

Ширина элемента в аппаратно-независимых единицах (1/96 дюйма на единицу). Значение по умолчанию — NaN. Это значение должно быть не меньше 0,0. Сведения о верхней границе см. в разделе "Примечания".

Атрибуты

Комментарии

Это одно из трех свойств в FrameworkElement , которые задают сведения о ширине. Два других: MinWidth и MaxWidth. Если между этими значениями возникает конфликт, сначала MinWidth необходимо соблюдать порядок применения для определения фактической ширины, а затем MaxWidth, и, наконец, если каждое из них находится в пределах границ, Width.

Возвращаемое значение этого свойства всегда совпадает с любым значением, которое было задано для него. В отличие от этого, значение ActualWidth может отличаться. Макет может по какой-то причине отклонить предложенный размер. Кроме того, сама система макета работает асинхронно относительно системного Width набора свойств и, возможно, еще не обработала это конкретное изменение свойства изменения размера.

Помимо допустимых Double значений, это свойство также может иметь значение Double.NaN. Таким образом можно задать поведение автоматического изменения размера. В XAML вы задали значение строки "Auto" (без учета регистра), чтобы включить автоматическое изменение размера. Поведение автоматического изменения размера подразумевает, что элемент заполняет доступную для него ширину. Однако обратите внимание, что определенные элементы управления часто предоставляют значения по умолчанию в стилях по умолчанию, которые отключают автоматическое изменение размера, если только оно не включено повторно.

В дополнение к проверка проверки существует недетерминированная верхняя граница значения для Width , которая применяется системой макета (это очень большое число, больше, чемSingle.MaxValue, но меньше).Double.MaxValue При превышении этой границы элемент не будет отображаться и исключение не будет создано. Не устанавливайте Width значение, значительно превышающее максимальный размер любого возможного визуального отображения, иначе вы можете превысить эту недетерминированную верхнюю границу.

Использование атрибута XAML

<object Width="double"/>  

-или-

<object Width ="qualifiedDouble"/>  

-или-

<object Width ="Auto"/>  

Значения XAML

double
Double

Строковое Double представление значения, равного или больше 0,0. Сведения о верхней границе см. в разделе "Примечания". Это значение интерпретируется как аппаратно-независимая единица измерения (1/96 дюйма). Строки не должны явно включать десятичные знаки. Например, допустимо значение 1 .

qualifiedDouble
Двойное значение, как описано выше, за которым следует одна из следующих строк объявления единицы: px, in, cm, pt.

px (по умолчанию) — не зависящие от устройства единицы (1/96-й дюйм на единицу)

in имеет значение в дюймах; 1in==96px

cm — сантиметры; 1cm==(96/2.54) px

pt — очки; 1pt==(96/72) px

Auto
Включает поведение автомасштабирования. См. заметки.

Сведения о свойстве зависимостей

Поле идентификатора WidthProperty
Для свойств метаданных задано значение true AffectsMeasure

Применяется к