ImageList.ImageSize Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá nebo nastaví velikost obrázků v seznamu obrázků.

public:
 property System::Drawing::Size ImageSize { System::Drawing::Size get(); void set(System::Drawing::Size value); };

public System.Drawing.Size ImageSize { get; set; }

member this.ImageSize : System.Drawing.Size with get, set

Public Property ImageSize As Size

Hodnota vlastnosti

Size

Ten Size definuje výšku a šířku obrázků v pixelech v seznamu. Výchozí velikost je 16 až 16. Maximální velikost je 256 o 256.

Výjimky

ArgumentException

Přiřazená hodnota je rovna IsEmpty.

-nebo- Hodnota výšky nebo šířky je menší nebo rovna 0.

-nebo- Hodnota výšky nebo šířky je větší než 256.

ArgumentOutOfRangeException

Nová velikost má rozměr menší než 0 nebo větší než 256.

Příklady

Následující příklad kódu ukazuje vytvoření ImageList, přidání obrázků do Images vlastnosti, nastavení ImageSize vlastnosti a použití Draw metody. Pokud chcete tento příklad spustit, umístěte ho do formuláře obsahujícího tlačítko s názvem Button1. Příklad předpokládá existenci FeatherTexture.bmp a Gone Fishing.bmp v c:\Windows\. Změňte příklad odpovídajícím způsobem, pokud rastrové obrázky neexistují ve vašem systému nebo existují v jiném umístění.

internal:
   System::Windows::Forms::ImageList^ ImageList1;

private:

   // Create an ImageList Object, populate it, and display
   // the images it contains.
   void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      
      // Construct the ImageList.
      ImageList1 = gcnew ImageList;
      
      // Set the ImageSize property to a larger size 
      // (the default is 16 x 16).
      ImageList1->ImageSize = System::Drawing::Size( 112, 112 );
      
      // Add two images to the list.
      ImageList1->Images->Add( Image::FromFile( "c:\\windows\\FeatherTexture.bmp" ) );
      ImageList1->Images->Add( Image::FromFile( "C:\\windows\\Gone Fishing.bmp" ) );
      
      // Get a Graphics object from the form's handle.
      Graphics^ theGraphics = Graphics::FromHwnd( this->Handle );
      
      // Loop through the images in the list, drawing each image.
      for ( int count = 0; count < ImageList1->Images->Count; count++ )
      {
         ImageList1->Draw( theGraphics, Point(85,85), count );
         
         // Call Application.DoEvents to force a repaint of the form.
         Application::DoEvents();
         
         // Call the Sleep method to allow the user to see the image.
         System::Threading::Thread::Sleep( 1000 );

      }
   }

internal System.Windows.Forms.ImageList ImageList1;

// Create an ImageList Object, populate it, and display
// the images it contains.
private void Button1_Click(System.Object sender, 
    System.EventArgs e)
{

    // Construct the ImageList.
    ImageList1 = new ImageList();

    // Set the ImageSize property to a larger size 
    // (the default is 16 x 16).
    ImageList1.ImageSize = new Size(112, 112);

    // Add two images to the list.
    ImageList1.Images.Add(
        Image.FromFile("c:\\windows\\FeatherTexture.bmp"));
    ImageList1.Images.Add(
        Image.FromFile("C:\\windows\\Gone Fishing.bmp"));

    // Get a Graphics object from the form's handle.
    Graphics theGraphics = Graphics.FromHwnd(this.Handle);

    // Loop through the images in the list, drawing each image.
    for(int count = 0; count < ImageList1.Images.Count; count++)
    {
        ImageList1.Draw(theGraphics, new Point(85, 85), count);

        // Call Application.DoEvents to force a repaint of the form.
        Application.DoEvents();

        // Call the Sleep method to allow the user to see the image.
        System.Threading.Thread.Sleep(1000);
    }
}

Friend WithEvents ImageList1 As System.Windows.Forms.ImageList

' Create an ImageList Object, populate it, and display
' the images it contains.
Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click

    ' Construct the ImageList.
    ImageList1 = New ImageList

    ' Set the ImageSize property to a larger size 
    ' (the default is 16 x 16).
    ImageList1.ImageSize = New Size(112, 112)

    ' Add two images to the list.
    ImageList1.Images.Add(Image.FromFile _
        ("c:\windows\FeatherTexture.bmp"))
    ImageList1.Images.Add _
        (Image.FromFile("C:\windows\Gone Fishing.bmp"))

    Dim count As System.Int32

    ' Get a Graphics object from the form's handle.
    Dim theGraphics As Graphics = Graphics.FromHwnd(Me.Handle)

    ' Loop through the images in the list, drawing each image.
    For count = 0 To ImageList1.Images.Count - 1
        ImageList1.Draw(theGraphics, New Point(85, 85), count)

        ' Call Application.DoEvents to force a repaint of the form.
        Application.DoEvents()

        ' Call the Sleep method to allow the user to see the image.
        System.Threading.Thread.Sleep(1000)
    Next
End Sub

Poznámky

ImageSize Nastavení vlastnosti před přidáním obrázků do kolekce obrázků způsobí, že se obrázky změní na zadanou velikost obrázku.

Když vlastnost nastavíte ImageSize na novou hodnotu, Handle vytvoří se seznam obrázků znovu.

Vzhledem k tomu, že nastavení ImageSize vlastnosti způsobí opětovné vytvoření popisovače, měli byste nastavit ImageSize před nastavením Images vlastnosti. Při vytvoření popisovače ImageList , nastavení ColorDepth nebo ImageSize vlastnosti v kódu po nastavení Images vlastnosti způsobí odstranění kolekce obrázků nastavená pro Images vlastnost.