Partilhar via


Icon Construtores

Definição

Inicializa uma nova instância da classe Icon.

Sobrecargas

Icon(Stream)

Inicializa uma nova instância da classe Icon do fluxo de dados especificado.

Icon(String)

Inicializa uma nova instância da classe Icon do nome do arquivo especificado.

Icon(Icon, Size)

Inicializa uma nova instância da classe Icon e tenta localizar uma versão do ícone que corresponde ao tamanho solicitado.

Icon(Stream, Size)

Inicializa uma nova instância da classe Icon do tamanho especificado do fluxo especificado.

Icon(String, Size)

Inicializa uma nova instância da classe Icon do tamanho especificado do arquivo especificado.

Icon(Type, String)

Inicializa uma nova instância da classe Icon de um recurso no assembly especificado.

Icon(Icon, Int32, Int32)

Inicializa uma nova instância da classe Icon e tenta localizar uma versão do ícone que corresponde ao tamanho solicitado.

Icon(Stream, Int32, Int32)

Inicializa uma nova instância da classe Icon do fluxo de dados especificado e com a altura e largura especificadas.

Icon(String, Int32, Int32)

Inicializa uma nova instância da classe Icon com a largura e altura especificadas do arquivo especificado.

Icon(Stream)

Origem:
Icon.cs
Origem:
Icon.cs
Origem:
Icon.cs

Inicializa uma nova instância da classe Icon do fluxo de dados especificado.

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)

Parâmetros

stream
Stream

O fluxo de dados do qual carregar o Icon.

Exceções

O parâmetro stream é null.

Comentários

Um recurso de ícone pode conter várias imagens de ícone. Um arquivo de ícone pode conter imagens em vários tamanhos e profundidades de cor. A imagem usada em um aplicativo depende do sistema operacional e das configurações. A lista a seguir detalha os tamanhos típicos de um ícone:

  • 16 pixels x 16 pixels

  • 32 pixels x 32 pixels

  • 48 pixels x 48 pixels

Esse construtor retorna a menor imagem contida no fluxo especificado.

Aplica-se a

Icon(String)

Origem:
Icon.cs
Origem:
Icon.cs
Origem:
Icon.cs

Inicializa uma nova instância da classe Icon do nome do arquivo especificado.

public:
 Icon(System::String ^ fileName);
public Icon (string fileName);
new System.Drawing.Icon : string -> System.Drawing.Icon
Public Sub New (fileName As String)

Parâmetros

fileName
String

O arquivo a ser carregado do Icon.

Comentários

Um recurso de ícone pode conter várias imagens de ícone. Um arquivo de ícone pode conter imagens em vários tamanhos e profundidades de cor. A imagem usada em um aplicativo depende do sistema operacional e das configurações. A lista a seguir detalha os tamanhos típicos de um ícone:

  • 16 pixels x 16 pixels

  • 32 pixels x 32 pixels

  • 48 pixels x 48 pixels

Esse construtor retorna a menor imagem contida no arquivo especificado.

Aplica-se a

Icon(Icon, Size)

Origem:
Icon.cs
Origem:
Icon.cs
Origem:
Icon.cs

Inicializa uma nova instância da classe Icon e tenta localizar uma versão do ícone que corresponde ao tamanho solicitado.

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)

Parâmetros

original
Icon

O Icon do qual carregar o ícone recém-dimensionado.

size
Size

A estrutura Size que especifica a altura e largura do novo Icon.

Exceções

O parâmetro original é null.

Comentários

Se não for possível encontrar uma versão que corresponda exatamente ao tamanho, a correspondência mais próxima será usada. Se o original parâmetro for um Icon que tem um único tamanho, esse método criará apenas um ícone duplicado. Use os recursos de alongamento do DrawImage método para redimensionar o ícone.

Aplica-se a

Icon(Stream, Size)

Origem:
Icon.cs
Origem:
Icon.cs
Origem:
Icon.cs

Inicializa uma nova instância da classe Icon do tamanho especificado do fluxo especificado.

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)

Parâmetros

stream
Stream

O fluxo que contém os dados do ícone.

size
Size

O tamanho desejado do ícone.

Exceções

A stream é null ou não contém dados de imagem.

