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 указания сведений о ширине. Остальные два и MinWidthMaxWidth. Если между этими значениями существует конфликт, то сначала MinWidth необходимо учитывать порядок применения фактического определения ширины, а затемMaxWidth, если каждая из них находится в пределах границ. Width

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

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

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

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

<object Width="double"/>

–или–

<object Width ="qualifiedDouble"/>

–или–

<object Width ="Auto"/>

Значения XAML

Двухместный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

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