Icon Costruttori

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Inizializza una nuova istanza della classe Icon.

Overload

Icon(Stream)	Inizializza una nuova istanza della classe Icon dal flusso dei dati specificato.
Icon(String)	Inizializza una nuova istanza della classe Icon dal nome file specificato.
Icon(Icon, Size)	Inizializza una nuova istanza della classe Icon e prova a individuare una versione dell'icona che corrisponda alle dimensioni richieste.
Icon(Stream, Size)	Inizializza una nuova istanza della classe Icon delle dimensioni indicate dal flusso specificato.
Icon(String, Size)	Inizializza una nuova istanza della classe Icon delle dimensioni indicate dal file specificato.
Icon(Type, String)	Inizializza una nuova istanza della classe Icon da una risorsa nell'assembly specificato.
Icon(Icon, Int32, Int32)	Inizializza una nuova istanza della classe Icon e prova a individuare una versione dell'icona che corrisponda alle dimensioni richieste.
Icon(Stream, Int32, Int32)	Inizializza una nuova istanza della classe Icon dal flusso dei dati specificato e con la larghezza e l'altezza indicate.
Icon(String, Int32, Int32)	Inizializza una nuova istanza della classe Icon con la larghezza e l'altezza specificate dal file.

Icon(Stream)

Origine:

Icon.cs

Inizializza una nuova istanza della classe Icon dal flusso dei dati specificato.

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)

Parametri

stream

Stream

Flusso dei dati da cui caricare l'oggetto Icon.

Eccezioni

ArgumentException

Il valore del parametro stream è null.

Commenti

Una risorsa icona può contenere più immagini icona. Un file di icona può contenere immagini in diverse dimensioni e profondità di colore. L'immagine usata in un'applicazione dipende dal sistema operativo e dalle impostazioni. L'elenco seguente illustra in dettaglio le dimensioni tipiche per un'icona:

• 16 pixel x 16 pixel

• 32 pixel x 32 pixel

• 48 pixel x 48 pixel

Questo costruttore restituisce l'immagine più piccola contenuta nel flusso specificato.

Icon(String)

Origine:

Icon.cs

Inizializza una nuova istanza della classe Icon dal nome file specificato.

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

File da cui caricare l'oggetto Icon.

Commenti

Una risorsa icona può contenere più immagini icona. Un file di icona può contenere immagini in diverse dimensioni e profondità di colore. L'immagine usata in un'applicazione dipende dal sistema operativo e dalle impostazioni. L'elenco seguente illustra in dettaglio le dimensioni tipiche per un'icona:

• 16 pixel x 16 pixel

• 32 pixel x 32 pixel

• 48 pixel x 48 pixel

Questo costruttore restituisce l'immagine più piccola contenuta nel file specificato.

Icon(Icon, Size)

Origine:

Icon.cs

Inizializza una nuova istanza della classe Icon e prova a individuare una versione dell'icona che corrisponda alle dimensioni richieste.

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)

Parametri

original

Icon

Oggetto Icon da cui caricare l'icona appena ridimensionata.

size

Size

Struttura Size che specifica l'altezza e la larghezza del nuovo oggetto Icon.

Eccezioni

ArgumentException

Il valore del parametro original è null.

Commenti

Se non è possibile trovare una versione che corrisponde esattamente alla dimensione, viene usata la corrispondenza più vicina. Se il original parametro è un Icon oggetto con dimensioni singole, questo metodo crea solo un'icona duplicata. Usare le funzionalità di estensione del DrawImage metodo per ridimensionare l'icona.

Icon(Stream, Size)

Origine:

Icon.cs

Inizializza una nuova istanza della classe Icon delle dimensioni indicate dal flusso specificato.

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)

Parametri

stream

Stream

Flusso in cui sono contenuti i dati dell'icona.

size

Size

Dimensioni desiderate per l'icona.

Eccezioni

ArgumentException

stream non contiene dati di immagine o è null.

Icon(String, Size)

Origine:

Icon.cs

Inizializza una nuova istanza della classe Icon delle dimensioni indicate dal file specificato.

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)

Parametri

fileName

String

Nome e percorso del file in cui sono contenuti i dati dell'icona.

size

Size

Dimensioni desiderate per l'icona.

Eccezioni

ArgumentException

string non contiene dati di immagine o è null.

Commenti

Se il file specificato non contiene un'immagine corrispondente alle dimensioni desiderate, viene restituita l'icona con le dimensioni più vicine.

Deve fileName includere il percorso completo se non si trova nella directory dell'applicazione corrente.

Icon(Type, String)

Origine:

Icon.cs

Inizializza una nuova istanza della classe Icon da una risorsa nell'assembly specificato.

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)

Parametri

type

Type

Oggetto Type che specifica l'assembly in cui cercare la risorsa.

resource

String

Nome di risorsa da caricare.

Eccezioni

ArgumentException

Non è possibile trovare un'icona specificata da resource nell'assembly che contiene il parametro type specificato.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il Icon costruttore. Per eseguire questo esempio, incollare il codice in un Windows Form e gestire l'evento del Paint modulo. Chiamare il ConstructAnIconFromAType metodo dal Paint gestore eventi, passando e come 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 oggetto Icon da una risorsa con il nome specificato dal resource parametro nell'assembly che contiene il tipo specificato dal type parametro .

Questo costruttore combina lo spazio dei nomi del tipo specificato insieme al nome stringa della risorsa e cerca una corrispondenza nel manifesto dell'assembly. Ad esempio, è possibile passare il Control tipo e Error.ico a questo costruttore e cerca una risorsa denominata System.Windows.Forms.Error.ico.

Icon(Icon, Int32, Int32)

Origine:

Icon.cs

Inizializza una nuova istanza della classe Icon e prova a individuare una versione dell'icona che corrisponda alle dimensioni richieste.

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

Icona da cui caricare le dimensioni diverse.

width

Int32

Larghezza della nuova icona.

height

Int32

Altezza della nuova icona.

Eccezioni

ArgumentException

Il valore del parametro original è null.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo ToBitmap. Questo esempio è progettato per essere usato con Windows Forms. Create un modulo e incollare il codice seguente. Chiamare il IconToBitmap metodo nel gestore eventi del Paint modulo, passando e come 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 è possibile trovare una versione che corrisponde esattamente alla dimensione, viene usata la corrispondenza più vicina. Se il original parametro è un Icon oggetto con dimensioni singole, questo metodo crea solo un'icona duplicata. Usare le funzionalità di estensione del DrawImage metodo per ridimensionare l'icona.

Icon(Stream, Int32, Int32)

Origine:

Icon.cs

Inizializza una nuova istanza della classe Icon dal flusso dei dati specificato e con la larghezza e l'altezza indicate.

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)

Parametri

stream

Stream

Flusso di dati da cui caricare l'icona.

width

Int32

Larghezza, in pixel, dell'icona.

height

Int32

Altezza, in pixel, dell'icona.

Eccezioni

ArgumentException

Il valore del parametro stream è null.

Icon(String, Int32, Int32)

Origine:

Icon.cs

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

Nome e percorso del file in cui sono contenuti i dati dell'oggetto Icon.

width

Int32

Larghezza desiderata dell'oggetto Icon.

height

Int32

Altezza desiderata dell'oggetto Icon.

Eccezioni

ArgumentException

string non contiene dati di immagine o è null.

Commenti

Se il file specificato non contiene un'immagine corrispondente all'altezza e alla larghezza desiderata, viene restituita l'icona con le dimensioni più vicine.

Deve fileName includere il percorso completo se non si trova nella directory dell'applicazione corrente.