ContainerControl.AutoScaleDimensions プロパティ

.NET Framework クラス ライブラリ リファレンス

ContainerControl.AutoScaleDimensions プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

コントロールがデザインされたときの寸法を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Property AutoScaleDimensions As
 SizeF

Visual Basic (使用法)

Dim instance As ContainerControl
Dim value As SizeF

value = instance.AutoScaleDimensions

instance.AutoScaleDimensions = value

C#

[LocalizableAttribute(true)] 
public SizeF AutoScaleDimensions { get; set;
 }

C++

[LocalizableAttribute(true)] 
public:
property SizeF AutoScaleDimensions {
    SizeF get ();
    void set (SizeF value);
}

J#

/** @property */
public SizeF get_AutoScaleDimensions ()

/** @property */
public void set_AutoScaleDimensions (SizeF
 value)

JScript

public function get AutoScaleDimensions
 () : SizeF

public function set AutoScaleDimensions
 (value : SizeF)

プロパティ値
コントロールがデザインされたときの 1 インチあたりのドット数 (DPI) または Font サイズを格納する SizeF。

例外

例外の種類	条件
ArgumentOutOfRangeException	SizeF の値の幅または高さが 0 未満です (値を設定する場合)。

解説

AutoScaleDimensions プロパティは、コントロールがスケーリングまたはデザインされたときの画面の DPI 設定またはフォント設定を表します。具体的には、このプロパティは、デザイン時に Windows フォーム デザイナによってモニタが現在使用している値に設定されます。その後、実行時にフォームが読み込まれるときに、CurrentAutoScaleDimensions プロパティが AutoScaleDimensions と異なっている場合は、PerformAutoScale メソッドが呼び出され、コントロールとそのすべての子コントロールのスケーリングが実行されます。さらに、新しいスケーリング サイズを反映して、AutoScaleDimensions が更新されます。

自動スケーリングの詳細については、「Windows フォームにおける自動スケーリング」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
ContainerControl クラス
ContainerControl メンバ
System.Windows.Forms 名前空間
AutoScaleMode
AutoScaleFactor
CurrentAutoScaleDimensions
PerformAutoScale