ToolBarButton.ImageIndex Propiedad

Definición

Obtiene o establece el valor de índice de la imagen asignada al botón.

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int ImageIndex { get; set; }

Valor de propiedad

Int32

El valor de índice del objeto Image asignado al botón de barra de herramientas. El valor predeterminado es -1.

Atributos

Excepciones

value es menor que 1.

Ejemplos

En el ejemplo de código siguiente se crea un ToolBar y tres ToolBarButton controles, se asignan los botones a la barra de herramientas y se establecen algunas de las propiedades comunes de los botones. Este código requiere que se haya creado , MenuItemImageListToolTip y Form y que ImageList tenga al menos uno Image asignado.

public void InitializeMyToolBar()
 {
    // Create the ToolBar, ToolBarButton controls, and menus.
    ToolBarButton toolBarButton1 = new ToolBarButton("Open");
    ToolBarButton toolBarButton2 = new ToolBarButton();
    ToolBarButton toolBarButton3 = new ToolBarButton();
    ToolBar toolBar1 = new ToolBar();
    MenuItem menuItem1 = new MenuItem("Print");
    ContextMenu contextMenu1 = new ContextMenu(new MenuItem[]{menuItem1});

    // Add the ToolBarButton controls to the ToolBar.
    toolBar1.Buttons.Add(toolBarButton1);
    toolBar1.Buttons.Add(toolBarButton2);
    toolBar1.Buttons.Add(toolBarButton3);
 
    // Assign an ImageList to the ToolBar and show ToolTips.
    toolBar1.ImageList = imageList1;
    toolBar1.ShowToolTips = true;
 
    /* Assign ImageIndex, ContextMenu, Text, ToolTip, and 
       Style properties of the ToolBarButton controls. */
    toolBarButton2.Style = ToolBarButtonStyle.Separator;
    toolBarButton3.Text = "Print";
    toolBarButton3.Style = ToolBarButtonStyle.DropDownButton;
    toolBarButton3.ToolTipText = "Print";
    toolBarButton3.ImageIndex = 0;
    toolBarButton3.DropDownMenu = contextMenu1;
 
    // Add the ToolBar to a form.
    Controls.Add(toolBar1);
 }

Comentarios

El ImageIndex valor hace referencia al valor indizado de las imágenes de un ImageList control primario ToolBar asignado.

ImageKey y ImageIndex son mutuamente excluyentes, lo que significa que, si se establece uno, el otro se establece en un valor no válido y se omite. Si establece la ImageKey propiedad , la ImageIndex propiedad se establece automáticamente en -1. Como alternativa, si establece la ImageIndex propiedad , se ImageKey establece automáticamente en una cadena vacía ("").

Se aplica a

Consulte también