Aplica-se a

Icon(String, Size)

Origem:
Icon.cs
Origem:
Icon.cs
Origem:
Icon.cs

Inicializa uma nova instância da classe Icon do tamanho especificado do arquivo especificado.

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)

Parâmetros

fileName
String

O nome e caminho do arquivo que contém os dados do ícone.

size
Size

O tamanho desejado do ícone.

Exceções

A string é null ou não contém dados de imagem.

Comentários

Se o arquivo especificado não contiver uma imagem que corresponda ao tamanho desejado, o ícone que tem o tamanho mais próximo será retornado.

O fileName deverá incluir o caminho completo se ele não estiver no diretório do aplicativo atual.

Aplica-se a

Icon(Type, String)

Origem:
Icon.cs
Origem:
Icon.cs
Origem:
Icon.cs

Inicializa uma nova instância da classe Icon de um recurso no assembly especificado.

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)

Parâmetros

type
Type

Um Type que especifica o assembly no qual procurar o recurso.

resource
String

O nome do recurso a carregar.

Exceções

Um ícone especificado por resource não foi encontrado no assembly que contém o type especificado.

Exemplos

O exemplo de código a seguir demonstra como usar o Icon construtor . Para executar este exemplo, cole o código em um Windows Form e manipule o evento do Paint formulário. Chame o ConstructAnIconFromAType método do Paint manipulador de eventos, passando e como 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

Comentários

Esse construtor cria um Icon de um recurso com o nome especificado pelo resource parâmetro no assembly que contém o tipo especificado pelo type parâmetro .

Esse construtor combina o namespace do tipo fornecido junto com o nome da cadeia de caracteres do recurso e procura uma correspondência no manifesto do assembly. Por exemplo, você pode passar o Control tipo e Error.ico para esse construtor e ele procura um recurso chamado System.Windows.Forms.Error.ico.

Aplica-se a

Icon(Icon, Int32, Int32)

Origem:
Icon.cs
Origem:
Icon.cs
Origem:
Icon.cs

Inicializa uma nova instância da classe Icon e tenta localizar uma versão do ícone que corresponde ao tamanho solicitado.

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)

Parâmetros

original
Icon

O ícone do qual carregar o tamanho diferente.

width
Int32

A largura do novo ícone.

height
Int32

A altura do novo ícone.

Exceções

O parâmetro original é null.

Exemplos

O exemplo de código a seguir demonstra como usar o ToBitmap método . Este exemplo foi projetado para ser usado com Windows Forms. Create um formulário e cole o código a seguir nele. Chame o IconToBitmap método no manipulador de eventos do Paint formulário, passando e como 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

Comentários

Se não for possível encontrar uma versão que corresponda exatamente ao tamanho, a correspondência mais próxima será usada. Se o original parâmetro for um Icon que tem um único tamanho, esse método criará apenas um ícone duplicado. Use os recursos de alongamento do DrawImage método para redimensionar o ícone.

Aplica-se a

Icon(Stream, Int32, Int32)

Origem:
Icon.cs
Origem:
Icon.cs
Origem:
Icon.cs

Inicializa uma nova instância da classe Icon do fluxo de dados especificado e com a altura e largura especificadas.

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)

Parâmetros

stream
Stream

O fluxo de dados do qual carregar o ícone.

width
Int32

A largura, em pixels, do ícone.

height
Int32

A altura, em pixels, do ícone.

Exceções

O parâmetro stream é null.

Aplica-se a

Icon(String, Int32, Int32)

Origem:
Icon.cs
Origem:
Icon.cs
Origem:
Icon.cs

Inicializa uma nova instância da classe Icon com a largura e altura especificadas do arquivo especificado.

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)

Parâmetros

fileName
String

O nome e caminho do arquivo que contém os dados do Icon.

width
Int32

A largura desejada do Icon.

height
Int32

A altura desejada do Icon.

Exceções

A string é null ou não contém dados de imagem.

Comentários

Se o arquivo especificado não contiver uma imagem que corresponda à altura e largura desejadas, o ícone que tem o tamanho mais próximo será retornado.

O fileName deverá incluir o caminho completo se ele não estiver no diretório do aplicativo atual.

Aplica-se a