Icon Icon Icon Icon Class

Définition

Représente une icône Windows, qui est une petite image bitmap servant à représenter un objet.Represents a Windows icon, which is a small bitmap image that is used to represent an object. Les icônes peuvent être représentées comme des bitmaps transparentes, bien que leur taille soit définie par le système.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)]
[System.Serializable]
[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
type Icon = class
    inherit MarshalByRefObject
    interface ISerializable
    interface ICloneable
    interface IDisposable
Public NotInheritable Class Icon
Inherits MarshalByRefObject
Implements ICloneable, IDisposable, ISerializable
Héritage
Attributs
Implémente

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode ToBitmap.The following code example demonstrates how to use the ToBitmap method. Cet exemple est conçu pour être utilisé avec Windows Forms.This example is designed to be used with Windows Forms. Créez un formulaire et collez-y le code suivant.Create a form and paste the following code into it. Appelez la IconToBitmap méthode dans le gestionnaire d' Paint événements du formulaire en e passant PaintEventArgscomme.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

Remarques

Vous pouvez construire Icon des objets à partir de fichiers, de flux ou de ressources incorporées.You can construct Icon objects from files, streams, or embedded resources. Pour obtenir la liste des constructeurs, consultez Icon.For a list of constructors, see Icon. Vous pouvez également convertir un Icon en bitmap à l’aide de ToBitmap la méthode.You can also convert an Icon to a bitmap by using the ToBitmap method.

Une ressource icône peut contenir plusieurs images d’icône.An icon resource can contain multiple icon images. Un fichier d’icône peut contenir des images en plusieurs tailles et profondeurs de couleurs.One icon file may contain images in several sizes and color depths. L’image utilisée dans une application dépend du système d’exploitation et des paramètres.The image that is used in an application depends on the operating system and settings. La liste suivante détaille les tailles classiques d’une icône :The following list details the typical sizes for an icon:

  • 16 pixels x 16 pixels16 pixels x 16 pixels

  • 32 pixels x 32 pixels32 pixels x 32 pixels

  • 48 pixels x 48 pixels48 pixels x 48 pixels

Constructeurs

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

Initialise une nouvelle instance de la classe Icon et tente de trouver une version de l'icône correspondant à la taille demandée.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)

Initialise une nouvelle instance de la classe Icon et tente de trouver une version de l'icône correspondant à la taille demandée.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)

Initialise une nouvelle instance de la classe Icon à partir du flux de données spécifié.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)

Initialise une nouvelle instance de la classe Icon à partir du flux de données spécifié et avec la largeur et la hauteur spécifiées.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)

Initialise une nouvelle instance de la classe Icon de la taille spécifiée à partir du flux spécifié.Initializes a new instance of the Icon class of the specified size from the specified stream.

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

Initialise une nouvelle instance de la classe Icon à partir du nom de fichier spécifié.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)

Initialise une nouvelle instance de la classe Icon avec la largeur et la hauteur spécifiées du fichier spécifié.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)

Initialise une nouvelle instance de la classe Icon de la taille spécifiée à partir du fichier spécifié.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)

Initialise une nouvelle instance de la classe Icon à partir d'une ressource figurant dans l'assembly spécifié.Initializes a new instance of the Icon class from a resource in the specified assembly.

Propriétés

Handle Handle Handle Handle

Obtient le handle Windows de ce Icon.Gets the Windows handle for this Icon. Il ne s'agit pas d'une copie du handle ; ne le libérez pas.This is not a copy of the handle; do not free it.

Height Height Height Height

Obtient la hauteur de ce Icon.Gets the height of this Icon.

Size Size Size Size

Obtient la taille de ce Icon.Gets the size of this Icon.

Width Width Width Width

Obtient la largeur de ce Icon.Gets the width of this Icon.

Méthodes

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

Clone le Icon, créant une image dupliquée.Clones the Icon, creating a duplicate image.

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

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.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()

Libère toutes les ressources utilisées par ce Icon.Releases all resources used by this Icon.

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

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

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

Retourne la représentation sous forme d'icône d'une image contenue dans le fichier spécifié.Returns an icon representation of an image that is contained in the specified file.

Finalize() Finalize() Finalize() Finalize()

Autorise un objet à tenter de libérer des ressources et à exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par une opération garbage collection.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)

Crée un objet Icon GDI+ à partir du handle Windows d'icône spécifié (HICON).Creates a GDI+ Icon from the specified Windows handle to an icon (HICON).

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

Fait office de fonction de hachage par défaut.Serves as the default hash function.

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

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

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

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

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

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

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

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

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

Enregistre ce Icon dans le Stream de sortie spécifié.Saves this Icon to the specified output Stream.

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

Convertit ce Icon en Bitmap GDI+.Converts this Icon to a GDI+ Bitmap.

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

Obtient une chaîne, lisible par l'utilisateur, décrivant Icon.Gets a human-readable string that describes the Icon.

Implémentations d’interfaces explicites

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

Remplit SerializationInfo avec les données nécessaires pour sérialiser l'objet cible.Populates a SerializationInfo with the data that is required to serialize the target object.

S’applique à

Voir aussi