Control.GetPreferredSize(Size) Methode

Definition

Ruft die Größe eines rechteckigen Bereichs ab, in den ein Steuerelement eingefügt werden kann.Retrieves the size of a rectangular area into which a control can be fitted.

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.The custom-sized area for a control.

Gibt zurück

Ein geordnetes Paar vom Typ Size, das die Breite und Höhe eines Rechtecks darstellt.An ordered pair of type Size representing the width and height of a rectangle.

Implementiert

System.Windows.Forms.Layout.IArrangedElement.GetPreferredSize(System.Drawing.Size)

Hinweise

Das Verhalten von GetPreferredSize unterscheidet sich durch das Steuerelement.The behavior of GetPreferredSize differs by control. Der LayoutEngine kann die zurückgegebene Größe möglicherweise dem Steuerelement nicht zuweisen.The LayoutEngine might be unable to assign the returned size to the control. Sie können eine Größe zurückgeben, die größer ist als die im proposedSize-Parameter aufgeführten Einschränkungen, aber proposedSize sollte abnehmen, wenn die Einschränkung abnimmt.You can return a size larger than the constraints indicated in the proposedSize parameter, but proposedSize should decrease as the constraint decreases. Beispielsweise sollte GetPreferredSize(new Size(100, 0)) nicht breiter als GetPreferredSize(new Size(200, 0)) sein.For example, GetPreferredSize(new Size(100, 0)) should not be wider than GetPreferredSize(new Size(200, 0)). Bei der Ausnahme handelt es sich um eine proposedSize von 0 oder Size.Empty, die als nicht eingeschränkt definiert sind.The exception is a proposedSize of 0 or Size.Empty, which are defined as unconstrained.

Gilt für: