Icon Constructores

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Inicializa una nueva instancia de la clase Icon.

Sobrecargas

Icon(Stream)	Inicializa una nueva instancia de la clase Icon a partir del flujo de datos especificado.
Icon(String)	Inicializa una nueva instancia de la clase Icon a partir del nombre de archivo especificado.
Icon(Icon, Size)	Inicializa una nueva instancia de la clase Icon e intenta buscar una versión del icono que se corresponda con el tamaño solicitado.
Icon(Stream, Size)	Inicializa una nueva instancia de la clase Icon del tamaño especificado a partir de la secuencia que se indique.
Icon(String, Size)	Inicializa una nueva instancia de la clase Icon del tamaño especificado a partir del archivo que se indique.
Icon(Type, String)	Inicializa una nueva instancia de la clase Icon a partir de un recurso del ensamblado especificado.
Icon(Icon, Int32, Int32)	Inicializa una nueva instancia de la clase Icon e intenta buscar una versión del icono que se corresponda con el tamaño solicitado.
Icon(Stream, Int32, Int32)	Inicializa una nueva instancia de la clase Icon a partir del flujo de datos especificado y con el ancho y el alto especificados.
Icon(String, Int32, Int32)	Inicializa una nueva instancia de la clase Icon con el ancho y el alto especificados del archivo indicado.

Icon(Stream)

Source:

Icon.cs

Inicializa una nueva instancia de la clase Icon a partir del flujo de datos especificado.

public:
 Icon(System::IO::Stream ^ stream);

public Icon (System.IO.Stream stream);

new System.Drawing.Icon : System.IO.Stream -> System.Drawing.Icon

Public Sub New (stream As Stream)

Parámetros

stream

Stream

Flujo de datos a partir del cual se va a cargar Icon.

Excepciones

ArgumentException

El parámetro stream es null.

Comentarios

Un recurso de icono puede contener varias imágenes de icono. Un archivo de icono puede contener imágenes en varios tamaños y profundidades de color. La imagen que se usa en una aplicación depende del sistema operativo y la configuración. En la lista siguiente se detallan los tamaños típicos de un icono:

• 16 píxeles x 16 píxeles

• 32 píxeles x 32 píxeles

• 48 píxeles x 48 píxeles

Este constructor devuelve la imagen más pequeña contenida en la secuencia especificada.

Icon(String)

Source:

Icon.cs

Inicializa una nueva instancia de la clase Icon a partir del nombre de archivo especificado.

public:
 Icon(System::String ^ fileName);

public Icon (string fileName);

new System.Drawing.Icon : string -> System.Drawing.Icon

Public Sub New (fileName As String)

Parámetros

fileName

String

Archivo a partir del cual se va a cargar Icon.

Comentarios

Un recurso de icono puede contener varias imágenes de icono. Un archivo de icono puede contener imágenes en varios tamaños y profundidades de color. La imagen que se usa en una aplicación depende del sistema operativo y la configuración. En la lista siguiente se detallan los tamaños típicos de un icono:

• 16 píxeles x 16 píxeles

• 32 píxeles x 32 píxeles

• 48 píxeles x 48 píxeles

Este constructor devuelve la imagen más pequeña contenida en el archivo especificado.

Icon(Icon, Size)

Source:

Icon.cs

Inicializa una nueva instancia de la clase Icon e intenta buscar una versión del icono que se corresponda con el tamaño solicitado.

public:
 Icon(System::Drawing::Icon ^ original, System::Drawing::Size size);

public Icon (System.Drawing.Icon original, System.Drawing.Size size);

new System.Drawing.Icon : System.Drawing.Icon * System.Drawing.Size -> System.Drawing.Icon

Public Sub New (original As Icon, size As Size)

Parámetros

original

Icon

Icon desde el que se va a cargar el icono al que se acaba de modificar el tamaño.

size

Size

Estructura Size que especifica el ancho y el alto del nuevo Icon.

Excepciones

ArgumentException

