ScrollableControl.DockPadding Property
Gets the dock padding settings for all edges of the control.
[Visual Basic] Public ReadOnly Property DockPadding As _ ScrollableControl.DockPaddingEdges [C#] public ScrollableControl.DockPaddingEdges DockPadding {get;} [C++] public: __property ScrollableControl.DockPaddingEdges* get_DockPadding(); [JScript] public function get DockPadding() : ScrollableControl.DockPaddingEdges;
Property Value
A ScrollableControl.DockPaddingEdges object that represents the padding for all the edges of a docked control.
Remarks
This property controls the border inside of this control for docked components.
Example
[Visual Basic, C#, C++] The following example uses the derived class, Panel. The example docks a button in a panel control and cycles through the ScrollableControl.DockPaddingEdges properties, setting each individually on the click of the button. This code assumes a Panel control and a Button have been instantiated on a form, and a class level member variable named myCounter has been declared as a 32-bit signed integer. This code should be called on the Click event of the button.
[Visual Basic] 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 [C#] 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; } [C++] 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 = S"Start"; break; case 1: panel1->DockPadding->Top = 10; button1->Text = S"Top"; break; case 2: panel1->DockPadding->Bottom = 10; button1->Text = S"Bottom"; break; case 3: panel1->DockPadding->Left = 10; button1->Text = S"Left"; break; case 4: panel1->DockPadding->Right = 10; button1->Text = S"Right"; break; case 5: panel1->DockPadding->All = 20; button1->Text = S"All"; break; } myCounter++; }
[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family
See Also
ScrollableControl Class | ScrollableControl Members | System.Windows.Forms Namespace | ScrollableControl.DockPaddingEdges