ToolBarButton Clase

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa un botón de barra de herramientas de Windows.

Esta clase no está disponible en .NET Core 3.1 y versiones posteriores. En su lugar se usa ToolStripButton, que reemplaza y extiende el control ToolBarButton.

public ref class ToolBarButton : System::ComponentModel::Component

public class ToolBarButton : System.ComponentModel.Component

type ToolBarButton = class
    inherit Component

Public Class ToolBarButton
Inherits Component

Herencia: Object

MarshalByRefObject

Component
ToolBarButton

Ejemplos

En el ejemplo de código siguiente se crean tres ToolBar controles y ToolBarButton . Los botones de la barra de herramientas se asignan a la colección de botones, la colección se asigna a la barra de herramientas y la barra de herramientas se agrega al formulario. En el ButtonClick evento de la barra de herramientas, la Button propiedad de ToolBarButtonClickEventArgs se evalúa y se abre el cuadro de diálogo adecuado. Este código requiere que se hayan creado todos los Formelementos , OpenFileDialog SaveFileDialogy PrintDialog .

public:
   void InitializeMyToolBar()
   {
      // Create and initialize the ToolBar and ToolBarButton controls.
      toolBar1 = gcnew ToolBar;
      ToolBarButton^ toolBarButton1 = gcnew ToolBarButton;
      ToolBarButton^ toolBarButton2 = gcnew ToolBarButton;
      ToolBarButton^ toolBarButton3 = gcnew ToolBarButton;
      
      // Set the Text properties of the ToolBarButton controls.
      toolBarButton1->Text = "Open";
      toolBarButton2->Text = "Save";
      toolBarButton3->Text = "Print";
      
      // Add the ToolBarButton controls to the ToolBar.
      toolBar1->Buttons->Add( toolBarButton1 );
      toolBar1->Buttons->Add( toolBarButton2 );
      toolBar1->Buttons->Add( toolBarButton3 );
      
      // Add the event-handler delegate.
      toolBar1->ButtonClick += gcnew ToolBarButtonClickEventHandler(
         this, &Form1::toolBar1_ButtonClick );
      
      // Add the ToolBar to the Form.
      Controls->Add( toolBar1 );
   }

private:
   void toolBar1_ButtonClick(
      Object^ sender,
      ToolBarButtonClickEventArgs^ e )
   {
      // Evaluate the Button property to determine which button was clicked.
      switch ( toolBar1->Buttons->IndexOf( e->Button ) )
      {
         case 0:
            openFileDialog1->ShowDialog();
            // Insert code to open the file.
            break;
         case 1:
            saveFileDialog1->ShowDialog();
            // Insert code to save the file.
            break;
         case 2:
            printDialog1->ShowDialog();
            // Insert code to print the file.    
            break;
      }
   }

public void InitializeMyToolBar()
 {
    // Create and initialize the ToolBar and ToolBarButton controls.
    toolBar1 = new ToolBar();
    ToolBarButton toolBarButton1 = new ToolBarButton();
    ToolBarButton toolBarButton2 = new ToolBarButton();
    ToolBarButton toolBarButton3 = new ToolBarButton();
 
    // Set the Text properties of the ToolBarButton controls.
    toolBarButton1.Text = "Open";
    toolBarButton2.Text = "Save";
    toolBarButton3.Text = "Print";
 
    // Add the ToolBarButton controls to the ToolBar.
    toolBar1.Buttons.Add(toolBarButton1);
    toolBar1.Buttons.Add(toolBarButton2);
    toolBar1.Buttons.Add(toolBarButton3);
    
    // Add the event-handler delegate.
    toolBar1.ButtonClick += new ToolBarButtonClickEventHandler (
       this.toolBar1_ButtonClick);
    
    // Add the ToolBar to the Form.
    Controls.Add(toolBar1);
 }
 
 private void toolBar1_ButtonClick (
                         Object sender, 
                         ToolBarButtonClickEventArgs e)
 {
   // Evaluate the Button property to determine which button was clicked.
   switch(toolBar1.Buttons.IndexOf(e.Button))
   {
      case 0:
         openFileDialog1.ShowDialog();
         // Insert code to open the file.
         break; 
      case 1:
         saveFileDialog1.ShowDialog();
         // Insert code to save the file.
         break; 
      case 2:
         printDialog1.ShowDialog();
         // Insert code to print the file.    
         break; 
    }
 }

