Icon Constructeurs

Définition

Initialise une nouvelle instance de la classe Icon.Initializes a new instance of the Icon class.

Surcharges

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(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(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, 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, 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)

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.

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(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(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é.Initializes a new instance of the Icon class with the specified width and height from the specified file.

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.

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.The data stream from which to load the Icon.

Exceptions

Le paramètre stream a la valeur null.The stream parameter is null.

Remarques

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

Ce constructeur retourne l’image la plus petite contenue dans le flux spécifié.This constructor returns the smallest image that is contained in the specified stream.

S’applique à

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.

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.The file to load the Icon from.

Remarques

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

Ce constructeur retourne l’image la plus petite contenue dans le fichier spécifié.This constructor returns the smallest image that is contained in the specified file.

S’applique à

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.

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.The Icon from which to load the newly sized icon.

size
Size

Structure Size qui spécifie la hauteur et la largeur du nouveau Icon.A Size structure that specifies the height and width of the new Icon.

Exceptions

Le paramètre original a la valeur null.The original parameter is null.

Remarques

Si une version qui correspond exactement à la taille est introuvable, la correspondance la plus proche est utilisée.If a version cannot be found that exactly matches the size, the closest match is used. Si le original paramètre est un Icon qui a une seule taille, cette méthode crée uniquement une icône en double.If the original parameter is an Icon that has a single size, this method only creates a duplicate icon. Utilisez les fonctionnalités d’étirement de la DrawImage méthode pour redimensionner l’icône.Use the stretching capabilities of the DrawImage method to resize the icon.

S’applique à

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.

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.The stream that contains the icon data.

size
Size

Taille souhaitée pour l'icône.The desired size of the icon.

Exceptions

stream a la valeur null ou ne contient pas de données image.The stream is null or does not contain image data.

S’applique à

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.

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.The name and path to the file that contains the icon data.

size
Size

Taille souhaitée pour l'icône.The desired size of the icon.

Exceptions

string a la valeur null ou ne contient pas de données image.The string is null or does not contain image data.

Remarques

Si le fichier spécifié ne contient pas d’image qui correspond à la taille souhaitée, l’icône qui a la taille la plus proche est retournée.If the specified file does not contain an image that matches the desired size, the icon that has the closest size is returned.

Le fileName doit inclure le chemin d’accès complet s’il ne se trouve pas dans le répertoire de l’application actuelle.The fileName should include the complete path if it is not in the current application directory.

S’applique à

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.

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.A Type that specifies the assembly in which to look for the resource.

resource
String

Nom de la ressource à charger.The resource name to load.

Exceptions

Une icône spécifiée par resource est introuvable dans l'assembly contenant le type spécifié.An icon specified by resource cannot be found in the assembly that contains the specified type.

Exemples

L’exemple de code suivant montre comment utiliser le Icon constructeur.The following code example demonstrates how to use the Icon constructor. Pour exécuter cet exemple, collez le code dans un Windows Form et gérez l’événement du formulaire Paint .To run this example, paste the code into a Windows Form and handle the form's Paint event. Appelez la ConstructAnIconFromAType méthode à partir du Paint Gestionnaire d’événements, e en passant en tant que EventArgs .Call the ConstructAnIconFromAType method from the Paint event handler, passing e as 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 Icon à partir d’une 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.This constructor creates an Icon from a resource with the name specified by the resource parameter in the assembly that contains the type specified by the type parameter.

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.This constructor combines the namespace of the given type together with the string name of the resource and looks for a match in the assembly manifest. 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 .For example you can pass in the Control type and Error.ico to this constructor, and it looks for a resource that is named System.Windows.Forms.Error.ico.

S’applique à

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.

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.The icon to load the different size from.

width
Int32

Largeur de la nouvelle icône.The width of the new icon.

height
Int32

Hauteur de la nouvelle icône.The height of the new icon.

Exceptions

Le paramètre original a la valeur null.The original parameter is null.

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 e en passant comme 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

Remarques

Si une version qui correspond exactement à la taille est introuvable, la correspondance la plus proche est utilisée.If a version cannot be found that exactly matches the size, the closest match is used. Si le original paramètre est un Icon qui a une seule taille, cette méthode crée uniquement une icône en double.If the original parameter is an Icon that has a single size, this method only creates a duplicate icon. Utilisez les fonctionnalités d’étirement de la DrawImage méthode pour redimensionner l’icône.Use the stretching capabilities of the DrawImage method to resize the icon.

S’applique à

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.

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.The data stream from which to load the icon.

width
Int32

Largeur, en pixels, de l'icône.The width, in pixels, of the icon.

height
Int32

Hauteur, en pixels, de l'icône.The height, in pixels, of the icon.

Exceptions

Le paramètre stream a la valeur null.The stream parameter is null.

S’applique à

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é.Initializes a new instance of the Icon class with the specified width and height from the specified file.

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.The name and path to the file that contains the Icon data.

width
Int32

Largeur souhaitée de Icon.The desired width of the Icon.

height
Int32

Hauteur souhaitée de Icon.The desired height of the Icon.

Exceptions

string a la valeur null ou ne contient pas de données image.The string is null or does not contain image data.

Remarques

Si le fichier spécifié ne contient pas d’image qui correspond à la hauteur et à la largeur souhaitées, l’icône ayant la taille la plus proche est retournée.If the specified file does not contain an image that matches the desired height and width, the icon that has the closest size is returned.

Le fileName doit inclure le chemin d’accès complet s’il ne se trouve pas dans le répertoire de l’application actuelle.The fileName should include the complete path if it is not in the current application directory.

S’applique à