Control.GetPreferredSize(Size) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft die Größe eines rechteckigen Bereichs ab, in den ein Steuerelement eingefügt werden kann.

public:
 virtual System::Drawing::Size GetPreferredSize(System::Drawing::Size proposedSize);

public virtual System.Drawing.Size GetPreferredSize (System.Drawing.Size proposedSize);

abstract member GetPreferredSize : System.Drawing.Size -> System.Drawing.Size
override this.GetPreferredSize : System.Drawing.Size -> System.Drawing.Size

Public Overridable Function GetPreferredSize (proposedSize As Size) As Size

Parameter

proposedSize

Size

Der Bereich mit benutzerdefinierter Größe eines Steuerelements.

Gibt zurück

Size

Ein geordnetes Paar vom Typ Size, das die Breite und Höhe eines Rechtecks darstellt.

Hinweise

Das Verhalten von GetPreferredSize unterscheidet sich je nach Steuerelement. Die LayoutEngine kann dem Steuerelement möglicherweise nicht die zurückgegebene Größe zuweisen. Sie können eine Größe zurückgeben, die größer als die im proposedSize -Parameter angegebenen Einschränkungen ist, sollte jedoch proposedSize mit abnehmen, wenn die Einschränkung abnimmt. GetPreferredSize(new Size(100, 0)) Beispielsweise sollte nicht breiter als GetPreferredSize(new Size(200, 0))sein. Die Ausnahme ist eine proposedSize von 0 oder Size.Empty, die als nicht eingeschränkt definiert sind.