Microsoft.com
Bienvenido Iniciar sesión
Inicio de .NET Framework
 Versión imprimible       Enviar     
Evaluar y enviar comentarios

  Encender vista de ancho de banda bajo
Esta página es específica de
Microsoft Visual Studio 2005/.NET Framework 2.0

Hay además otras versiones disponibles para:
Splitter (Clase)
Representa un control divisor que le permite al usuario cambiar el tamaño de los controles acoplados. Splitter se ha reemplazado por SplitContainer y sólo se proporciona para la compatibilidad con versiones anteriores.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

Visual Basic (Declaración)
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class Splitter
    Inherits Control
Visual Basic (Uso)
Dim instance As Splitter
C#
[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
public class Splitter : Control
C++
[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] 
public ref class Splitter : public Control
J#
/** @attribute ComVisibleAttribute(true) */ 
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
public class Splitter extends Control
JScript
ComVisibleAttribute(true) 
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
public class Splitter extends Control
XAML
No aplicable.

El control Splitter permite cambiar el tamaño de los controles que están acoplados a los bordes del control Splitter en tiempo de ejecución. Cuando el usuario desplaza el puntero del mouse (ratón) por encima del control Splitter, el cursor cambia para indicar que se puede cambiar el tamaño de los controles acoplados al control Splitter. El control Splitter permite al usuario cambiar el tamaño del control acoplado que está inmediatamente antes de él en el orden de acoplamiento. Por lo tanto, para que el usuario pueda cambiar el tamaño de un control acoplado, acople al borde de un contenedor el control cuyo tamaño desea que el usuario pueda cambiar y, después, acople un separador al mismo lado de dicho contenedor. Por ejemplo, para crear una ventana similar a la del Explorador de Windows, agregue un control TreeView a un formulario y establezca su propiedad Dock en DockStyle.Left. Agregue un control Splitter al formulario y establezca también su propiedad Dock en DockStyle.Left. Para terminar el diseño del formulario, agregue un control ListView y establezca su propiedad Dock en DockStyle.Fill para que ListView ocupe el resto del espacio del formulario. En tiempo de ejecución, el usuario podrá cambiar el ancho del control TreeView (y del control ListView) moviendo el control Splitter.

Para asegurarse de que el control Splitter no reducirá el tamaño de los controles acoplados hasta un punto que no sea útil para el usuario, utilice las propiedades MinExtra y MinSize. Las propiedades MinExtra y MinSize determinan el tamaño mínimo al que se pueden ajustar los controles acoplados a la derecha e izquierda, o arriba y abajo si es un control Splitter horizontal. Si los demás controles del formulario al que está acoplado el control Splitter muestran un estilo de borde específico, puede utilizar la propiedad BorderStyle para que el estilo del borde coincida con el de los controles que están acoplados a él.

Es posible que desee establecer un tamaño máximo para los controles a los que está acoplado el control Splitter. Los eventos SplitterMoved y SplitterMoving permiten determinar si el usuario está cambiando el tamaño de un control acoplado. Puede utilizar la propiedad SplitPosition de un controlador de eventos para los eventos SplitterMoved o SplitterMoving para determinar el tamaño del control al que el control Splitter está acoplado y establecer la propiedad SplitPosition en un valor diferente para especificar el ancho máximo del control acoplado (o alto si se trata de un control Splitter alineado horizontalmente).

NotaNota:

El cambio de tamaño de un control mediante el control Splitter sólo se puede realizar con el mouse. No es posible el acceso al control Splitter mediante el teclado.

En el ejemplo de código siguiente se utiliza un control Splitter en combinación con los controles TreeView y ListView para crear una ventana similar a la del Explorador de Windows. Para identificar los controles TreeView y ListView, se agregan nodos y elementos a ambos controles. En el ejemplo se utilizan las propiedades MinExtra y MinSize del control Splitter para impedir que el nuevo tamaño de los controles TreeView o ListView sea demasiado pequeño o demasiado grande. En este ejemplo se requiere que el método creado esté definido en un objeto Form y que el método se llame desde el constructor de la clase Form.

Visual Basic
Private Sub CreateMySplitControls()
   ' Create TreeView, ListView, and Splitter controls.
   Dim treeView1 As New TreeView()
   Dim listView1 As New ListView()
   Dim splitter1 As New Splitter()
   
   ' Set the TreeView control to dock to the left side of the form.
   treeView1.Dock = DockStyle.Left
   ' Set the Splitter to dock to the left side of the TreeView control.
   splitter1.Dock = DockStyle.Left
   ' Set the minimum size the ListView control can be sized to.
      splitter1.MinExtra = 100
   ' Set the minimum size the TreeView control can be sized to.
      splitter1.MinSize = 75
   ' Set the ListView control to fill the remaining space on the form.
      listView1.Dock = DockStyle.Fill

      ' Add a TreeView and a ListView item to identify the controls on the form.
      treeView1.Nodes.Add("TreeView Node")
      listView1.Items.Add("ListView Item")
   
   ' Add the controls in reverse order to the form to ensure proper location.
   Me.Controls.AddRange(New Control() {listView1, splitter1, treeView1})
End Sub 'CreateMySplitControls
C#
private void CreateMySplitControls()
{
    // Create TreeView, ListView, and Splitter controls.
    TreeView treeView1 = new TreeView();
    ListView listView1 = new ListView();
    Splitter splitter1 = new Splitter();

    // Set the TreeView control to dock to the left side of the form.
    treeView1.Dock = DockStyle.Left;
    // Set the Splitter to dock to the left side of the TreeView control.
    splitter1.Dock = DockStyle.Left;
    // Set the minimum size the ListView control can be sized to.
    splitter1.MinExtra = 100;
    // Set the minimum size the TreeView control can be sized to.
    splitter1.MinSize = 75;
    // Set the ListView control to fill the remaining space on the form.
    listView1.Dock = DockStyle.Fill;
    // Add a TreeView and a ListView item to identify the controls on the form.
    treeView1.Nodes.Add("TreeView Node");
    listView1.Items.Add("ListView Item");

    // Add the controls in reverse order to the form to ensure proper location.
    this.Controls.AddRange(new Control[]{listView1, splitter1, treeView1});
}
C++
private:
   void CreateMySplitControls()
   {
      // Create TreeView, ListView, and Splitter controls.
      TreeView^ treeView1 = gcnew TreeView;
      ListView^ listView1 = gcnew ListView;
      Splitter^ splitter1 = gcnew Splitter;

      // Set the TreeView control to dock to the left side of the form.
      treeView1->Dock = DockStyle::Left;

      // Set the Splitter to dock to the left side of the TreeView control.
      splitter1->Dock = DockStyle::Left;

      // Set the minimum size the ListView control can be sized to.
      splitter1->MinExtra = 100;

      // Set the minimum size the TreeView control can be sized to.
      splitter1->MinSize = 75;

      // Set the ListView control to fill the remaining space on the form.
      listView1->Dock = DockStyle::Fill;

      // Add a TreeView and a ListView item to identify the controls on the form.
      treeView1->Nodes->Add( "TreeView Node" );
      listView1->Items->Add( "ListView Item" );

      // Add the controls in reverse order to the form to ensure proper location.
      array<Control^>^temp0 = {listView1,splitter1,treeView1};
      this->Controls->AddRange( temp0 );
   }
J#
private void CreateMySplitControls()
{
    // Create TreeView, ListView, and Splitter controls.
    TreeView treeView1 = new TreeView();
    ListView listView1 = new ListView();
    Splitter splitter1 = new Splitter();
    // Set the TreeView control to dock to the left side of the form.
    treeView1.set_Dock(DockStyle.Left);
    // Set the Splitter to dock to the left side of the TreeView control.
    splitter1.set_Dock(DockStyle.Left);
    // Set the minimum size the ListView control can be sized to.
    splitter1.set_MinExtra(100);
    // Set the minimum size the TreeView control can be sized to.
    splitter1.set_MinSize(75);
    // Set the ListView control to fill the remaining space on the form.
    listView1.set_Dock(DockStyle.Fill);
    // Add a TreeView and a ListView item to identify the controls on the 
    // form.
    treeView1.get_Nodes().Add("TreeView Node");
    listView1.get_Items().Add("ListView Item");
    // Add the controls in reverse order to the form to ensure proper 
    // location.
    this.get_Controls().AddRange(new Control[] { listView1, splitter1, 
        treeView1 });
} //CreateMySplitControls
System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.Control
        System.Windows.Forms.Splitter
Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0
© 2009 Microsoft Corporation. Reservados todos los derechos. Términos de uso  |  Marcas Registradas  |  Privacidad
Page view tracker