FrameworkElement.Width Eigenschap

Definitie

Naamruimte:

System.Windows

Assembly:

PresentationFramework.dll

Hiermee haalt u de breedte van het element op of stelt u deze in.

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

Waarde van eigenschap

Double

De breedte van het element, in apparaatonafhankelijke eenheden (1/96e inch per eenheid). De standaardwaarde is NaN. Deze waarde moet gelijk zijn aan of groter zijn dan 0,0. Zie Opmerkingen voor informatie over de bovengrens.

Kenmerken

TypeConverterAttribute LocalizabilityAttribute

Opmerkingen

Dit is een van de drie eigenschappen waarop FrameworkElement breedtegegevens worden opgegeven. De andere twee zijn MinWidth en MaxWidth. Als er een conflict is tussen deze waarden, moet eerst de volgorde van de toepassing voor de bepaling van de werkelijke breedte MinWidth worden gehonoreerd, dan MaxWidthen ten slotte, en ten slotte als elk van deze binnen grenzen valt, Width.

De retourwaarde van deze eigenschap is altijd hetzelfde als elke waarde die erop is ingesteld. De waarde van de ActualWidth waarde kan daarentegen variëren. De indeling kan om een of andere reden de voorgestelde grootte hebben afgewezen. Ook werkt het indelingssysteem zelf asynchroon ten opzichte van de eigenschappensysteemset van Width en heeft deze eigenschap mogelijk nog niet verwerkt.

Naast acceptabele Double waarden kan deze eigenschap ook zijn Double.NaN. Op deze wijze geeft u het gedrag voor automatisch aanpassen van de grootte op. In XAML stelt u de waarde in op de tekenreeks 'Auto' (hoofdlettergevoelig) om het gedrag van de automatische grootte in te schakelen. Het gedrag van automatische grootte houdt in dat het element de beschikbare breedte zal vullen. Houd er echter rekening mee dat specifieke besturingselementen vaak standaardwaarden leveren in hun standaardstijlen waarmee het gedrag voor automatisch aanpassen wordt uitgeschakeld, tenzij deze specifiek opnieuw is ingeschakeld.

Naast de validatiecontrole is er een niet-deterministische bovenwaarde die Width wordt afgedwongen door het indelingssysteem (dit is een zeer groot getal, groter dan Single.MaxValue maar kleiner dan Double.MaxValue). Als u deze limiet overschrijdt, wordt het element niet weergegeven en wordt er geen uitzondering gegenereerd. Stel niet in Width op een waarde die aanzienlijk groter is dan de maximale grootte van een mogelijke visuele weergave, of u kunt deze niet-deterministische bovengrens overschrijden.

XAML-kenmerkgebruik

<object Width="double"/>

– of –

<object Width ="qualifiedDouble"/>

– of –

<object Width ="Auto"/>

XAML-waarden

DubbeleDouble

Tekenreeksweergave van een Double waarde die gelijk is aan of groter is dan 0,0. Zie Opmerkingen voor informatie over de bovengrens. Deze waarde wordt geïnterpreteerd als een apparaatonafhankelijke eenheid (1/96e inch) meting. Tekenreeksen hoeven niet expliciet decimale punten op te nemen. Een waarde is 1 bijvoorbeeld acceptabel.

qualifiedDouble Een dubbele waarde zoals hierboven beschreven, gevolgd door een van de volgende eenheidsdeclaratietekenreeksen: px, in, cm, , . pt

px (standaard) is apparaatonafhankelijke eenheden (1/96e inch per eenheid)

in is inches; 1in==96px

cm is centimeters; 1cm==(96/2,54) px

pt is punten; 1pt==(96/72) px

Auto Hiermee schakelt u automatisch aanpassen van gedrag in. Zie opmerkingen.

Informatie over afhankelijkheidseigenschappen

Item	Waarde
Id-veld	WidthProperty
Eigenschappen van metagegevens ingesteld op true	AffectsMeasure