FrameworkElement.Width Tulajdonság

Definíció

Névtér:

System.Windows

Szerelvény:

PresentationFramework.dll

Lekéri vagy beállítja az elem szélességét.

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

Tulajdonság értéke

Double

Az elem szélessége eszközfüggetlen egységekben (egységenként 1/96 hüvelyk). Az alapértelmezett érték a NaN. Ennek az értéknek 0,0-nál egyenlőnek vagy nagyobbnak kell lennie. A felső határú információkért lásd a Megjegyzések című témakört.

Attribútumok

TypeConverterAttribute LocalizabilityAttribute

Megjegyzések

Ez a szélességi adatokat meghatározó három tulajdonság FrameworkElement egyike. A másik kettő és MinWidthMaxWidth. Ha ütközés áll fenn ezek között az értékek között, először MinWidth a tényleges szélesség meghatározására szolgáló alkalmazás sorrendjét kell figyelembe venni, majd MaxWidthvégül, ha ezek mindegyike határon belül van. Width

Ennek a tulajdonságnak a visszatérési értéke mindig megegyezik a beállított értékkel. Ezzel szemben a függvény ActualWidth értéke eltérő lehet. Előfordulhat, hogy az elrendezés valamilyen okból elutasította a javasolt méretet. Emellett maga az elrendezési rendszer aszinkron módon működik a tulajdonságrendszer-készlethez Width képest, és lehet, hogy még nem dolgozták fel az adott méretezési tulajdonság módosítását.

Az elfogadható Double értékek mellett ez a tulajdonság is lehet Double.NaN. Így adhatja meg az automatikus méretezési viselkedést. Az XAML-ben az értéket az "Auto" (kis- és nagybetűk érzéketlen) sztringre állítja az automatikus méretezési viselkedés engedélyezéséhez. Az automatikus méretezési viselkedés azt jelenti, hogy az elem kitölti a számára elérhető szélességet. Vegye figyelembe azonban, hogy bizonyos vezérlők gyakran alapértelmezett értékeket adnak meg az alapértelmezett stílusokban, amelyek letiltják az automatikus méretezési viselkedést, kivéve, ha kifejezetten újra engedélyezve van.

Az érvényesítési ellenőrzés mellett az elrendezési rendszer kényszeríti a nemdeterminisztikus felső értéket Width (ez egy nagyon nagy szám, nagyobb, mint Single.MaxValue de kisebb, mint Double.MaxValue). Ha túllépi ezt a korlátot, az elem nem jelenik meg, és nincs kivétel. Ne állítson be Width olyan értéket, amely jelentősen nagyobb, mint bármely lehetséges vizualizáció maximális mérete, vagy túllépheti ezt a nem meghatározható felső határt.

XAML-attribútumok használata

<object Width="double"/>

-vagy-

<object Width ="qualifiedDouble"/>

-vagy-

<object Width ="Auto"/>

XAML-értékek

DuplaDouble

Egy 0,0-nál egyenlő vagy annál nagyobb érték sztring-ábrázolása Double . A felső határú információkért lásd a Megjegyzések című témakört. Ezt az értéket eszközfüggetlen egységként (1/96 hüvelyk) értelmezzük. A sztringeknek nem kell explicit módon tartalmazniuk a tizedesvesszőket. Egy érték 1 például elfogadható.

qualifiedDouble A fent leírt kettős érték, amelyet a következő egységdeklarációs sztringek egyike követ: px, in, , cmpt.

px (alapértelmezett) eszközfüggetlen egységek (egységenként 1/96 hüvelyk)

in hüvelyk; 1in==96px

cm centiméter; 1cm==(96/2.54) px

pt pontok; 1pt==(96/72) px

Auto Engedélyezi az automatikus méretezési viselkedést. Lásd: Megjegyzések.

Függőségi tulajdonság adatai

Termék	Érték
Azonosító mező	WidthProperty
Metaadat-tulajdonságok beállítása: true	AffectsMeasure