Icon Icon Icon Icon Constructors

Definizione

Overload

Icon(Stream) Icon(Stream) Icon(Stream)

Inizializza una nuova istanza della classe Icon dal flusso dei dati specificato.Initializes a new instance of the Icon class from the specified data stream.

Icon(String) Icon(String) Icon(String) Icon(String)

Inizializza una nuova istanza della classe Icon dal nome file specificato.Initializes a new instance of the Icon class from the specified file name.

Icon(Icon, Size) Icon(Icon, Size) Icon(Icon, Size)

Inizializza una nuova istanza della classe Icon e tenta di individuare una versione dell'icona che corrisponda alle dimensioni richieste.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) Icon(Stream, Size) Icon(Stream, Size)

Inizializza una nuova istanza della classe Icon delle dimensioni indicate dal flusso specificato.Initializes a new instance of the Icon class of the specified size from the specified stream.

Icon(String, Size) Icon(String, Size) Icon(String, Size)

Inizializza una nuova istanza della classe Icon delle dimensioni indicate dal file specificato.Initializes a new instance of the Icon class of the specified size from the specified file.

Icon(Type, String) Icon(Type, String) Icon(Type, String)

Inizializza una nuova istanza della classe Icon da una risorsa nell'assembly specificato.Initializes a new instance of the Icon class from a resource in the specified assembly.

Icon(Icon, Int32, Int32) Icon(Icon, Int32, Int32) Icon(Icon, Int32, Int32) Icon(Icon, Int32, Int32)

Inizializza una nuova istanza della classe Icon e tenta di individuare una versione dell'icona che corrisponda alle dimensioni richieste.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) Icon(Stream, Int32, Int32) Icon(Stream, Int32, Int32)

Inizializza una nuova istanza della classe Icon dal flusso di dati specificato e con la larghezza e l'altezza indicate.Initializes a new instance of the Icon class from the specified data stream and with the specified width and height.

Icon(String, Int32, Int32) Icon(String, Int32, Int32) Icon(String, Int32, Int32) Icon(String, Int32, Int32)

Inizializza una nuova istanza della classe Icon con la larghezza e l'altezza specificate dal file.Initializes a new instance of the Icon class with the specified width and height from the specified file.

Icon(Stream) Icon(Stream) Icon(Stream)

Inizializza una nuova istanza della classe Icon dal flusso dei dati specificato.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

Parametri

stream
Stream Stream Stream Stream

Flusso di dati da cui caricare l'oggetto Icon.The data stream from which to load the Icon.

Eccezioni

Il valore del parametro stream è null.The stream parameter is null.

Commenti

Una risorsa icona può contenere più immagini icona.An icon resource can contain multiple icon images. Un file di icona possa contenere immagini in vari formati e intensità di colore.One icon file may contain images in several sizes and color depths. L'immagine che viene usata in un'applicazione varia a seconda del sistema operativo e le impostazioni.The image that is used in an application depends on the operating system and settings. Nell'elenco seguente illustra nel dettaglio le dimensioni del tipiche per un'icona:The following list details the typical sizes for an icon:

  • 16 x 16 pixel16 pixels x 16 pixels

  • 32 x 32 pixel32 pixels x 32 pixels

  • 48 x 48 pixel48 pixels x 48 pixels

Questo costruttore restituisce la più piccola immagine contenuta nel flusso specificato.This constructor returns the smallest image that is contained in the specified stream.

Icon(String) Icon(String) Icon(String) Icon(String)

Inizializza una nuova istanza della classe Icon dal nome file specificato.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)

Parametri

fileName
String String String String

File da cui caricare l'oggetto Icon.The file to load the Icon from.

Commenti

