ContainerControl.AutoScaleDimensions プロパティ


コントロールがデザインされたときの寸法を取得または設定します。Gets or sets the dimensions that the control was designed to.

 property System::Drawing::SizeF AutoScaleDimensions { System::Drawing::SizeF get(); void set(System::Drawing::SizeF value); };
public System.Drawing.SizeF AutoScaleDimensions { get; set; }
member this.AutoScaleDimensions : System.Drawing.SizeF with get, set
Public Property AutoScaleDimensions As SizeF



コントロールがデザインされたときの 1 インチあたりのドット数 (DPI) または SizeF サイズを格納する FontA SizeF containing the dots per inch (DPI) or Font size that the control was designed to.



SizeF の値の幅または高さが 0 未満です (値を設定する場合)。The width or height of the SizeF value is less than 0 when setting this value.


プロパティは、 AutoScaleDimensions コントロールが拡大または縮小された画面の DPI またはフォントの設定を表します。The AutoScaleDimensions property represents the DPI or font setting of the screen that the control was scaled to or designed for. 具体的には、デザイン時に、このプロパティは、モニターが現在使用している値に Windows フォームデザイナーによって設定されます。Specifically, at design time this property will be set by the Windows Forms designer to the value your monitor is currently using. 次に、実行時にフォームが読み込まれるときに、 CurrentAutoScaleDimensions プロパティがと異なる場合、 AutoScaleDimensions メソッドが PerformAutoScale 呼び出され、コントロールとそのすべての子のスケーリングが実行されます。Then, when the form loads at run time, if the CurrentAutoScaleDimensions property is different from the AutoScaleDimensions, the PerformAutoScale method will be called to perform scaling of the control and all of its children. その後、 AutoScaleDimensions は新しいスケーリングサイズを反映するように更新されます。Afterwards, AutoScaleDimensions will be updated to reflect the new scaling size.

自動スケーリングの詳細については、「 Windows フォームでの自動スケーリング」を参照してください。For more information about automatic scaling, see Automatic Scaling in Windows Forms.