FrameworkElement.Width Vlastnost

Definice

Získá nebo nastaví šířku 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

Hodnota vlastnosti

Šířka prvku v jednotkách nezávislých na zařízení (1/96 palce na jednotku). Výchozí hodnota je NaN. Tato hodnota musí být rovna nebo větší než 0,0. Informace o horních mezích najdete v části Poznámky.

Atributy

Poznámky

Jedná se o jednu ze tří vlastností FrameworkElement , které určují informace o šířce. Další dvě jsou MinWidth a MaxWidth. Pokud dojde ke konfliktu mezi těmito hodnotami, musí být nejprve MinWidth dodrženo pořadí použití pro určení skutečné šířky, pak MaxWidth, a nakonec, pokud jsou všechny tyto hodnoty v mezích, Width.

Návratová hodnota této vlastnosti je vždy stejná jako jakákoli hodnota, která na ni byla nastavena. Naproti tomu hodnota může být různá ActualWidth . Rozložení mohlo z nějakého důvodu odmítnout navrhovanou velikost. Také samotný systém rozložení pracuje asynchronně vzhledem k systémové sadě Width vlastností a možná ještě nezpracoval tuto konkrétní změnu vlastnosti velikosti.

Kromě přijatelných Double hodnot může být Double.NaNtato vlastnost také . Tímto způsobem určíte chování automatické velikosti. V JAZYCE XAML nastavíte hodnotu na řetězec "Auto" (bez rozlišování velkých a malých písmen), aby se povolilo chování automatického nastavení velikosti. Chování automatického nastavení velikosti znamená, že prvek vyplní šířku, kterou má k dispozici. Mějte však na paměti, že konkrétní ovládací prvky často poskytují výchozí hodnoty ve svých výchozích stylech, které zakáže chování automatického nastavení velikosti, pokud není výslovně znovu povoleno.

Kromě ověřovací kontroly existuje nedeterministická horní hranice hodnoty, Width pro kterou systém rozložení vynucuje (jedná se o velmi velké číslo, větší než Single.MaxValue , ale menší než Double.MaxValue). Pokud tuto vazbu překročíte, element se nevykreslí a nevyvolá se žádná výjimka. Nenastavujte Width na hodnotu, která je výrazně větší než maximální velikost libovolného možného vizuálního zobrazení, nebo můžete tuto nedeterministické horní hranici překročit.

Použití atributu XAML

<object Width="double"/>  

-nebo-

<object Width ="qualifiedDouble"/>  

-nebo-

<object Width ="Auto"/>  

Hodnoty XAML

double
Double

Řetězcová reprezentace Double hodnoty rovna nebo větší než 0,0. Informace o horních mezích najdete v části Poznámky. Tato hodnota se interpretuje jako měření nezávislé na zařízení (1/96 palce). Řetězce nemusí explicitně obsahovat desetinná místa. Například hodnota 1 je přijatelná.

qualifiedDouble
Dvojitá hodnota, jak je popsáno výše, následovaná jedním z následujících řetězců deklarace jednotek: px, in, cm, pt.

px (výchozí) je jednotka nezávislá na zařízení (1/96 palce na jednotku).

in je palce; 1in==96px

cm je centimetry; 1cm==(96/2.54) px

pt je bodový; 1pt==(96/72) px

Auto
Povolí chování automatické velikosti. Viz Poznámky.

Informace o vlastnosti závislosti

Pole Identifikátor WidthProperty
Vlastnosti metadat nastavené na true AffectsMeasure

Platí pro