Icon Clase

Definición

Representa un icono de Windows, que es una imagen de mapa de bits pequeña que se usa para representar un objeto. Los iconos se pueden considerar como mapas de bits transparentes, aunque su tamaño viene determinado por el sistema.

public ref class Icon sealed : MarshalByRefObject, ICloneable, IDisposable, System::Runtime::Serialization::ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))]
[System.Serializable]
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Serializable>]
type Icon = class
    inherit MarshalByRefObject
    interface ISerializable
    interface ICloneable
    interface IDisposable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
[<System.Serializable>]
type Icon = class
    inherit MarshalByRefObject
    interface ISerializable
    interface ICloneable
    interface IDisposable
Public NotInheritable Class Icon
Inherits MarshalByRefObject
Implements ICloneable, IDisposable, ISerializable
Herencia
Atributos
Implementaciones

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

Puede construir Icon objetos a partir de archivos, secuencias o recursos incrustados. Para obtener una lista de constructores, vea Icon. También puede convertir un objeto Icon en un mapa de bits mediante el ToBitmap método .

Note

En .NET 6 y versiones posteriores, el paquete System.Drawing.Common, que incluye este tipo, solo se admite en sistemas operativos Windows. El uso de este tipo en aplicaciones multiplataforma provoca advertencias en tiempo de compilación y excepciones en tiempo de ejecución. Para obtener más información, consulte System.Drawing.Common only supported on Windows (Solo se admite System.Drawing.Common en Windows).

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

Constructores

Nombre Description
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(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, 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(Stream, Size)

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

Icon(Stream)

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

Icon(String, Int32, Int32)

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

Icon(String, Size)

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

Icon(String)

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

Icon(Type, String)

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

Propiedades

Nombre Description
Handle

Obtiene el identificador de Windows para esta Icon. Esto no es una copia del identificador; no lo libere.

Height

Obtiene el alto de este Iconobjeto .

Size

Obtiene el tamaño de este Iconobjeto .

Width

Obtiene el ancho de este Iconobjeto .

Métodos

Nombre Description
Clone()

Clona , Iconcreando una imagen duplicada.

CreateObjRef(Type)

Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos usados por este Icon.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
ExtractAssociatedIcon(String)

Devuelve una representación de icono de una imagen contenida en el archivo especificado.

Finalize()

Permite a un objeto intentar liberar recursos y realizar otras operaciones de limpieza antes de que la recolección de elementos no utilizados la recupere.

FromHandle(IntPtr)

Crea un Icon de GDI+ a partir del identificador de Windows especificado a un icono (HICON).

GetHashCode()

Actúa como la función hash predeterminada.

(Heredado de Object)
GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto actual MarshalByRefObject .

(Heredado de MarshalByRefObject)
Save(Stream)

Guarda esto Icon en la salida Streamespecificada.

ToBitmap()

Convierte esto Icon en un GDI+ Bitmap.

ToString()

Obtiene una cadena legible que describe .Icon

Implementaciones de interfaz explícitas

Nombre Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Rellena con SerializationInfo los datos necesarios para serializar el objeto de destino.

Se aplica a

Consulte también