ToolStripItem.ImageIndex Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o valor de índice da imagem que é exibida no item.
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 Propriedade
O índice em base zero da imagem no ImageList que é exibido para o item. O padrão é -1, significando que a lista de imagens está vazia.
- Atributos
Exceções
value é inferior a -1.
Observações
ImageKey e ImageIndex são mutuamente exclusivas, ou seja, se um for definido, o outro é atribuído a um valor inválido e ignorado. Se definires a ImageKey propriedade, ela ImageIndex é automaticamente definida para -1. Alternativamente, se definir a ImageIndex propriedade, o ImageKey é automaticamente definido para uma cadeia vazia ("").
As propriedades Image, ImageAlign, ImageIndex, ImageKeye ImageScaling pertencem a vários aspetos do tratamento de imagens. Use imagens nos ToolStrip controlos definindo essas propriedades diretamente ou definindo a propriedade apenas ImageList em tempo de execução.
O dimensionamento de imagem é determinado pela interação de propriedades em ToolStrip e ToolStripItem, da seguinte forma:
ImageScalingSize é a escala da imagem final, conforme determinado pela combinação da configuração de ImageScaling da imagem e a configuração de AutoSize do contêiner.
Se AutoSize for
true(o padrão) e ToolStripItemImageScaling for SizeToFit, não ocorrerá dimensionamento de imagem e o tamanho ToolStrip será o do item maior ou um tamanho mínimo prescrito.Caso AutoSize seja
falsee ToolStripItemImageScaling seja None, nem a imagem nem o redimensionamento ToolStrip irão ocorrer.
Se o valor da ImageList propriedade for alterado para null, a ImageIndex propriedade devolve o seu valor padrão, -1. No entanto, o valor atribuído ImageIndex é mantido internamente e usado quando outro ImageList objeto é atribuído à ImageList propriedade. Se o novo ImageList valor atribuído à ImageList propriedade tiver ImageList.ImageCollection.Count um valor inferior ou igual ao valor atribuído à ImageIndex propriedade menos um (para considerar que a coleção é um índice baseado em zero), o ImageIndex valor da propriedade é ajustado para um valor inferior ao Count valor da propriedade.
Por exemplo, considere um controlo de botão que ImageList tem três imagens e cuja ImageIndex propriedade está definida para 2. Se um novo ImageList que tenha apenas duas imagens for atribuído ao botão, o ImageIndex valor muda para 1.
