ToolStripItem.ImageKey Eigenschap

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

Waarde van eigenschap

Een tekenreeks die de sleutel van de afbeelding vertegenwoordigt.

Kenmerken

BrowsableAttribute TypeConverterAttribute RelatedImageListAttribute

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de ImageKey eigenschap instelt. Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de ToolStripItem klasse.

// 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

Opmerkingen

ImageKey en ImageIndex wederzijds uitsluiten, wat betekent dat als de ene is ingesteld, de andere wordt ingesteld op een ongeldige waarde en genegeerd. Als u de ImageKey eigenschap instelt, wordt de ImageIndex eigenschap automatisch ingesteld op -1. Als u de eigenschap instelt, wordt de ImageIndexImageKey eigenschap ook automatisch ingesteld op een lege tekenreeks ("").

De eigenschappen Image, ImageAlign, ImageIndex, ImageKeyen ImageScaling hebben betrekking op verschillende aspecten van de verwerking van afbeeldingen. Gebruik afbeeldingen in ToolStrip besturingselementen door deze eigenschappen rechtstreeks in te stellen of door de eigenschap alleen-runtime ImageList in te stellen.

Het schalen van afbeeldingen wordt als volgt bepaald door de interactie van eigenschappen in zowel ToolStrip als ToolStripItem:

• ImageScalingSize is de schaal van de uiteindelijke afbeelding, zoals bepaald door de combinatie van de ImageScaling-instelling van de afbeelding en de AutoSize-instelling van de container.

  • Als AutoSize is true (de standaardinstelling) en ToolStripItemImageScaling is SizeToFit, treedt er geen schaalaanpassing van afbeeldingen op en is de ToolStrip grootte dat van het grootste item of een voorgeschreven minimale grootte.

  • Als AutoSizefalse is en ToolStripItemImageScalingNoneis, vinden noch afbeelding noch ToolStrip schalen plaats.