Icon Constructores

Definición

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)

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

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.

Se aplica a

Icon(String)

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.

Se aplica a

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.

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

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.

Se aplica a

Icon(Stream, Size)

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

stream es null o no contiene datos de imagen.

Se aplica a

Icon(String, Size)

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

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.

Se aplica a

Icon(Type, String)

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

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.

Se aplica a

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.

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

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. Cree 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.

Se aplica a

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.

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

El parámetro stream es null.

Se aplica a

Icon(String, Int32, Int32)

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

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.

Se aplica a