El parámetro original es null.

Comentarios

Si no se encuentra una versión que coincide exactamente con el tamaño, se usa la coincidencia más cercana. Si el original parámetro es un Icon que tiene un solo tamaño, este método solo crea un icono duplicado. Use las funcionalidades de extensión del DrawImage método para cambiar el tamaño del icono.

Icon(Stream, Size)

Source:

Icon.cs

Inicializa una nueva instancia de la clase Icon del tamaño especificado a partir de la secuencia que se indique.

public:
 Icon(System::IO::Stream ^ stream, System::Drawing::Size size);

public Icon (System.IO.Stream stream, System.Drawing.Size size);

new System.Drawing.Icon : System.IO.Stream * System.Drawing.Size -> System.Drawing.Icon

Public Sub New (stream As Stream, size As Size)

Parámetros

stream

Stream

Secuencia que contiene los datos del icono.

size

Size

Tamaño deseado del icono.

Excepciones

ArgumentException

stream es null o no contiene datos de imagen.

Icon(String, Size)

Source:

Icon.cs

Inicializa una nueva instancia de la clase Icon del tamaño especificado a partir del archivo que se indique.

public:
 Icon(System::String ^ fileName, System::Drawing::Size size);

public Icon (string fileName, System.Drawing.Size size);

new System.Drawing.Icon : string * System.Drawing.Size -> System.Drawing.Icon

Public Sub New (fileName As String, size As Size)

Parámetros

fileName

String

Nombre y ruta de acceso del archivo que contiene los datos del icono.

size

Size

Tamaño deseado del icono.

Excepciones

ArgumentException

string es null o no contiene datos de imagen.

Comentarios

Si el archivo especificado no contiene una imagen que coincida con el tamaño deseado, se devuelve el icono que tiene el tamaño más cercano.

fileName debe incluir la ruta de acceso completa si no está en el directorio de la aplicación actual.

Icon(Type, String)

Source:

Icon.cs

Inicializa una nueva instancia de la clase Icon a partir de un recurso del ensamblado especificado.

public:
 Icon(Type ^ type, System::String ^ resource);

public Icon (Type type, string resource);

new System.Drawing.Icon : Type * string -> System.Drawing.Icon

Public Sub New (type As Type, resource As String)

Parámetros

type

Type

Type que especifica el ensamblado en el que se va a buscar el recurso.

resource

String

Nombre del recurso que se va a cargar.

Excepciones

ArgumentException

No se encuentra un icono especificado por resource en el ensamblado que contiene el type especificado.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el Icon constructor . Para ejecutar este ejemplo, pegue el código en un formulario Windows Forms y controle el evento del Paint formulario. Llame al ConstructAnIconFromAType método desde el Paint controlador de eventos y pase e como EventArgs.

private void ConstructAnIconFromAType(PaintEventArgs e)
{

    Icon icon1 = new Icon(typeof(Control), "Error.ico");
    e.Graphics.DrawIcon(icon1, new Rectangle(10, 10, 50, 50));
}

Private Sub ConstructAnIconFromAType(ByVal e As PaintEventArgs)

    Dim icon1 As New Icon(GetType(Control), "Error.ico")
    e.Graphics.DrawIcon(icon1, New Rectangle(10, 10, 50, 50))

End Sub

Comentarios

Este constructor crea un Icon a partir de un recurso con el nombre especificado por el resource parámetro en el ensamblado que contiene el tipo especificado por el type parámetro .

Este constructor combina el espacio de nombres del tipo especificado junto con el nombre de cadena del recurso y busca una coincidencia en el manifiesto del ensamblado. Por ejemplo, puede pasar el Control tipo y Error.ico a este constructor, y busca un recurso denominado System.Windows.Forms.Error.ico.

Icon(Icon, Int32, Int32)

Source:

Icon.cs

Inicializa una nueva instancia de la clase Icon e intenta buscar una versión del icono que se corresponda con el tamaño solicitado.

public:
 Icon(System::Drawing::Icon ^ original, int width, int height);

