StatusBar.SizingGrip-Eigenschaft

Ruft einen Wert ab, der angibt, ob in der unteren rechten Ecke des Steuerelements ein Größenziehpunkt angezeigt wird, oder legt diesen fest.

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

Syntax

'Declaration
Public Property SizingGrip As Boolean
'Usage
Dim instance As StatusBar
Dim value As Boolean

value = instance.SizingGrip

instance.SizingGrip = value

public bool SizingGrip { get; set; }

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

/** @property */
public boolean get_SizingGrip ()

/** @property */
public void set_SizingGrip (boolean value)

public function get SizingGrip () : boolean

public function set SizingGrip (value : boolean)

Eigenschaftenwert

true, wenn ein Größenziehpunkt angezeigt wird, andernfalls false. Der Standardwert ist true.

Hinweise

Mit dieser Eigenschaft können Sie einen Größenziehpunkt anzeigen, um den Benutzer darauf hinzuweisen, dass die Größe eines Formulars geändert werden kann. Wenn die FormBorderStyle-Eigenschaft des Form auf eine Rahmenart festgelegt ist, deren Größe nicht geändert werden kann, z. B. Fixed3D oder FixedDialog, sollten Sie die SizingGrip-Eigenschaft auf false festlegen, um nicht den Eindruck zu erwecken, dass die Formulargröße angepasst werden kann.

Beispiel

Im folgenden Codebeispiel werden die Verwendung der Member SizingGrip, StatusBarPanel.Alignment, StatusBarPanel.Width, StatusBarPanel.AutoSize und StatusBarPanel.BorderStyle sowie die Behandlung des PanelClick-Ereignisses veranschaulicht.

Fügen Sie zum Ausführen des Beispiels den folgenden Code in ein Formular ein. Rufen Sie die InitializeStatusBarPanels-Methode im Konstruktor oder im Load-Ereignishandler des Formulars auf.

Friend WithEvents statusBar1 As System.Windows.Forms.StatusBar

Private Sub InitializeStatusBarPanels()

    ' Create a StatusBar control.
    statusBar1 = New StatusBar

    ' Dock the status bar at the top of the form. 
    statusBar1.Dock = DockStyle.Top

    ' Set the SizingGrip property to false so the user cannot 
    ' resize the status bar.
    statusBar1.SizingGrip = False

    ' Create two StatusBarPanel objects to display in statusBar1.
    Dim panel1 As New StatusBarPanel
    Dim panel2 As New StatusBarPanel

    ' Set the width of panel2 explicitly and set
    ' panel1 to fill in the remaining space.
    panel2.Width = 80
    panel1.AutoSize = StatusBarPanelAutoSize.Spring

    ' Set the text alignment within each panel.
    panel1.Alignment = HorizontalAlignment.Left
    panel2.Alignment = HorizontalAlignment.Right

    ' Display the first panel without a border and the second
    ' with a raised border.
    panel1.BorderStyle = StatusBarPanelBorderStyle.None
    panel2.BorderStyle = StatusBarPanelBorderStyle.Raised

    ' Set the text of the panels. The panel1 object is reserved
    ' for line numbers, while panel2 is set to the current time.
    panel1.Text = "Reserved for important information."
    panel2.Text = System.DateTime.Now.ToShortTimeString

    ' Set a tooltip for panel2
    panel2.ToolTipText = "Click time to display seconds"

    ' Display panels in statusBar1 and add them to the
    ' status bar's StatusBarPanelCollection.
    statusBar1.ShowPanels = True
    statusBar1.Panels.Add(panel1)
    statusBar1.Panels.Add(panel2)

    ' Add the StatusBar to the form.
    Me.Controls.Add(statusBar1)
End Sub


' If the user clicks the status bar, check the text of the 
' StatusBarPanel.  If the text equals a short time string,
' change it to long time display.
Private Sub statusBar1_PanelClick(ByVal sender As Object, _
    ByVal e As StatusBarPanelClickEventArgs) _
        Handles statusBar1.PanelClick
    If (e.StatusBarPanel.Text = _
        System.DateTime.Now.ToShortTimeString) Then
        e.StatusBarPanel.Text = System.DateTime.Now.ToLongTimeString
    End If
