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

El ejemplo de código siguiente se muestra cómo construir un ImageList, agregar imágenes a la Images propiedad, establecer el ImageSize propiedad y el uso la Draw 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 denominado Button1.To run this example, place it in a form containing a button named Button1. En el ejemplo se presupone la existencia de FeatherTexture.bmp y Gone Fishing.bmp en c:\Windows\.The example assumes the existence of FeatherTexture.bmp and Gone Fishing.bmp at c:\Windows\. Cambiar el ejemplo en consecuencia si los mapas de bits no existe en el sistema, ni 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

Establecer el ImageSize propiedad antes de agregar imágenes a la colección de imágenes hace que las imágenes que se cambie el 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.

Al establecer el ImageSize propiedad a un nuevo valor, el Handle para la imagen se vuelve a crear lista.When you set the ImageSize property to a new value, the Handle for the image list is recreated.

Dado que establecer el ImageSize propiedad hace que se vuelve a crear el controlador, debe establecer ImageSize antes de la configuración de 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 el identificador de la ImageList se ha creado, establecer el ColorDepth o ImageSize propiedades en el código después de establecer el Images propiedad, hará que la colección de imágenes establecido para el Images propiedad va a eliminar.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