public Icon (System.Drawing.Icon original, int width, int height);

new System.Drawing.Icon : System.Drawing.Icon * int * int -> System.Drawing.Icon

Public Sub New (original As Icon, width As Integer, height As Integer)

Parámetros

original

Icon

Icono a partir del cual se cargará el tamaño distinto.

width

Int32

Ancho del nuevo icono.

height

Int32

Alto del nuevo icono.

Excepciones

ArgumentException

El parámetro original es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método ToBitmap. Este ejemplo está diseñado para usarse con Windows Forms. Create un formulario y pegue el código siguiente en él. Llame al IconToBitmap método en el controlador de eventos del Paint formulario, pasando e como PaintEventArgs.

private:
   void IconToBitmap( PaintEventArgs^ e )
   {
      // Construct an Icon.
      System::Drawing::Icon^ icon1 = gcnew System::Drawing::Icon( SystemIcons::Exclamation,40,40 );

      // Call ToBitmap to convert it.
      Bitmap^ bmp = icon1->ToBitmap();

      // Draw the bitmap.
      e->Graphics->DrawImage( bmp, Point(30,30) );
   }

private void IconToBitmap(PaintEventArgs e)
{
    // Construct an Icon.
    Icon icon1 = new Icon(SystemIcons.Exclamation, 40, 40);

    // Call ToBitmap to convert it.
    Bitmap bmp = icon1.ToBitmap();

    // Draw the bitmap.
    e.Graphics.DrawImage(bmp, new Point(30, 30));
}

Private Sub IconToBitmap(ByVal e As PaintEventArgs)

    ' Construct an Icon.
    Dim icon1 As New Icon(SystemIcons.Exclamation, 40, 40)

    ' Call ToBitmap to convert it.
    Dim bmp As Bitmap = icon1.ToBitmap()

    ' Draw the bitmap.
    e.Graphics.DrawImage(bmp, New Point(30, 30))
End Sub

Comentarios

Si no se encuentra una versión que coincide exactamente con el tamaño, se usa la coincidencia más cercana. Si el original parámetro es un Icon que tiene un solo tamaño, este método solo crea un icono duplicado. Use las funcionalidades de extensión del DrawImage método para cambiar el tamaño del icono.

Icon(Stream, Int32, Int32)

Source:

Icon.cs

Inicializa una nueva instancia de la clase Icon a partir del flujo de datos especificado y con el ancho y el alto especificados.

public:
 Icon(System::IO::Stream ^ stream, int width, int height);

public Icon (System.IO.Stream stream, int width, int height);

new System.Drawing.Icon : System.IO.Stream * int * int -> System.Drawing.Icon

Public Sub New (stream As Stream, width As Integer, height As Integer)

Parámetros

stream

Stream

Flujo de datos a partir del cual se va a cargar el icono.

width

Int32

Ancho, expresado en píxeles, del icono.

height

Int32

Alto, expresado en píxeles, del icono.

Excepciones

ArgumentException

El parámetro stream es null.

Icon(String, Int32, Int32)

Source:

Icon.cs

Inicializa una nueva instancia de la clase Icon con el ancho y el alto especificados del archivo indicado.

public:
 Icon(System::String ^ fileName, int width, int height);

public Icon (string fileName, int width, int height);

new System.Drawing.Icon : string * int * int -> System.Drawing.Icon

Public Sub New (fileName As String, width As Integer, height As Integer)

Parámetros

fileName

String

Nombre y ruta de acceso del archivo que contiene los datos de Icon.

width

Int32

Ancho deseado del objeto Icon.

height

Int32

Alto deseado del objeto Icon.

Excepciones

ArgumentException

string es null o no contiene datos de imagen.

Comentarios

Si el archivo especificado no contiene una imagen que coincida con el alto y ancho deseados, se devuelve el icono que tiene el tamaño más cercano.

fileName debe incluir la ruta de acceso completa si no está en el directorio de la aplicación actual.