Una risorsa icona può contenere più immagini icona.An icon resource can contain multiple icon images. Un file di icona possa contenere immagini in vari formati e intensità di colore.One icon file may contain images in several sizes and color depths. L'immagine che viene usata in un'applicazione varia a seconda del sistema operativo e le impostazioni.The image that is used in an application depends on the operating system and settings. Nell'elenco seguente illustra nel dettaglio le dimensioni del tipiche per un'icona:The following list details the typical sizes for an icon:

  • 16 x 16 pixel16 pixels x 16 pixels

  • 32 x 32 pixel32 pixels x 32 pixels

  • 48 x 48 pixel48 pixels x 48 pixels

Questo costruttore restituisce la più piccola immagine contenuta nel file specificato.This constructor returns the smallest image that is contained in the specified file.

Icon(Icon, Size) Icon(Icon, Size) Icon(Icon, Size)

Inizializza una nuova istanza della classe Icon e tenta di individuare una versione dell'icona che corrisponda alle dimensioni richieste.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

Parametri

original
Icon Icon Icon Icon

Oggetto Icon da cui caricare l'icona appena dimensionata.The Icon from which to load the newly sized icon.

size
Size Size Size Size

Struttura Size che specifica l'altezza e la larghezza del nuovo oggetto Icon.A Size structure that specifies the height and width of the new Icon.

Eccezioni

Il valore del parametro original è null.The original parameter is null.

Commenti

Se non viene trovata una versione che corrisponde esattamente alla dimensione, viene utilizzata la corrispondenza più vicina.If a version cannot be found that exactly matches the size, the closest match is used. Se il original parametro è un Icon che dispone di una singola dimensione, questo metodo consente di creare solo un'icona di duplicati.If the original parameter is an Icon that has a single size, this method only creates a duplicate icon. Usare la funzionalità di estensione del DrawImage metodo per ridimensionare l'icona.Use the stretching capabilities of the DrawImage method to resize the icon.

Icon(Stream, Size) Icon(Stream, Size) Icon(Stream, Size)

Inizializza una nuova istanza della classe Icon delle dimensioni indicate dal flusso specificato.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

Parametri

stream
Stream Stream Stream Stream

Flusso in cui sono contenuti i dati dell'icona.The stream that contains the icon data.

size
Size Size Size Size

Dimensioni dell'icona.The desired size of the icon.

Eccezioni

stream non contiene dati di immagine o è null.The stream is null or does not contain image data.

Icon(String, Size) Icon(String, Size) Icon(String, Size)

Inizializza una nuova istanza della classe Icon delle dimensioni indicate dal file specificato.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

Parametri

fileName
String String String String

Nome e percorso del file in cui sono contenuti i dati dell'icona.The name and path to the file that contains the icon data.

size
Size Size Size Size

Dimensioni dell'icona.The desired size of the icon.

Eccezioni

string non contiene dati di immagine o è null.The string is null or does not contain image data.

Commenti

Se il file specificato non contiene un'immagine che corrisponde alle dimensioni desiderate, viene restituito l'icona con la dimensione più vicina.If the specified file does not contain an image that matches the desired size, the icon that has the closest size is returned.

Il fileName deve includere il percorso completo se non è presente nella directory dell'applicazione corrente.The fileName should include the complete path if it is not in the current application directory.

Icon(Type, String) Icon(Type, String) Icon(Type, String)

Inizializza una nuova istanza della classe Icon da una risorsa nell'assembly specificato.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

Parametri

type
Type Type Type Type

Oggetto Type che specifica l'assembly in cui cercare la risorsa.A Type that specifies the assembly in which to look for the resource.

resource
String String String String

Nome di risorsa da caricare.The resource name to load.

Eccezioni

Non è possibile trovare un'icona specificata da resource nell'assembly che contiene il parametro type specificato.An icon specified by resource cannot be found in the assembly that contains the specified type.

Esempi

Esempio di codice seguente viene illustrato come utilizzare il Icon costruttore.The following code example demonstrates how to use the Icon constructor. Per eseguire questo esempio, incollare il codice in un modulo di Windows e la gestione del modulo Paint evento.To run this example, paste the code into a Windows Form and handle the form's Paint event. Chiamare il ConstructAnIconFromAType metodo dal Paint gestore eventi, passando e come 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