Public Sub InitializeMyToolBar()
    ' Create and initialize the ToolBar and ToolBarButton controls.
    Dim toolBar1 As New ToolBar()
    Dim toolBarButton1 As New ToolBarButton()
    Dim toolBarButton2 As New ToolBarButton()
    Dim toolBarButton3 As New ToolBarButton()
    
    ' Set the Text properties of the ToolBarButton controls.
    toolBarButton1.Text = "Open"
    toolBarButton2.Text = "Save"
    toolBarButton3.Text = "Print"
    
    ' Add the ToolBarButton controls to the ToolBar.
    toolBar1.Buttons.Add(toolBarButton1)
    toolBar1.Buttons.Add(toolBarButton2)
    toolBar1.Buttons.Add(toolBarButton3)
    
    ' Add the event-handler delegate.
    AddHandler toolBar1.ButtonClick, AddressOf Me.toolBar1_ButtonClick
    
    ' Add the ToolBar to the Form.
    Controls.Add(toolBar1)
End Sub    

Private Sub toolBar1_ButtonClick(ByVal sender As Object, _
ByVal e As ToolBarButtonClickEventArgs)

    ' Evaluate the Button property to determine which button was clicked.
    Select Case toolBar1.Buttons.IndexOf(e.Button)
        Case 0
            openFileDialog1.ShowDialog()
            ' Insert code to open the file.
        Case 1
            saveFileDialog1.ShowDialog()
            ' Insert code to save the file.
        Case 2
            printDialog1.ShowDialog()
            ' Insert code to print the file.
    End Select
End Sub

Comentarios

Esta clase no está disponible en .NET Core 3.1 y versiones posteriores. Utilice ToolStripButton en su lugar.

ToolBarButton los controles son primarios por ToolBar controles. Las propiedades comunes que se van a establecer una vez creado el botón de la barra de herramientas son Text y ImageIndex. Establezca la Text propiedad del botón para mostrar texto debajo o a la derecha de la imagen. Para asignar imágenes a los botones mediante la creación de , ImageListasígnela a la ImageList propiedad de la barra de herramientas; a continuación, asigne el valor de índice de imagen a la ImageIndex propiedad del botón.

Para cambiar la apariencia de los botones de la barra de herramientas asignados a la barra de herramientas, establezca la Appearance propiedad del control primario de la barra de herramientas. La ToolBarAppearance.Flat apariencia proporciona a los botones un aspecto plano. A medida que el puntero del mouse se mueve sobre los botones, su apariencia cambia a tridimensional. Los separadores de botón aparecen como líneas en lugar de espacios entre los botones cuando los botones tienen una apariencia plana. Si la Appearance propiedad se establece ToolBarAppearance.Normalen , los botones aparecen elevados y tridimensionales, y los separadores aparecen como un espacio entre los botones.

Puede asignar un ContextMenu a un botón si la Style propiedad está establecida en ToolBarButtonStyle.DropDown. Cuando se hace clic en el botón, se muestra el menú asignado.

Para crear una colección de ToolBarButton controles que se van a mostrar en , ToolBaragregue los botones individualmente mediante el Add método de la Buttons propiedad . Como alternativa, puede agregar varios botones de barra de herramientas mediante el AddRange método .

Constructores

ToolBarButton()	Inicializa una nueva instancia de la clase ToolBarButton.
ToolBarButton(String)	Inicializa una nueva instancia de la clase ToolBarButton y muestra el texto asignado en el botón.

Propiedades

CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
Container	Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component)
DesignMode	Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component)
DropDownMenu	Obtiene o establece el menú que se va a mostrar en el botón de barra de herramientas desplegable.
Enabled	Obtiene o establece un valor que indica si el botón está habilitado.
Events	Obtiene la lista de controladores de eventos asociados a Component. (Heredado de Component)
ImageIndex	Obtiene o establece el valor de índice de la imagen asignada al botón.
ImageKey	Obtiene o establece el nombre de la imagen asignada al botón.
Name	El nombre del botón.
Parent	Indica el control de la barra de herramientas al que está asignado el botón de barra de herramientas.
PartialPush	Obtiene o establece un valor que indica si un botón de barra de herramientas de tipo botón de alternar está parcialmente presionado.
Pushed	Obtiene o establece un valor que indica si un botón de barra de herramientas de tipo botón de alternar está actualmente en el estado presionado.
Rectangle	Obtiene el rectángulo de delimitación para un botón de barra de herramientas.
Site	Obtiene o establece ISite de Component. (Heredado de Component)
Style	Obtiene o establece el estilo del botón de barra de herramientas.
Tag	Obtiene o establece el objeto que contiene datos acerca del botón de barra de herramientas.
Text	Obtiene o establece el texto mostrado en el botón de barra de herramientas.
ToolTipText	Obtiene o establece el texto que aparece como información sobre herramientas para el botón.
Visible	Obtiene o establece un valor que indica si está visible el botón de barra de herramientas.

Métodos

CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos que usa Component. (Heredado de Component)
Dispose(Boolean)	Libera los recursos no administrados que usa ToolBarButton y, de forma opcional, libera los recursos administrados.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Obsoletos. Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetService(Type)	Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obsoletos. Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
ToString()	Devuelve una cadena que representa el control ToolBarButton.

Eventos

Disposed

Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose().

(Heredado de Component)

Se aplica a

Compartir vía