End Sub

internal System.Windows.Forms.StatusBar statusBar1;

private void InitializeStatusBarPanels()
{

    // Create a StatusBar control.
    statusBar1 = new StatusBar();

    // Dock the status bar at the top of the form. 
    statusBar1.Dock = DockStyle.Top;

    // Set the SizingGrip property to false so the user cannot 
    // resize the status bar.
    statusBar1.SizingGrip = false;

    // Associate the event-handling method with the 
    // PanelClick event.
    statusBar1.PanelClick += 
        new StatusBarPanelClickEventHandler(statusBar1_PanelClick);

    // Create two StatusBarPanel objects to display in statusBar1.
    StatusBarPanel panel1 = new StatusBarPanel();
    StatusBarPanel panel2 = new StatusBarPanel();

    // Set the width of panel2 explicitly and set
    // panel1 to fill in the remaining space.
    panel2.Width = 80;
    panel1.AutoSize = StatusBarPanelAutoSize.Spring;

    // Set the text alignment within each panel.
    panel1.Alignment = HorizontalAlignment.Left;
    panel2.Alignment = HorizontalAlignment.Right;

    // Display the first panel without a border and the second
    // with a raised border.
    panel1.BorderStyle = StatusBarPanelBorderStyle.None;
    panel2.BorderStyle = StatusBarPanelBorderStyle.Raised;

    // Set the text of the panels. The panel1 object is reserved
    // for line numbers, while panel2 is set to the current time.
    panel1.Text = "Reserved for important information.";
    panel2.Text = System.DateTime.Now.ToShortTimeString();

    // Set a tooltip for panel2
    panel2.ToolTipText = "Click time to display seconds";

    // Display panels in statusBar1 and add them to the
    // status bar's StatusBarPanelCollection.
    statusBar1.ShowPanels = true;
    statusBar1.Panels.Add(panel1);
    statusBar1.Panels.Add(panel2);

    // Add the StatusBar to the form.
    this.Controls.Add(statusBar1);
}


// If the user clicks the status bar, check the text of the 
// StatusBarPanel.  If the text equals a short time string,
// change it to long time display.
private void statusBar1_PanelClick(object sender, 
    StatusBarPanelClickEventArgs e)
{
    if (e.StatusBarPanel.Text == 
        System.DateTime.Now.ToShortTimeString())
    {
        e.StatusBarPanel.Text = 
            System.DateTime.Now.ToLongTimeString();
    }
}

internal:
   System::Windows::Forms::StatusBar^ statusBar1;

private:
   void InitializeStatusBarPanels()
   {
      
      // Create a StatusBar control.
      statusBar1 = gcnew StatusBar;
      
      // Dock the status bar at the top of the form. 
      statusBar1->Dock = DockStyle::Top;
      
      // Set the SizingGrip property to false so the user cannot 
      // resize the status bar.
      statusBar1->SizingGrip = false;
      
      // Associate the event-handling method with the 
      // PanelClick event.
      statusBar1->PanelClick += gcnew StatusBarPanelClickEventHandler( this, &Form1::statusBar1_PanelClick );
      
      // Create two StatusBarPanel objects to display in statusBar1.
      StatusBarPanel^ panel1 = gcnew StatusBarPanel;
      StatusBarPanel^ panel2 = gcnew StatusBarPanel;
      
      // Set the width of panel2 explicitly and set
      // panel1 to fill in the remaining space.
      panel2->Width = 80;
      panel1->AutoSize = StatusBarPanelAutoSize::Spring;
      
      // Set the text alignment within each panel.
      panel1->Alignment = HorizontalAlignment::Left;
      panel2->Alignment = HorizontalAlignment::Right;
      
      // Display the first panel without a border and the second
      // with a raised border.
      panel1->BorderStyle = StatusBarPanelBorderStyle::None;
      panel2->BorderStyle = StatusBarPanelBorderStyle::Raised;
      
      // Set the text of the panels. The panel1 object is reserved
      // for line numbers, while panel2 is set to the current time.
      panel1->Text = "Reserved for important information.";
      panel2->Text = System::DateTime::Now.ToShortTimeString();
      
      // Set a tooltip for panel2
      panel2->ToolTipText = "Click time to display seconds";
      
      // Display panels in statusBar1 and add them to the
      // status bar's StatusBarPanelCollection.
      statusBar1->ShowPanels = true;
      statusBar1->Panels->Add( panel1 );
      statusBar1->Panels->Add( panel2 );
      
      // Add the StatusBar to the form.
      this->Controls->Add( statusBar1 );
   }

   // If the user clicks the status bar, check the text of the 
   // StatusBarPanel.  If the text equals a short time string,
   // change it to long time display.
   void statusBar1_PanelClick( Object^ /*sender*/, StatusBarPanelClickEventArgs^ e )
   {
      if ( e->StatusBarPanel->Text == System::DateTime::Now.ToShortTimeString() )
      {
         e->StatusBarPanel->Text = System::DateTime::Now.ToLongTimeString();
      }
   }

