Icon Clase

Definición

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

public ref class Icon sealed : MarshalByRefObject, ICloneable, IDisposable, System::Runtime::Serialization::ISerializable
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter("System.Drawing.IconConverter, System.Windows.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51")]
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))]
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.Serializable]
[System.Runtime.InteropServices.ComVisible(false)]
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
type Icon = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
[<System.ComponentModel.TypeConverter("System.Drawing.IconConverter, System.Windows.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51")>]
type Icon = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
type Icon = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
[<System.Serializable>]
type Icon = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(false)>]
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 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

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 .

Nota

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, vea System.Drawing.Common solo compatible con Windows.

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

Constructores

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(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)

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

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

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

Icon(String)

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

Icon(String, Int32, Int32)

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

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.

Propiedades

Handle

Obtiene el identificador de Windows para este Icon. Ésta no es una copia del identificador; no la libere.

Height

Obtiene el alto de este Icon.

Size

Obtiene el tamaño de este Icon.

Width

Obtiene el ancho de este Icon.

Métodos

Clone()

Clona Icon, y así crea una imagen duplicada.

CreateObjRef(Type)

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

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos utilizados por este Icon.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
ExtractAssociatedIcon(String)

Devuelve una representación de icono de una imagen que está incluida en el archivo especificado.

ExtractIcon(String, Int32, Boolean)

Extrae un icono especificado de la clase especificada filePath.

ExtractIcon(String, Int32, Int32)

Extrae un icono especificado de la clase especificada filePath.

Finalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados.

FromHandle(IntPtr)

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

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetLifetimeService()
Obsoletos.

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()
Obsoletos.

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 Object actual.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.

(Heredado de MarshalByRefObject)
Save(Stream)

Guarda este Icon en el objeto de resultados Stream especificado.

ToBitmap()

Convierte este objeto Icon en un Bitmap GDI+.

ToString()

Obtiene una cadena legible que describe Icon.

Implementaciones de interfaz explícitas

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

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

Se aplica a

Consulte también