Control.DefaultSize Property

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets the default size of the control.

protected:
 virtual property System::Drawing::Size DefaultSize { System::Drawing::Size get(); };

protected virtual System.Drawing.Size DefaultSize { get; }

member this.DefaultSize : System.Drawing.Size

Protected Overridable ReadOnly Property DefaultSize As Size

Property Value

Size

The default Size of the control.

Examples

The following code example overrides the DefaultSize property, and makes the default size of the form 500 pixels square.

protected:
   property System::Drawing::Size DefaultSize 
   {
      virtual System::Drawing::Size get() override
      {
         // Set the default size of
         // the form to 500 pixels square.
         return System::Drawing::Size( 500, 500 );
      }
   }

protected override Size DefaultSize
{
   get
   {
      // Set the default size of
      // the form to 500 pixels square.
      return new Size(500,500);
   }
}

Protected Overrides ReadOnly Property DefaultSize() As Size
   Get
      ' Set the default size of
      ' the form to 500 pixels square. 
      Return New Size(500, 500)
   End Get
End Property

Remarks

The DefaultSize property represents the Size of the control when it is initially created. You can adjust the size of the control by setting its Size property value.

Note

To maintain better performance, do not set the Size of a control in its constructor. The preferred method is to override the DefaultSize property.

Note

On Windows Server 2003 systems, the size of a Form is restricted by the maximum pixel width and height of the monitor.

Notes to Inheritors

When overriding the DefaultSize property in a derived class, it is preferable to return a Size with the desired dimensions rather than to override all the implementation.

Applies to

Teilen über