ScrollableControl.DockPaddingEdges.Top Property
Definition
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 or sets the padding width for the top edge of a docked control.
public:
property int Top { int get(); void set(int value); };public int Top { get; set; }member this.Top : int with get, setPublic Property Top As IntegerProperty Value
The padding width, in pixels.
Examples
The following code 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 requires that 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.
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.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;
}
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
Remarks
The padding width assigned to this property is applied only to the top edge of the docked control.
