FrameworkElement.Width 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定 FrameworkElement的寬度。
public:
property double Width { double get(); void set(double value); };double Width();
void Width(double value);public double Width { get; set; }var double = frameworkElement.width;
frameworkElement.width = double;Public Property Width As Double<frameworkElement Width="double"/>
-or-
<frameworkElement Width="Auto"/>
屬性值
double
物件的寬度，以圖元為單位。 預設值為 NaN。 除了特殊的 NaN 值之外，這個值必須等於或大於 0。
範例
這個範例示範在執行時間建立的 UI 元素的簡單屬性集，而且需要初始化其內容和基本顯示內容，例如 Height、 Width 和 Background。 (Background 實際上是 Control 屬性，不是 由 FrameworkElement.) 所定義
Button button2 = new Button();
button2.Height = 50;
button2.Width = 100;
button2.Background = new SolidColorBrush(Colors.Blue);
button2.Content = "Click Me";
備註
Width 是 FrameworkElement 上指定寬度資訊的三個可寫入屬性之一。 其他兩個是 MinWidth 和 MaxWidth。 如果這些值之間發生衝突，則實際寬度判斷的應用程式順序是 MinWidth 必須先接受，然後 MaxWidth ，最後，如果是在界限內， Width 則為 。
數個 FrameworkElement 衍生類型也衍生自 Shape。
Shape並非所有類別都使用Height或 Width 指定其外觀，而是改用可能定義一組點的特定屬性。 在此情況下， Height 會計算 或 Width ，但通常不會直接設定。
自訂類別可能會有類似的考慮，其中類別的屬性可能比 Height 或 Width 更有意義。
Height 或 Width 仍可當做成員使用，而且可設定。
設定 Height或 Width 屬性的物件幾乎一律是另一個父系子集合中的子物件，而設定 Height 或 Width 設定為值只是配置程式的建議值。 版面配置系統以及父類別的特定版面配置邏輯，將會在版面配置程式期間使用值做為非系結輸入，而且可能需要裁剪、調整物件大小、調整容器大小，或跨越多個參與物件在版面配置中的這些行為組合。 邊界和邊框間距也會影響可用的大小。 如需詳細資訊，請參閱對齊、邊界及邊框間距。
這個屬性的傳回值一律與設定為它的任何值相同。 相反地， ActualWidth 屬性的值可能會有所不同。 變異數可能會以靜態方式發生，因為版面配置拒絕了建議的大小，或暫時發生。 配置系統本身會以非同步方式與屬性系統集合 Width 相對運作，而且配置系統可能尚未處理調整大小屬性變更。
不允許的 Width 負值。
此外，請勿設定 Width 為大於任何可能視覺顯示大小上限的值。
「Auto」 和 NaN
Height的預設值為 Width 「Auto」，以 NaN 表示。 在 XAML 標記中，您可以使用字串 「Auto」 將值設定為 NaN。
注意
在 C# 中，您可以從 Double.NaN 取得 NaN。
在 C++ 中，您可以使用 宏或 std::numeric_limits<double>::quiet_NaN() 取得 NaNNAN。
請勿使用 == 運算子來測試 NaN。
在 C# 中，使用 Double.IsNaN () 來測試 NaN。
在 C++ 中，使用 isnan () 來測試 NaN。