Commenti

Questo costruttore crea un Icon da una risorsa con il nome specificato per il resource nell'assembly che contiene il tipo specificato dal parametro di type parametro.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.

Questo costruttore combina lo spazio dei nomi del tipo specificato insieme al nome di stringa della risorsa e Cerca una corrispondenza nel manifesto dell'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. Ad esempio è possibile passare il Control tipo e Error.ico a questo costruttore e si cerca una risorsa denominata 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.

Icon(Icon, Int32, Int32) Icon(Icon, Int32, Int32) Icon(Icon, Int32, Int32) Icon(Icon, Int32, Int32)

Inizializza una nuova istanza della classe Icon e tenta di individuare una versione dell'icona che corrisponda alle dimensioni richieste.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)

Parametri

original
Icon Icon Icon Icon

Icona da cui caricare le dimensioni diverse.The icon to load the different size from.

width
Int32 Int32 Int32 Int32

Larghezza della nuova icona.The width of the new icon.

height
Int32 Int32 Int32 Int32

Altezza della nuova icona.The height of the new icon.

Eccezioni

Il valore del parametro original è null.The original parameter is null.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo ToBitmap.The following code example demonstrates how to use the ToBitmap method. In questo esempio è progettato per essere usato con Windows Form.This example is designed to be used with Windows Forms. Creare un modulo e incollare il codice seguente al suo interno.Create a form and paste the following code into it. Chiamare il IconToBitmap metodo del modulo Paint gestore eventi, passando e come 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

Commenti

Se non viene trovata una versione che corrisponde esattamente alla dimensione, viene utilizzata la corrispondenza più vicina.If a version cannot be found that exactly matches the size, the closest match is used. Se il original parametro è un Icon che dispone di una singola dimensione, questo metodo consente di creare solo un'icona di duplicati.If the original parameter is an Icon that has a single size, this method only creates a duplicate icon. Usare la funzionalità di estensione del DrawImage metodo per ridimensionare l'icona.Use the stretching capabilities of the DrawImage method to resize the icon.

Icon(Stream, Int32, Int32) Icon(Stream, Int32, Int32) Icon(Stream, Int32, Int32)

Inizializza una nuova istanza della classe Icon dal flusso di dati specificato e con la larghezza e l'altezza indicate.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

Parametri

stream
Stream Stream Stream Stream

Flusso di dati da cui caricare l'icona.The data stream from which to load the icon.

width
Int32 Int32 Int32 Int32

Larghezza, in pixel, dell'icona.The width, in pixels, of the icon.

height
Int32 Int32 Int32 Int32

Altezza, in pixel, dell'icona.The height, in pixels, of the icon.

Eccezioni

Il valore del parametro stream è null.The stream parameter is null.

Icon(String, Int32, Int32) Icon(String, Int32, Int32) Icon(String, Int32, Int32) Icon(String, Int32, Int32)

Inizializza una nuova istanza della classe Icon con la larghezza e l'altezza specificate dal file.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)

Parametri

fileName
String String String String

Nome e percorso del file in cui sono contenuti i dati dell'oggetto Icon.The name and path to the file that contains the Icon data.

width
Int32 Int32 Int32 Int32

Larghezza desiderata dell'oggetto Icon.The desired width of the Icon.

height
Int32 Int32 Int32 Int32

Altezza desiderata dell'oggetto Icon.The desired height of the Icon.

Eccezioni

string non contiene dati di immagine o è null.The string is null or does not contain image data.

Commenti

Se il file specificato non contiene un'immagine che corrisponde all'altezza desiderata e la larghezza, viene restituito l'icona con la dimensione più vicina.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.

Il fileName deve includere il percorso completo se non è presente nella directory dell'applicazione corrente.The fileName should include the complete path if it is not in the current application directory.

Si applica a