ImageList.ImageSize ImageList.ImageSize ImageList.ImageSize ImageList.ImageSize Property

Definición

Obtiene o establece el tamaño de las imágenes de la lista de imágenes.Gets or sets the size of the images in the image list.

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

Valor de propiedad

Size que define el alto y ancho, en píxeles, de las imágenes de la lista.The Size that defines the height and width, in pixels, of the images in the list. El tamaño predeterminado es 16 por 16.The default size is 16 by 16. El tamaño máximo es 256 por 256.The maximum size is 256 by 256.

Excepciones

El valor asignado es igual a IsEmpty.The value assigned is equal to IsEmpty.

O bien-or- El valor del alto o del ancho es menor o igual que cero.The value of the height or width is less than or equal to 0.

O bien-or- El valor del alto o del ancho es mayor que 256.The value of the height or width is greater than 256.

El nuevo tamaño tiene una dimensión menor que 0 o mayor que 256.The new size has a dimension less than 0 or greater than 256.

Ejemplos

En el ejemplo de código siguiente se muestra ImageListcómo construir, agregar imágenes Images a la propiedad, ImageSize establecer la propiedad y utilizar Draw el método.The following code example demonstrates constructing an ImageList, adding images to the Images property, setting the ImageSize property, and using the Draw method. Para ejecutar este ejemplo, colóquelo en un formulario que contenga un botón Button1denominado.To run this example, place it in a form containing a button named Button1. En el ejemplo se supone que FeatherTexture.bmp existe Gone Fishing.bmp y en\c:\Windows.The example assumes the existence of FeatherTexture.bmp and Gone Fishing.bmp at c:\Windows\. Cambie el ejemplo en consecuencia si los mapas de bits no existen en el sistema o no existen en otra ubicación.Change the example accordingly if the bitmaps do not exist on your system, or exist at another location.

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

Comentarios

El establecimiento ImageSize de la propiedad antes de agregar imágenes a la colección de imágenes hace que se cambie el tamaño de las imágenes al tamaño de imagen especificado.Setting the ImageSize property prior to adding images to the image collection causes the images to be resized to the image size specified.

Cuando se establece la ImageSize propiedad en un valor nuevo, se Handle vuelve a crear el de la lista de imágenes.When you set the ImageSize property to a new value, the Handle for the image list is recreated.

Dado que establecer ImageSize la propiedad hace que se vuelva a crear el identificador, debe establecer ImageSize antes de establecer la Images propiedad.Because setting the ImageSize property causes the handle to be recreated, you should set ImageSize prior to setting the Images property. Cuando se ha creado el ImageList identificador de, el ColorDepth establecimiento de las ImageSize propiedades o en el código, después Images de establecer la propiedad, hará que se elimine la Images colección de imágenes establecida para la propiedad.When the handle for the ImageList has been created, setting the ColorDepth or ImageSize properties in code, after setting the Images property, will cause the collection of images set for the Images property to be deleted.

Se aplica a