Icon Clase

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Source:

Icon.cs

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

[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>]
type Icon = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable

Public NotInheritable Class Icon
Inherits MarshalByRefObject
Implements ICloneable, IDisposable, ISerializable

Herencia

Object

MarshalByRefObject

Icon

Atributos

TypeConverterAttribute SerializableAttribute

Implementaciones

ICloneable IDisposable ISerializable

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

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, consulte System.Drawing.Common only supported on Windows(System.Drawing.Common only supported on 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()	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 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.

Consulte también

• Trabajar con imágenes, mapas de bits, iconos y metarchivos