Label.ImageList Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta l'oggetto ImageList che contiene le immagini da visualizzare nel controllo Label.

public:
 property System::Windows::Forms::ImageList ^ ImageList { System::Windows::Forms::ImageList ^ get(); void set(System::Windows::Forms::ImageList ^ value); };

public System.Windows.Forms.ImageList? ImageList { get; set; }

member this.ImageList : System.Windows.Forms.ImageList with get, set

Public Property ImageList As ImageList

Valore della proprietà

ImageList

Oggetto ImageList in cui è memorizzato l'insieme degli oggetti Image. Il valore predefinito è null.

Esempio

Nell'esempio di codice seguente viene illustrato come creare un Label controllo con un bordo tridimensionale e un'immagine visualizzata usando le ImageList proprietà e ImageIndex . Il controllo ha anche una didascalia con un carattere mnemonic specificato. Il codice di esempio usa le PreferredHeight proprietà e PreferredWidth per ridimensionare correttamente il Label controllo nel modulo in cui viene visualizzato. Questo esempio richiede che sia ImageList stato creato e denominato imageList1 e che abbia caricato due immagini. L'esempio richiede inoltre che il codice si trova all'interno di un modulo con lo System.Drawing spazio dei nomi aggiunto al codice.

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

Commenti

Le ImageIndex proprietà e ImageList non possono essere usate contemporaneamente alla Image proprietà. Quando la proprietà e ImageList le ImageIndex proprietà vengono usate per visualizzare un'immagine, la Image proprietà è impostata su null.

Nota

Il Label garbage collection non verrà raccolto se il relativo ImageList viene ancora fatto riferimento altrove. Impostare la proprietà di su null per abilitare l'efficienza ImageListLabel di Garbage Collection.

Vedi anche

• Image
• ImageAlign
• ImageIndex
• ImageList