Icon Constructeurs

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Initialise une nouvelle instance de la classe Icon.

Surcharges

Icon(Stream)	Initialise une nouvelle instance de la classe Icon à partir du flux de données spécifié.
Icon(String)	Initialise une nouvelle instance de la classe Icon à partir du nom de fichier spécifié.
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, Size)	Initialise une nouvelle instance de la classe Icon de la taille spécifiée à partir du flux 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é.
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(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(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(Stream)

Source:

Icon.cs

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

public:
 Icon(System::IO::Stream ^ stream);

public Icon (System.IO.Stream stream);

new System.Drawing.Icon : System.IO.Stream -> System.Drawing.Icon

Public Sub New (stream As Stream)

Paramètres

stream

Stream

Flux de données à partir duquel charger le Icon.

Exceptions

ArgumentException

Le paramètre stream a la valeur null.

Remarques

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

Ce constructeur retourne la plus petite image contenue dans le flux spécifié.

Icon(String)

Source:

Icon.cs

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

public:
 Icon(System::String ^ fileName);

public Icon (string fileName);

new System.Drawing.Icon : string -> System.Drawing.Icon

Public Sub New (fileName As String)

Paramètres

fileName

String

Fichier à partir duquel charger le Icon.

Remarques

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

Ce constructeur retourne la plus petite image contenue dans le fichier spécifié.

Icon(Icon, Size)

Source:

Icon.cs

Initialise une nouvelle instance de la classe Icon et tente de trouver une version de l'icône correspondant à la taille demandée.

public:
 Icon(System::Drawing::Icon ^ original, System::Drawing::Size size);

public Icon (System.Drawing.Icon original, System.Drawing.Size size);

new System.Drawing.Icon : System.Drawing.Icon * System.Drawing.Size -> System.Drawing.Icon

Public Sub New (original As Icon, size As Size)

Paramètres

original

Icon

Icon à partir duquel charger l'icône redimensionnée.

size

Size

Structure Size qui spécifie la hauteur et la largeur du nouveau Icon.

Exceptions

ArgumentException

Le paramètre original a la valeur null.

Remarques

Si impossible de trouver une version qui correspond exactement à la taille, la correspondance la plus proche est utilisée. Si le original paramètre est un Icon qui a une taille unique, cette méthode crée uniquement une icône en double. Utilisez les fonctionnalités d’étirement de la DrawImage méthode pour redimensionner l’icône.

Icon(Stream, Size)

Source:

Icon.cs

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

public:
 Icon(System::IO::Stream ^ stream, System::Drawing::Size size);

public Icon (System.IO.Stream stream, System.Drawing.Size size);

new System.Drawing.Icon : System.IO.Stream * System.Drawing.Size -> System.Drawing.Icon

Public Sub New (stream As Stream, size As Size)

Paramètres

stream

Stream

Flux qui contient les données d'icône.

size

Size

Taille souhaitée pour l'icône.

Exceptions

ArgumentException

stream a la valeur null ou ne contient pas de données image.

Icon(String, Size)

Source:

Icon.cs

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

public:
 Icon(System::String ^ fileName, System::Drawing::Size size);

public Icon (string fileName, System.Drawing.Size size);

new System.Drawing.Icon : string * System.Drawing.Size -> System.Drawing.Icon

Public Sub New (fileName As String, size As Size)

Paramètres

fileName

String

Nom et chemin d'accès du fichier qui contient les données d'icône.

size

Size

Taille souhaitée pour l'icône.

Exceptions

ArgumentException

string a la valeur null ou ne contient pas de données image.

Remarques

Si le fichier spécifié ne contient pas d’image correspondant à la taille souhaitée, l’icône qui a la taille la plus proche est retournée.

le fileName doit inclure le chemin d’accès complet s’il ne se trouve pas dans le répertoire de l’application active.

Icon(Type, String)

Source:

Icon.cs

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

public:
 Icon(Type ^ type, System::String ^ resource);

public Icon (Type type, string resource);

new System.Drawing.Icon : Type * string -> System.Drawing.Icon

Public Sub New (type As Type, resource As String)

Paramètres

type

Type

Type qui spécifie l'assembly dans lequel rechercher la ressource.

resource

String

Nom de la ressource à charger.

Exceptions

ArgumentException

Une icône spécifiée par resource est introuvable dans l'assembly contenant le type spécifié.

Exemples

L’exemple de code suivant montre comment utiliser le Icon constructeur. Pour exécuter cet exemple, collez le code dans un Windows Form et gérez l’événement du Paint formulaire. Appelez la ConstructAnIconFromAType méthode à partir du Paint gestionnaire d’événements, en passant e comme EventArgs.

private void ConstructAnIconFromAType(PaintEventArgs e)
{

    Icon icon1 = new Icon(typeof(Control), "Error.ico");
    e.Graphics.DrawIcon(icon1, new Rectangle(10, 10, 50, 50));
}

Private Sub ConstructAnIconFromAType(ByVal e As PaintEventArgs)

    Dim icon1 As New Icon(GetType(Control), "Error.ico")
    e.Graphics.DrawIcon(icon1, New Rectangle(10, 10, 50, 50))

End Sub

Remarques

Ce constructeur crée un à partir d’une Icon ressource avec le nom spécifié par le resource paramètre dans l’assembly qui contient le type spécifié par le type paramètre .

Ce constructeur combine l’espace de noms du type donné avec le nom de chaîne de la ressource et recherche une correspondance dans le manifeste de l’assembly. Par exemple, vous pouvez passer le Control type et Error.ico à ce constructeur, et il recherche une ressource nommée System.Windows.Forms.Error.ico.

Icon(Icon, Int32, Int32)

Source:

Icon.cs

Initialise une nouvelle instance de la classe Icon et tente de trouver une version de l'icône correspondant à la taille demandée.

public:
 Icon(System::Drawing::Icon ^ original, int width, int height);

public Icon (System.Drawing.Icon original, int width, int height);

new System.Drawing.Icon : System.Drawing.Icon * int * int -> System.Drawing.Icon

Public Sub New (original As Icon, width As Integer, height As Integer)

Paramètres

original

Icon

Icône à partir de laquelle charger la taille différente.

width

Int32

Largeur de la nouvelle icône.

height

Int32

Hauteur de la nouvelle icône.

Exceptions

ArgumentException

Le paramètre original a la valeur null.

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

Si impossible de trouver une version qui correspond exactement à la taille, la correspondance la plus proche est utilisée. Si le original paramètre est un Icon qui a une taille unique, cette méthode crée uniquement une icône en double. Utilisez les fonctionnalités d’étirement de la DrawImage méthode pour redimensionner l’icône.

Icon(Stream, Int32, Int32)

Source:

Icon.cs

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.

public:
 Icon(System::IO::Stream ^ stream, int width, int height);

public Icon (System.IO.Stream stream, int width, int height);

new System.Drawing.Icon : System.IO.Stream * int * int -> System.Drawing.Icon

Public Sub New (stream As Stream, width As Integer, height As Integer)

Paramètres

stream

Stream

Flux de données à partir duquel charger l'icône.

width

Int32

Largeur, en pixels, de l'icône.

height

Int32

Hauteur, en pixels, de l'icône.

Exceptions

ArgumentException

Le paramètre stream a la valeur null.

Icon(String, Int32, Int32)

Source:

Icon.cs

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

public:
 Icon(System::String ^ fileName, int width, int height);

public Icon (string fileName, int width, int height);

new System.Drawing.Icon : string * int * int -> System.Drawing.Icon

Public Sub New (fileName As String, width As Integer, height As Integer)

Paramètres

fileName

String

Chemin d’accès et nom du fichier qui contient les données Icon.

width

Int32

Largeur souhaitée de Icon.

height

Int32

Hauteur souhaitée de Icon.

Exceptions

ArgumentException

string a la valeur null ou ne contient pas de données image.

Remarques

Si le fichier spécifié ne contient pas d’image correspondant à la hauteur et à la largeur souhaitées, l’icône qui a la taille la plus proche est retournée.

le fileName doit inclure le chemin d’accès complet s’il ne se trouve pas dans le répertoire de l’application active.