ToolStripItem.ImageIndex Propiedad
Definición
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í.
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, setPublic Property ImageIndex As IntegerValor de propiedad
Í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
Excepciones
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 None
false, 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.