Icon Constructeurs

Définition

Initialise une nouvelle instance de la classe Icon.

Surcharges

Nom Description
Icon(Stream)

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

Icon(String)

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

Icon(Icon, Size)

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

Icon(Stream, Size)

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

Icon(String, Size)

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

Icon(Type, String)

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

Icon(Icon, Int32, Int32)

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

Icon(Stream, Int32, Int32)

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

Icon(Stream)

Initialise une nouvelle instance de la Icon classe à 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

Le stream paramètre est 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 couleur. 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 classiques 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é.

S’applique à

Icon(String)

Initialise une nouvelle instance de la Icon classe à 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 fichier.

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 couleur. 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 classiques 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é.

S’applique à

Icon(Icon, Size)

Initialise une nouvelle instance de la Icon classe et tente de trouver une version de l’icône qui correspond à 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 nouvellement dimensionnée.

size
Size

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

Exceptions

Le original paramètre est null.

Remarques

Si une version est introuvable qui correspond exactement à la taille, la correspondance la plus proche est utilisée. Si le original paramètre est une Icon 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.

S’applique à

Icon(Stream, Size)

Initialise une nouvelle instance de la Icon classe 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 de l’icône.

Exceptions

null Il stream ne contient pas ou ne contient pas de données d’image.

S’applique à

Icon(String, Size)

Initialise une nouvelle instance de la Icon classe 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 au fichier qui contient les données d’icône.

size
Size

Taille souhaitée de l’icône.

Exceptions

null Il fileName ne contient pas ou ne contient pas de données d’image.

Remarques

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

Le fileName chemin d’accès complet doit être inclus s’il n’est pas dans le répertoire de l’application active.

S’applique à

Icon(Type, String)

Initialise une nouvelle instance de la Icon classe à partir d’une ressource 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

Qui Type spécifie l’assembly dans lequel rechercher la ressource.

resource
String

Nom de la ressource à charger.

Exceptions

Une icône spécifiée par resource est introuvable dans l’assembly qui contient le fichier spécifié type.

Exemples

L’exemple de code suivant montre comment utiliser le Icon constructeur. Pour exécuter cet exemple, collez le code dans un formulaire Windows et gérez l'événement Paint du formulaire. Appelez la ConstructAnIconFromAType méthode à partir du gestionnaire d’événements Paint , en passant e en tant que 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 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 d’assembly. Par exemple, vous pouvez transmettre le type Control et Error.ico à ce constructeur, et il recherche une ressource nommée System.Windows.Forms.Error.ico.

S’applique à

Icon(Icon, Int32, Int32)

Initialise une nouvelle instance de la Icon classe et tente de trouver une version de l’icône qui correspond à 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 à charger la taille différente de celle de celle-ci.

width
Int32

Largeur de la nouvelle icône.

height
Int32

Hauteur de la nouvelle icône.

Exceptions

Le original paramètre est null.

Exemples

L’exemple de code suivant montre comment utiliser la ToBitmap méthode. Cet exemple est conçu pour être utilisé avec Windows Forms. Créez un formulaire et collez-y le code suivant. Appelez la méthode dans le IconToBitmap gestionnaire d’événements du Paint formulaire, en passant e en tant que 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 est introuvable qui correspond exactement à la taille, la correspondance la plus proche est utilisée. Si le original paramètre est une Icon 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.

S’applique à

Icon(Stream, Int32, Int32)

Initialise une nouvelle instance de la Icon classe à 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

Le stream paramètre est null.

S’applique à

Icon(String, Int32, Int32)

Initialise une nouvelle instance de la Icon classe 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

Nom et chemin d’accès au fichier qui contient les Icon données.

width
Int32

Largeur souhaitée du Icon.

height
Int32

Hauteur souhaitée du Icon.

Exceptions

null Il fileName ne contient pas ou ne contient pas de données d’image.

Remarques

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

Le fileName chemin d’accès complet doit être inclus s’il n’est pas dans le répertoire de l’application active.

S’applique à