Icon Constructeurs
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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
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
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
- 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
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.