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 |