Icon Classe

Définition

Représente une icône Windows, qui est une petite image bitmap servant à représenter un objet. Les icônes peuvent être considérées comme des bitmaps transparentes, bien que leur taille soit définie par le système.

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
Héritage
Attributs
Implémente

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode ToBitmap. Cet exemple est conçu pour être utilisé avec Windows Forms. Create un formulaire et collez-y le code suivant. Appelez la IconToBitmap méthode dans le gestionnaire d’événements du Paint formulaire, en passant e comme 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 des Icon objets à partir de fichiers, de flux ou de ressources incorporées. Pour obtenir la liste des constructeurs, consultez Icon. Vous pouvez également convertir un en Icon bitmap à l’aide de la ToBitmap méthode .

Notes

Dans .NET 6 et versions ultérieures, le package System.Drawing.Common, qui inclut ce type, est pris en charge uniquement sur les systèmes d’exploitation Windows. L’utilisation de ce type dans les applications multiplateformes provoque des avertissements au moment de la compilation et des exceptions d’exécution. Pour plus d’informations, consultez System.Drawing.Common uniquement pris en charge sur Windows.

Une ressource d’icône peut contenir plusieurs images d’icône. Un fichier d’icône peut contenir des images de plusieurs tailles et profondeurs de couleurs. L’image utilisée dans une application dépend du système d’exploitation et des paramètres. La liste suivante détaille les tailles standard d’une icône :

  • 16 pixels x 16 pixels

  • 32 pixels x 32 pixels

  • 48 pixels x 48 pixels

Constructeurs

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.

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.

Icon(Stream)

Initialise une nouvelle instance de la classe Icon à partir du flux de données spécifié.

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.

Icon(Stream, Size)

Initialise une nouvelle instance de la classe Icon de la taille spécifiée à partir du flux spécifié.

Icon(String)

Initialise une nouvelle instance de la classe Icon à partir du nom de fichier spécifié.

Icon(String, Int32, Int32)

Initialise une nouvelle instance de la classe Icon avec la largeur et la hauteur spécifiées à partir du fichier spécifié.

Icon(String, Size)

Initialise une nouvelle instance de la classe Icon de la taille spécifiée à partir du fichier spécifié.

Icon(Type, String)

Initialise une nouvelle instance de la classe Icon à partir d'une ressource figurant dans l'assembly spécifié.

Propriétés

Handle

Obtient le handle Windows de ce Icon. Il ne s'agit pas d'une copie du handle ; ne le libérez pas.

Height

Obtient la hauteur de ce Icon.

Size

Obtient la taille de ce Icon.

Width

Obtient la largeur de ce Icon.

Méthodes

Clone()

Clone le Icon, créant une image dupliquée.

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.

(Hérité de MarshalByRefObject)
Dispose()

Libère toutes les ressources utilisées par ce Icon.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
ExtractAssociatedIcon(String)

Retourne la représentation sous forme d'icône d'une image contenue dans le fichier spécifié.

ExtractIcon(String, Int32, Boolean)

Extrait une icône spécifiée du donné filePath.

ExtractIcon(String, Int32, Int32)

Extrait une icône spécifiée du donné filePath.

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.

FromHandle(IntPtr)

Crée un objet Icon GDI+ à partir du handle Windows spécifié d'une icône (HICON).

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetLifetimeService()
Obsolète.

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.

(Hérité de MarshalByRefObject)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
InitializeLifetimeService()
Obsolète.

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.

(Hérité de MarshalByRefObject)
Save(Stream)

Enregistre ce Icon dans le Stream de sortie spécifié.

ToBitmap()

Convertit ce Icon en Bitmap GDI+.

ToString()

Obtient une chaîne, lisible par l'utilisateur, décrivant le Icon.

Implémentations d’interfaces explicites

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Remplit un SerializationInfo avec les données nécessaires pour sérialiser l'objet cible.

S’applique à

Voir aussi