Form.SizeGripStyle Property (System.Windows.Forms)

SizeGripStyle Property

Collapse All

Language Filter

This page is specific to

.NET Framework 3.0

Other versions are also available for the following:

Form.SizeGripStyle Property

Gets or sets the style of the size grip to display in the lower-right corner of the form.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

Visual Basic (Declaration)

Public Property SizeGripStyle As SizeGripStyle

Visual Basic (Usage)

Dim instance As Form
Dim value As SizeGripStyle

value = instance.SizeGripStyle

instance.SizeGripStyle = value

public SizeGripStyle SizeGripStyle { get; set; }

C++

public:
property SizeGripStyle SizeGripStyle {
    SizeGripStyle get ();
    void set (SizeGripStyle value);
}

/** @property */
public SizeGripStyle get_SizeGripStyle ()

/** @property */
public void set_SizeGripStyle (SizeGripStyle value)

JScript

public function get SizeGripStyle () : SizeGripStyle

public function set SizeGripStyle (value : SizeGripStyle)

XAML

Not applicable.

Property Value

A SizeGripStyle that represents the style of the size grip to display. The default is SizeGripStyle.Auto

Exceptions

Exception type	Condition
InvalidEnumArgumentException	The value specified is outside the range of valid values.

Remarks

This property enables you to determine when the sizing grip is displayed on the form. You can set this property to display the sizing grip or have it automatically displayed based on the setting of the FormBorderStyle property.

Example

The following code example demonstrates how to hide the size grip for a Form when the Form is not resizable.

Visual Basic

Private Sub ShowMyDialogBox()
    Dim myForm As New Form()
    myForm.Text = "My Form"
    myForm.SetBounds(20, 20, 300, 300)
    myForm.FormBorderStyle = FormBorderStyle.FixedDialog

    ' Display the form with no grip since form is not resizable.
    myForm.SizeGripStyle = SizeGripStyle.Hide

    myForm.MinimizeBox = False
    myForm.MaximizeBox = False
    myForm.ShowDialog()
End Sub

private void ShowMyDialogBox()
{
    Form myForm = new Form();
    myForm.Text = "My Form";
    myForm.SetBounds(20,20,300,300);
    myForm.FormBorderStyle = FormBorderStyle.FixedDialog;
    
    // Display the form with no grip since form is not resizable.
    myForm.SizeGripStyle = SizeGripStyle.Hide;

    myForm.MinimizeBox = false;
    myForm.MaximizeBox = false;
    myForm.ShowDialog();
}

C++

private:
   void ShowMyDialogBox()
   {
      Form^ myForm = gcnew Form;
      myForm->Text = "My Form";
      myForm->SetBounds( 20, 20, 300, 300 );
      myForm->FormBorderStyle = ::FormBorderStyle::FixedDialog;

      // Display the form with no grip since form is not resizable.
      myForm->SizeGripStyle = ::SizeGripStyle::Hide;
      myForm->MinimizeBox = false;
      myForm->MaximizeBox = false;
      myForm->ShowDialog();
   }

private void ShowMyDialogBox()
{
    Form myForm = new Form();
    myForm.set_Text("My Form");
    myForm.SetBounds(20, 20, 300, 300);
    myForm.set_FormBorderStyle(get_FormBorderStyle().FixedDialog);

    // Display the form with no grip since form is not resizable.
    myForm.set_SizeGripStyle(get_SizeGripStyle().Hide);
    myForm.set_MinimizeBox(false);
    myForm.set_MaximizeBox(false);
    myForm.ShowDialog();
} //ShowMyDialogBox

Platforms

Windows 98, Windows Server 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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Reference

Form Class
Form Members
System.Windows.Forms Namespace
Form.FormBorderStyle Property
SizeGripStyle