Icon Icon Icon Icon Class

Definición

Representa un icono de Windows, que es una pequeña imagen de mapa de bits que se usa para representar un objeto. Represents a Windows icon, which is a small bitmap image that is used to represent an object. Los iconos se pueden considerar como mapas de bits transparentes, aunque su tamaño lo determina el sistema. Icons can be thought of as transparent bitmaps, although their size is determined by the system.

public ref class Icon sealed : MarshalByRefObject, ICloneable, IDisposable, System::Runtime::Serialization::ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))]
[System.Runtime.InteropServices.ComVisible(false)]
[Serializable]
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
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.The following code example demonstrates how to use the ToBitmap method. En este ejemplo está diseñado para usarse con Windows Forms.This example is designed to be used with Windows Forms. Crear un formulario y pegue el código siguiente en él.Create a form and paste the following code into it. Llame a la IconToBitmap método en el formulario Paint controlador de eventos, pasando e como PaintEventArgs.Call the IconToBitmap method in the form's Paint event handler, passing e as 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 de los archivos, secuencias o los recursos incrustados.You can construct Icon objects from files, streams, or embedded resources. Para obtener una lista de los constructores, vea Icon.For a list of constructors, see Icon. También puede convertir un Icon un mapa de bits mediante el uso de la ToBitmap método.You can also convert an Icon to a bitmap by using the ToBitmap method.

Un recurso de icono puede contener varias imágenes de icono.An icon resource can contain multiple icon images. Un archivo de icono puede contener imágenes en varios tamaños y profundidad de color.One icon file may contain images in several sizes and color depths. La imagen que se usa en una aplicación depende de la configuración y el sistema operativo.The image that is used in an application depends on the operating system and settings. La siguiente lista detalla los tamaños normales de un icono:The following list details the typical sizes for an icon:

  • 16 píxeles x 16 píxeles16 pixels x 16 pixels

  • 32 píxeles x 32 píxeles32 pixels x 32 pixels

  • 48 píxeles x 48 píxeles48 pixels x 48 pixels

Constructores

Icon(Icon, Int32, Int32) Icon(Icon, Int32, Int32) Icon(Icon, Int32, Int32) 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. Initializes a new instance of the Icon class and attempts to find a version of the icon that matches the requested size.

Icon(Icon, Size) Icon(Icon, Size) Icon(Icon, Size) 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. Initializes a new instance of the Icon class and attempts to find a version of the icon that matches the requested size.

Icon(Stream) Icon(Stream) Icon(Stream) Icon(Stream)

Inicializa una nueva instancia de la clase Icon a partir del flujo de datos especificado. Initializes a new instance of the Icon class from the specified data stream.

Icon(Stream, Int32, Int32) Icon(Stream, Int32, Int32) Icon(Stream, Int32, Int32) 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. Initializes a new instance of the Icon class from the specified data stream and with the specified width and height.

Icon(Stream, Size) Icon(Stream, Size) Icon(Stream, Size) Icon(Stream, Size)

Inicializa una nueva instancia de la clase Icon del tamaño especificado a partir de la secuencia que se indique. Initializes a new instance of the Icon class of the specified size from the specified stream.

Icon(String) Icon(String) Icon(String) Icon(String)

Inicializa una nueva instancia de la clase Icon a partir del nombre de archivo especificado. Initializes a new instance of the Icon class from the specified file name.

Icon(String, Int32, Int32) Icon(String, Int32, Int32) Icon(String, Int32, Int32) Icon(String, Int32, Int32)

Inicializa una nueva instancia de la clase Icon con el ancho y el alto especificados del archivo indicado. Initializes a new instance of the Icon class with the specified width and height from the specified file.

Icon(String, Size) Icon(String, Size) Icon(String, Size) Icon(String, Size)

Inicializa una nueva instancia de la clase Icon del tamaño especificado a partir del archivo que se indique. Initializes a new instance of the Icon class of the specified size from the specified file.

Icon(Type, String) Icon(Type, String) Icon(Type, String) Icon(Type, String)

Inicializa una nueva instancia de la clase Icon a partir de un recurso del ensamblado especificado. Initializes a new instance of the Icon class from a resource in the specified assembly.

Propiedades

Handle Handle Handle Handle

Obtiene el identificador de Windows para este Icon. Gets the Windows handle for this Icon. Ésta no es una copia del identificador; no la libere. This is not a copy of the handle; do not free it.

Height Height Height Height

Obtiene el alto de este Icon. Gets the height of this Icon.

Size Size Size Size

Obtiene el tamaño de este Icon. Gets the size of this Icon.

Width Width Width Width

Obtiene el ancho de este Icon. Gets the width of this Icon.

Métodos

Clone() Clone() Clone() Clone()

Clona Icon, y así crea una imagen duplicada. Clones the Icon, creating a duplicate image.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libera todos los recursos utilizados por este Icon. Releases all resources used by this Icon.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual. Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExtractAssociatedIcon(String) ExtractAssociatedIcon(String) ExtractAssociatedIcon(String) ExtractAssociatedIcon(String)

Devuelve una representación de icono de una imagen que está incluida en el archivo especificado. Returns an icon representation of an image that is contained in the specified file.

Finalize() Finalize() Finalize() 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. Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

FromHandle(IntPtr) FromHandle(IntPtr) FromHandle(IntPtr) FromHandle(IntPtr)

Crea un Icon GDI+ a partir del identificador de Windows especificado de un icono (HICON). Creates a GDI+ Icon from the specified Windows handle to an icon (HICON).

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada. Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual. Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del Object actual. Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual. Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Save(Stream) Save(Stream) Save(Stream) Save(Stream)

Guarda este Icon en el objeto de resultados Stream especificado. Saves this Icon to the specified output Stream.

ToBitmap() ToBitmap() ToBitmap() ToBitmap()

Convierte este objeto Icon en un Bitmap GDI+. Converts this Icon to a GDI+ Bitmap.

ToString() ToString() ToString() ToString()

Obtiene una cadena legible que describe Icon. Gets a human-readable string that describes the Icon.

Implementaciones de interfaz explícitas

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Rellena un objeto SerializationInfo con los datos necesarios para serializar el objeto de destino. Populates a SerializationInfo with the data that is required to serialize the target object.

Se aplica a

Consultar también