Label.ImageIndex Tulajdonság

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

Label.cs

Lekéri vagy beállítja a képen megjelenített kép indexértékét Label.

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

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int ImageIndex { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))>]
member this.ImageIndex : int with get, set

Public Property ImageIndex As Integer

Tulajdonság értéke

Int32

Nulla alapú index, amely a vezérlő (a ImageList tulajdonsághoz rendelt) pozícióját ImageList jelöli, ahol a rendszerkép található. Az alapértelmezett érték -1.

Attribútumok

TypeConverterAttribute

Kivételek

ArgumentOutOfRangeException

value kisebb, mint -1.

Példák

Az alábbi példakód bemutatja, hogyan hozhat létre Label háromdimenziós szegélyt és a tulajdonságokat használó ImageListImageIndex képet tartalmazó vezérlőt. A vezérlőelem felirattal is rendelkezik, amelyen meg van adva egy mnemonikus karakter. A példakód a PreferredHeight vezérlő megfelelő méretének PreferredWidth és Label tulajdonságainak használatával méretezhető azon az űrlapon, amelyen megjelenik. Ehhez a példához létre kell hozni és el kell nevezni egy ImageList imageList1 nevű fájlt, és két képet kell betöltenie. A példához az is szükséges, hogy a kód egy olyan űrlapon belül legyen, amelyben a névtér hozzá van adva a System.Drawing kódhoz.

public:
   void CreateMyLabel()
   {
      // Create an instance of a Label.
      Label^ label1 = gcnew Label;
      
      // Set the border to a three-dimensional border.
      label1->BorderStyle = System::Windows::Forms::BorderStyle::Fixed3D;
      // Set the ImageList to use for displaying an image.
      label1->ImageList = imageList1;
      // Use the second image in imageList1.
      label1->ImageIndex = 1;
      // Align the image to the top left corner.
      label1->ImageAlign = ContentAlignment::TopLeft;
      
      // Specify that the text can display mnemonic characters.
      label1->UseMnemonic = true;
      // Set the text of the control and specify a mnemonic character.
      label1->Text = "First &Name:";
      
      /* Set the size of the control based on the PreferredHeight and PreferredWidth values. */
      label1->Size = System::Drawing::Size( label1->PreferredWidth, label1->PreferredHeight );
      
      //...Code to add the control to the form...
   }

public void CreateMyLabel()
{
   // Create an instance of a Label.
   Label label1 = new Label();

   // Set the border to a three-dimensional border.
   label1.BorderStyle = System.Windows.Forms.BorderStyle.Fixed3D;
   // Set the ImageList to use for displaying an image.
   label1.ImageList = imageList1;
   // Use the second image in imageList1.
   label1.ImageIndex = 1;
   // Align the image to the top left corner.
   label1.ImageAlign = ContentAlignment.TopLeft;

   // Specify that the text can display mnemonic characters.
   label1.UseMnemonic = true;
   // Set the text of the control and specify a mnemonic character.
   label1.Text = "First &Name:";
   
   /* Set the size of the control based on the PreferredHeight and PreferredWidth values. */
   label1.Size = new Size (label1.PreferredWidth, label1.PreferredHeight);

   //...Code to add the control to the form...
}

Public Sub CreateMyLabel()
    ' Create an instance of a Label.
    Dim label1 As New Label()
       
    ' Set the border to a three-dimensional border.
    label1.BorderStyle = System.Windows.Forms.BorderStyle.Fixed3D
    ' Set the ImageList to use for displaying an image.
    label1.ImageList = imageList1
    ' Use the second image in imageList1.
    label1.ImageIndex = 1
    ' Align the image to the top left corner.
    label1.ImageAlign = ContentAlignment.TopLeft
     
    ' Specify that the text can display mnemonic characters.
    label1.UseMnemonic = True
    ' Set the text of the control and specify a mnemonic character.
    label1.Text = "First &Name:"
       
    ' Set the size of the control based on the PreferredHeight and PreferredWidth values. 
    label1.Size = New Size(label1.PreferredWidth, label1.PreferredHeight)

    '...Code to add the control to the form...
End Sub

Megjegyzések

A ImageIndex tulajdonságok és a ImageList tulajdonságok nem használhatók a tulajdonsággal Image egy időben. Amikor a ImageIndex tulajdonságot és ImageList a tulajdonságokat használja egy kép megjelenítéséhez, a Image tulajdonság automatikusan a következőre nullvan állítva: .

ImageKey és ImageIndex kölcsönösen kizárják egymást, ami azt jelenti, hogy ha az egyik be van állítva, a másik érvénytelen értékre van állítva, és figyelmen kívül hagyja. Ha beállítja a ImageKey tulajdonságot, a ImageIndex tulajdonság automatikusan -1 értékre van állítva. Másik lehetőségként, ha beállítja a ImageIndex tulajdonságot, a ImageKey rendszer automatikusan üres sztringre ("") állítja be a tulajdonságot.

Ha a ImageList tulajdonság értéke megváltozik null, a tulajdonság az ImageIndex alapértelmezett értékét adja vissza ( -1). A hozzárendelt ImageIndex érték azonban belsőleg megmarad, és akkor lesz felhasználva, ha egy másik ImageList objektum van hozzárendelve a ImageList tulajdonsághoz. Ha a tulajdonsághoz ImageList rendelt új ImageList tulajdonság értéke kisebb vagy egyenlő a tulajdonsághoz ImageList.ImageCollection.Count rendelt értéknél mínusz egynél (figyelembe véve, hogy a gyűjtemény nulla alapú index), a ImageIndex tulajdonság értéke a tulajdonság értékénél ImageIndex egy kisebbre van módosítva.Count Vegyük például azt a gombvezérlőt, amelynek ImageList három képe van, és amelynek ImageIndex tulajdonsága 2. Ha a ImageList gombhoz csak két kép van rendelve, az ImageIndex érték 1 lesz.

Lásd még

• Image
• ImageAlign
• ImageList