ToolStripItem.ImageIndex Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece el valor de índice de la imagen mostrada en el elemento.

public:
 property int ImageIndex { int get(); void set(int value); };

[System.ComponentModel.Browsable(false)]
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))]
[System.Windows.Forms.RelatedImageList("Owner.ImageList")]
public int ImageIndex { get; set; }

[<System.ComponentModel.Browsable(false)>]
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))>]
[<System.Windows.Forms.RelatedImageList("Owner.ImageList")>]
member this.ImageIndex : int with get, set

Public Property ImageIndex As Integer

Valor de propiedad

Int32

Índice de base cero de la imagen en el ImageList que se muestra para el elemento. El valor predeterminado es -1, lo que significa que la lista de imágenes está vacía.

Atributos

BrowsableAttribute TypeConverterAttribute RelatedImageListAttribute

Excepciones

ArgumentOutOfRangeException

value es menor que 1.

Comentarios

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 ("").

Las Imagepropiedades , ImageAlign, ImageIndex, ImageKeyy ImageScaling pertenecen a varios aspectos del control de imágenes. Use imágenes en ToolStrip controles estableciendo estas propiedades directamente o estableciendo la propiedad solo ImageList en tiempo de ejecución.

El escalado de imágenes viene determinado por la interacción de las propiedades en ToolStrip y ToolStripItem, como se indica a continuación:

• ImageScalingSize es la escala de la imagen final determinada por la combinación de la configuración de la imagen ImageScaling y la configuración del AutoSize contenedor.

  • Si AutoSize es true (el valor predeterminado) y ToolStripItemImageScaling es SizeToFit, no se produce ningún escalado de imágenes y el ToolStrip tamaño es el del elemento más grande o un tamaño mínimo prescrito.

  • Si AutoSize es y ToolStripItemImageScaling es Nonefalse , no se produce ninguna imagen ni ToolStrip escalado.

Si el valor de la ImageList propiedad se cambia a null, la ImageIndex propiedad devuelve su valor predeterminado, -1. Sin embargo, el valor asignado ImageIndex se conserva internamente y se usa cuando se asigna otro ImageList objeto a la ImageList propiedad . Si el nuevo ImageList asignado a la ImageList propiedad tiene un ImageList.ImageCollection.Count valor de propiedad menor o igual que el valor asignado a la ImageIndex propiedad menos uno (para tener en cuenta que la colección es un índice de base cero), el ImageIndex valor de propiedad se ajusta a uno menor que el valor de propiedad Count . Por ejemplo, considere un control de botón cuya propiedad ImageList tiene tres imágenes y cuya ImageIndex propiedad está establecida en 2. Si un nuevo ImageList que solo tiene dos imágenes se asigna al botón, el ImageIndex valor cambia a 1.