ScrollableControl.DockPadding-Eigenschaft

Ruft die Einstellungen für den Andockleerraum für alle Ränder des Steuerelements ab.

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

Syntax

'Declaration
Public ReadOnly Property DockPadding As DockPaddingEdges
'Usage
Dim instance As ScrollableControl
Dim value As DockPaddingEdges

value = instance.DockPadding

public DockPaddingEdges DockPadding { get; }

public:
property DockPaddingEdges^ DockPadding {
    DockPaddingEdges^ get ();
}

/** @property */
public DockPaddingEdges get_DockPadding ()

public function get DockPadding () : DockPaddingEdges

Eigenschaftenwert

Eine Instanz der ScrollableControl.DockPaddingEdges-Klasse, die den Abstand für alle Ränder eines angedockten Steuerelements darstellt.

Hinweise

Über diese Eigenschaft wird bei angedockten Komponenten der innere Rahmen dieses Steuerelements gesteuert.

Beispiel

Im folgenden Codebeispiel wird die abgeleitete Klasse Panel verwendet. Im Beispiel wird eine Schaltfläche in einem Auswahlbereich-Steuerelement angedockt. Außerdem werden die ScrollableControl.DockPaddingEdges-Eigenschaften durchlaufen, die jeweils durch Klicken auf die Schaltfläche festgelegt werden. Für das Beispiel ist es erforderlich, dass Sie eine Instanz eines Panel-Steuerelements und einen Button auf einem Formular erstellt sowie eine Membervariable auf Klassenebene mit dem Namen myCounter als 32-Bit-Ganzzahl mit Vorzeichen deklariert haben. Diesen Code müssen Sie für das Click-Ereignis der Schaltfläche aufrufen.

Private Sub SetDockPadding()
    ' Dock the button in the panel.
    button1.Dock = System.Windows.Forms.DockStyle.Fill
    
    ' Reset the counter if it is greater than 5.
    If myCounter > 5 Then
        myCounter = 0
    End If
    
    ' Set the appropriate DockPadding and display
    ' which one was set on the button face.
    Select Case myCounter
        Case 0
            panel1.DockPadding.All = 0
            button1.Text = "Start"
        Case 1
            panel1.DockPadding.Top = 10
            button1.Text = "Top"
        Case 2
            panel1.DockPadding.Bottom = 10
            button1.Text = "Bottom"
        Case 3
            panel1.DockPadding.Left = 10
            button1.Text = "Left"
        Case 4
            panel1.DockPadding.Right = 10
            button1.Text = "Right"
        Case 5
            panel1.DockPadding.All = 20
            button1.Text = "All"
    End Select
    
    ' Increment the counter.
    myCounter += 1
End Sub

private void SetDockPadding()
 {
    // Dock the button in the panel.
    button1.Dock = System.Windows.Forms.DockStyle.Fill;
    
    // Reset the counter if it is greater than 5.
    if (myCounter > 5)
    {
       myCounter = 0;
    }
 
    // Set the appropriate DockPadding and display
    // which one was set on the button face.
    switch (myCounter)
    {
       case 0:
          panel1.DockPadding.All = 0;
          button1.Text = "Start";
          break;
       case 1:
          panel1.DockPadding.Top = 10;
          button1.Text = "Top";
          break;
       case 2:
          panel1.DockPadding.Bottom = 10;
          button1.Text = "Bottom";
          break;
       case 3:
          panel1.DockPadding.Left = 10;
          button1.Text = "Left";
          break;
       case 4:
          panel1.DockPadding.Right = 10;
          button1.Text = "Right";
          break;
       case 5:
          panel1.DockPadding.All = 20;
          button1.Text = "All";
          break;
    }
    
    // Increment the counter.
    myCounter += 1;
 }
 

void SetDockPadding()
{
   // Dock the button in the panel.
   button1->Dock = System::Windows::Forms::DockStyle::Fill;

   // Reset the counter if it is greater than 5.
   if ( myCounter > 5 )
   {
      myCounter = 0;
   }

   // Set the appropriate DockPadding and display
   // which one was set on the button face.
   switch ( myCounter )
   {
      case 0:
         panel1->DockPadding->All = 0;
         button1->Text = "Start";
         break;

      case 1:
         panel1->DockPadding->Top = 10;
         button1->Text = "Top";
         break;

      case 2:
         panel1->DockPadding->Bottom = 10;
         button1->Text = "Bottom";
         break;

      case 3:
         panel1->DockPadding->Left = 10;
         button1->Text = "Left";
         break;

      case 4:
         panel1->DockPadding->Right = 10;
         button1->Text = "Right";
         break;

      case 5:
         panel1->DockPadding->All = 20;
         button1->Text = "All";
         break;
   }
   myCounter++;
}

private void SetDockPadding()
{
    // Dock the button in the panel.
    button1.set_Dock(System.Windows.Forms.DockStyle.Fill);

    // Reset the counter if it is greater than 5.
    if (myCounter > 5) {
        myCounter = 0;
    }

    // Set the appropriate DockPadding and display
    // which one was set on the button face.
    switch (myCounter) {
        case 0 :
            panel1.get_DockPadding().set_All(0);
            button1.set_Text("Start");
            break;

        case 1 :
            panel1.get_DockPadding().set_Top(10);
            button1.set_Text("Top");
            break;

        case 2 :
            panel1.get_DockPadding().set_Bottom(10);
            button1.set_Text("Bottom");
            break;

        case 3 :
            panel1.get_DockPadding().set_Left(10);
            button1.set_Text("Left");
            break;

        case 4 :
            panel1.get_DockPadding().set_Right(10);
            button1.set_Text("Right");
            break;

        case 5 :
            panel1.get_DockPadding().set_All(20);
            button1.set_Text("All");
            break;
    }

    // Increment the counter.
    myCounter += 1;
} //SetDockPadding

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, 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

ScrollableControl-Klasse
ScrollableControl-Member
System.Windows.Forms-Namespace
ScrollableControl.DockPaddingEdges
Control.Padding-Eigenschaft
Control.Margin-Eigenschaft
ScrollableControl.AutoScrollMargin-Eigenschaft