ToolStripItem.ImageKey Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta la funzione di accesso alla chiave per l'immagine contenuta in ImageList visualizzata su ToolStripItem.

public:
 property System::String ^ ImageKey { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Browsable(false)]
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageKeyConverter))]
[System.Windows.Forms.RelatedImageList("Owner.ImageList")]
public string ImageKey { get; set; }

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

Public Property ImageKey As String

Valore della proprietà

String

Stringa che rappresenta la chiave dell'immagine.

Attributi

BrowsableAttribute TypeConverterAttribute RelatedImageListAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come impostare la ImageKey proprietà. Questo esempio di codice fa parte di un esempio più grande fornito per la ToolStripItem classe.

// This utility method creates a RolloverItem 
// and adds it to a ToolStrip control.
private RolloverItem CreateRolloverItem(
    ToolStrip owningToolStrip,
    string txt,
    Font f,
    string imgKey,
    TextImageRelation tir,
    string backImgKey)
{
    RolloverItem item = new RolloverItem();

    item.Alignment = ToolStripItemAlignment.Left;
    item.AllowDrop = false;
    item.AutoSize = true;

    item.BackgroundImage = owningToolStrip.ImageList.Images[backImgKey];
    item.BackgroundImageLayout = ImageLayout.Center;
    item.DisplayStyle = ToolStripItemDisplayStyle.ImageAndText;
    item.DoubleClickEnabled = true;
    item.Enabled = true;
    item.Font = f;

    // These assignments are equivalent. Each assigns an
    // image from the owning toolstrip's image list.
    item.ImageKey = imgKey;
    //item.Image = owningToolStrip.ImageList.Images[infoIconKey];
    //item.ImageIndex = owningToolStrip.ImageList.Images.IndexOfKey(infoIconKey);
    item.ImageScaling = ToolStripItemImageScaling.None;

    item.Owner = owningToolStrip;
    item.Padding = new Padding(2);
    item.Text = txt;
    item.TextAlign = ContentAlignment.MiddleLeft;
    item.TextDirection = ToolStripTextDirection.Horizontal;
    item.TextImageRelation = tir;

    return item;
}

' This utility method creates a RolloverItem 
' and adds it to a ToolStrip control.
 Private Function CreateRolloverItem( _
 ByVal owningToolStrip As ToolStrip, _
 ByVal txt As String, _
 ByVal f As Font, _
 ByVal imgKey As String, _
 ByVal tir As TextImageRelation, _
 ByVal backImgKey As String) As RolloverItem

     Dim item As New RolloverItem()

     item.Alignment = ToolStripItemAlignment.Left
     item.AllowDrop = False
     item.AutoSize = True

     item.BackgroundImage = owningToolStrip.ImageList.Images(backImgKey)
     item.BackgroundImageLayout = ImageLayout.Center
     item.DisplayStyle = ToolStripItemDisplayStyle.ImageAndText
     item.DoubleClickEnabled = True
     item.Enabled = True
     item.Font = f

     ' These assignments are equivalent. Each assigns an
     ' image from the owning toolstrip's image list.
     item.ImageKey = imgKey
     'item.Image = owningToolStrip.ImageList.Images[infoIconKey];
     'item.ImageIndex = owningToolStrip.ImageList.Images.IndexOfKey(infoIconKey);
     item.ImageScaling = ToolStripItemImageScaling.None

     item.Owner = owningToolStrip
     item.Padding = New Padding(2)
     item.Text = txt
     item.TextAlign = ContentAlignment.MiddleLeft
     item.TextDirection = ToolStripTextDirection.Horizontal
     item.TextImageRelation = tir

     Return item
 End Function

Commenti

ImageKey e si escludono ImageIndex a vicenda, ovvero se è impostato, l'altro è impostato su un valore non valido e ignorato. Se si imposta la proprietà, la ImageKeyImageIndex proprietà viene impostata automaticamente su -1. In alternativa, se si imposta la proprietà, l'oggetto ImageIndexImageKey viene impostato automaticamente su una stringa vuota ("").

Le Imageproprietà , ImageAlign, ImageKeyImageIndex, e ImageScaling riguardano vari aspetti della gestione delle immagini. Usare le immagini nei ToolStrip controlli impostando queste proprietà direttamente o impostando la proprietà di sola esecuzione ImageList .

Il ridimensionamento delle immagini è determinato dall'interazione delle proprietà sia in ToolStrip e ToolStripItem, come indicato di seguito:

• ImageScalingSize è la scala dell'immagine finale, come determinato dalla combinazione dell'impostazione dell'immagine ImageScaling e dell'impostazione del AutoSize contenitore.

  • Se AutoSize è (impostazione predefinita) ed ToolStripItemImageScaling è trueSizeToFit, non si verifica il ridimensionamento delle immagini e la ToolStrip dimensione è quella dell'elemento più grande o di una dimensione minima prevista.

  • Se AutoSize è e ToolStripItemImageScaling è Nonefalse , né immagine né ToolStrip ridimensionamento si verifica.