SplitContainer.SplitterDistance Propiedad

Definición

Obtiene o establece la ubicación del divisor, en píxeles, desde el borde izquierdo o superior del contenedor SplitContainer.Gets or sets the location of the splitter, in pixels, from the left or top edge of the SplitContainer.

public:
 property int SplitterDistance { int get(); void set(int value); };
[System.ComponentModel.SettingsBindable(true)]
public int SplitterDistance { get; set; }
member this.SplitterDistance : int with get, set
Public Property SplitterDistance As Integer

Valor de propiedad

Int32 que representa la ubicación del divisor, en píxeles, desde el borde izquierdo o superior del contenedor SplitContainer.An Int32 representing the location of the splitter, in pixels, from the left or top edge of the SplitContainer. El valor predeterminado es 50 píxeles.The default value is 50 pixels.

Atributos

Excepciones

El valor es menor que cero.The value is less than zero.

El valor no es compatible con la orientación.The value is incompatible with the orientation.

Ejemplos

En el ejemplo de código siguiente se especifica que la distancia inicial del divisor vertical del borde izquierdo del contenedor es de 79 píxeles.The following code example specifies that the initial distance of the vertical splitter from the left edge of the container is 79 pixels. También se muestran otras propiedades básicas de un divisor vertical.Other basic properties of a vertical splitter are also shown. Este ejemplo forma parte de un ejemplo más extenso proporcionado para la clase SplitContainer.This example is part of a larger example provided for the SplitContainer class.

// Basic SplitContainer properties.
// This is a vertical splitter that moves in 10-pixel increments.
// This splitter needs no explicit Orientation property because Vertical is the default.
splitContainer1->Dock = System::Windows::Forms::DockStyle::Fill;
splitContainer1->ForeColor = System::Drawing::SystemColors::Control;
splitContainer1->Location = System::Drawing::Point( 0, 0 );
splitContainer1->Name = "splitContainer1";

// You can drag the splitter no nearer than 30 pixels from the left edge of the container.
splitContainer1->Panel1MinSize = 30;

// You can drag the splitter no nearer than 20 pixels from the right edge of the container.
splitContainer1->Panel2MinSize = 20;
splitContainer1->Size = System::Drawing::Size( 292, 273 );
splitContainer1->SplitterDistance = 79;

// This splitter moves in 10-pixel increments.
splitContainer1->SplitterIncrement = 10;
splitContainer1->SplitterWidth = 6;

// splitContainer1 is the first control in the tab order.
splitContainer1->TabIndex = 0;
splitContainer1->Text = "splitContainer1";

// When the splitter moves, the cursor changes shape.
splitContainer1->SplitterMoved += gcnew System::Windows::Forms::SplitterEventHandler( this, &Form1::splitContainer1_SplitterMoved );
splitContainer1->SplitterMoving += gcnew System::Windows::Forms::SplitterCancelEventHandler( this, &Form1::splitContainer1_SplitterMoving );

// Add a TreeView control to the left panel.
splitContainer1->Panel1->BackColor = System::Drawing::SystemColors::Control;

// Add a TreeView control to Panel1.
splitContainer1->Panel1->Controls->Add( treeView1 );
splitContainer1->Panel1->Name = "splitterPanel1";

// Controls placed on Panel1 support right-to-left fonts.
splitContainer1->Panel1->RightToLeft = System::Windows::Forms::RightToLeft::Yes;

// Basic SplitContainer properties.
// This is a vertical splitter that moves in 10-pixel increments.
// This splitter needs no explicit Orientation property because Vertical is the default.
splitContainer1.Dock = System.Windows.Forms.DockStyle.Fill;
splitContainer1.ForeColor = System.Drawing.SystemColors.Control;
splitContainer1.Location = new System.Drawing.Point(0, 0);
splitContainer1.Name = "splitContainer1";
// You can drag the splitter no nearer than 30 pixels from the left edge of the container.
splitContainer1.Panel1MinSize = 30;
// You can drag the splitter no nearer than 20 pixels from the right edge of the container.
splitContainer1.Panel2MinSize = 20;
splitContainer1.Size = new System.Drawing.Size(292, 273);
splitContainer1.SplitterDistance = 79;
// This splitter moves in 10-pixel increments.
splitContainer1.SplitterIncrement = 10;
splitContainer1.SplitterWidth = 6;
// splitContainer1 is the first control in the tab order.
splitContainer1.TabIndex = 0;
splitContainer1.Text = "splitContainer1";
// When the splitter moves, the cursor changes shape.
splitContainer1.SplitterMoved += new System.Windows.Forms.SplitterEventHandler(splitContainer1_SplitterMoved);
splitContainer1.SplitterMoving += new System.Windows.Forms.SplitterCancelEventHandler(splitContainer1_SplitterMoving);

// Add a TreeView control to the left panel.
splitContainer1.Panel1.BackColor = System.Drawing.SystemColors.Control;
// Add a TreeView control to Panel1.
splitContainer1.Panel1.Controls.Add(treeView1);
splitContainer1.Panel1.Name = "splitterPanel1";
// Controls placed on Panel1 support right-to-left fonts.
splitContainer1.Panel1.RightToLeft = System.Windows.Forms.RightToLeft.Yes;
' Basic SplitContainer properties.
' This is a vertical splitter that moves in 10-pixel increments.
' This splitter needs no explicit Orientation property because Vertical is the default.
splitContainer1.Dock = System.Windows.Forms.DockStyle.Fill
splitContainer1.ForeColor = System.Drawing.SystemColors.Control
splitContainer1.Location = New System.Drawing.Point(0, 0)
splitContainer1.Name = "splitContainer1"
' You can drag the splitter no nearer than 30 pixels from the left edge of the container.
splitContainer1.Panel1MinSize = 30
' You can drag the splitter no nearer than 20 pixels from the right edge of the container.
splitContainer1.Panel2MinSize = 20
splitContainer1.Size = New System.Drawing.Size(292, 273)
splitContainer1.SplitterDistance = 79
' This splitter moves in 10-pixel increments.
splitContainer1.SplitterIncrement = 10
splitContainer1.SplitterWidth = 6
' splitContainer1 is the first control in the tab order.
splitContainer1.TabIndex = 0
splitContainer1.Text = "splitContainer1"
  
' Add a TreeView control to the left panel.
splitContainer1.Panel1.BackColor = System.Drawing.SystemColors.Control
' Add a TreeView control to Panel1.
splitContainer1.Panel1.Controls.Add(treeView1)
splitContainer1.Panel1.Name = "splitterPanel1"
' Controls placed on Panel1 support right-to-left fonts.
splitContainer1.Panel1.RightToLeft = System.Windows.Forms.RightToLeft.Yes

Comentarios

Use la propiedad SplitterDistance para determinar o especificar la distancia en píxeles entre el divisor y el borde izquierdo o superior del contenedor.Use the SplitterDistance property to determine or specify the distance in pixels of the splitter from the left or top edge of the container. Puede especificar una distancia inicial y cambiar la distancia en tiempo de diseño o en tiempo de ejecución.You can both specify an initial distance and change the distance at design time or run time. Si Orientation es Horizontal, SplitterDistance se calcula en píxeles desde el borde superior del SplitContainer.If Orientation is Horizontal, SplitterDistance is calculated in pixels from the top edge of the SplitContainer. Si Orientation es Vertical, SplitterDistance se calcula en píxeles desde el borde izquierdo del SplitContainer.If Orientation is Vertical, SplitterDistance is calculated in pixels from the left edge of the SplitContainer.

Se aplica a

Consulte también: