Icon Clase
Definición
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í.
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 ( |
| 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) | |
| ToBitmap() | |
| 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. |