System.Windows.Forms.StatusBar statusBar1;

private void InitializeStatusBarPanels()
{
    // Create a StatusBar control.
    statusBar1 = new StatusBar();
    // Dock the status bar at the top of the form. 
    statusBar1.set_Dock(DockStyle.Top);
    // Set the SizingGrip property to false so the user cannot 
    // resize the status bar.
    statusBar1.set_SizingGrip(false);
    // Associate the event-handling method with the 
    // PanelClick event.
    statusBar1.add_PanelClick(new StatusBarPanelClickEventHandler(
        statusBar1_PanelClick));
    // Create two StatusBarPanel objects to display in statusBar1.
    StatusBarPanel panel1 = new StatusBarPanel();
    StatusBarPanel panel2 = new StatusBarPanel();
    // Set the width of panel2 explicitly and set
    // panel1 to fill in the remaining space.
    panel2.set_Width(80);
    panel1.set_AutoSize(StatusBarPanelAutoSize.Spring);
    // Set the text alignment within each panel.
    panel1.set_Alignment(HorizontalAlignment.Left);
    panel2.set_Alignment(HorizontalAlignment.Right);
    // Display the first panel without a border and the second
    // with a raised border.
    panel1.set_BorderStyle(StatusBarPanelBorderStyle.None);
    panel2.set_BorderStyle(StatusBarPanelBorderStyle.Raised);
    // Set the text of the panels. The panel1 object is reserved
    // for line numbers, while panel2 is set to the current time.
    panel1.set_Text("Reserved for important information.");
    panel2.set_Text(System.DateTime.get_Now().ToShortTimeString());
    // Set a tooltip for panel2
    panel2.set_ToolTipText("Click time to display seconds");
    // Display panels in statusBar1 and add them to the
    // status bar's StatusBarPanelCollection.
    statusBar1.set_ShowPanels(true);
    statusBar1.get_Panels().Add(panel1);
    statusBar1.get_Panels().Add(panel2);
    // Add the StatusBar to the form.
    this.get_Controls().Add(statusBar1);
} //InitializeStatusBarPanels

// If the user clicks the status bar, check the text of the 
// StatusBarPanel. If the text equals a short time string,
// change it to long time display.
private void statusBar1_PanelClick(Object sender,
    StatusBarPanelClickEventArgs e)
{
    if (e.get_StatusBarPanel().get_Text().Equals(
        System.DateTime.get_Now().ToShortTimeString())) {
        e.get_StatusBarPanel().set_Text(System.DateTime.get_Now().
            ToLongTimeString());
    }
} //statusBar1_PanelClick

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

StatusBar-Klasse
StatusBar-Member
System.Windows.Forms-Namespace
Form.FormBorderStyle-Eigenschaft
FormBorderStyle-Enumeration