Icon Constructores

Definición

Espacio de nombres:: System.Drawing

Ensamblado:: System.Drawing.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Inicializa una nueva instancia de la clase Icon.

Sobrecargas

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

Icon(Stream)

Inicializa una nueva instancia de la Icon clase 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 desde el que se va a cargar .Icon

Excepciones

ArgumentException

El stream parámetro es null.

Comentarios

Un recurso de icono puede contener varias imágenes de icono. Un archivo de icono puede contener imágenes de 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 Icon clase 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 desde el Icon que se va a cargar.

Comentarios

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 Icon clase e intenta encontrar una versión del icono que coincida 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

desde Icon el que se va a cargar el icono de tamaño nuevo.

size: Size

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

Excepciones

ArgumentException

El original parámetro es null.

Comentarios

Si no se encuentra una versión que coincida 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 Icon clase del tamaño especificado a partir de la secuencia especificada.

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

es streamnull o no contiene datos de imagen.

Se aplica a

Icon(String, Size)

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

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 al archivo que contiene los datos del icono.

size: Size

Tamaño deseado del icono.

Excepciones

ArgumentException

es fileNamenull 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 Icon clase 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 especificado type.

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 de Windows y controle el evento /> del formulario 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 a Icon 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 tipo de Control 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 Icon clase e intenta encontrar una versión del icono que coincida 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 del que se va a cargar el tamaño diferente.

width: Int32

Ancho del nuevo icono.

height: Int32

Alto del nuevo icono.

Excepciones

ArgumentException

El original parámetro es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el ToBitmap método . 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 y pase 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

Se aplica a

Icon(Stream, Int32, Int32)

Inicializa una nueva instancia de la Icon clase a partir del flujo de datos especificado y con el ancho y 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 desde el que se va a cargar el icono.

width: Int32

Ancho, en píxeles, del icono.

height: Int32

Alto, en píxeles, del icono.

Excepciones

ArgumentException

El stream parámetro es null.

Se aplica a

Icon(String, Int32, Int32)

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

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 al archivo que contiene los Icon datos.

width: Int32

Ancho deseado de Icon.

height: Int32

Alto deseado de Icon.

Excepciones

ArgumentException

es fileNamenull o no contiene datos de imagen.

Comentarios

Si el archivo especificado no contiene una imagen que coincida con el alto y el 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

Comentarios

¿Le ha resultado útil esta página?