Icon Construtores

Referência

Definição

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Pacote:: System.Drawing.Common v6.0.0

Pacote:: System.Drawing.Common v7.0.0

Pacote:: System.Drawing.Common v8.0.0

Pacote:: System.Drawing.Common v9.0.0-preview.2.24128.3

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

ArgumentException

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

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

ArgumentException

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

ArgumentException

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

ArgumentException

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

ArgumentException

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

ArgumentException

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

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

ArgumentException

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

ArgumentException

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

Icon Construtores

Definição

Sobrecargas

Icon(Stream)

Parâmetros

Exceções

Comentários

Aplica-se a

Icon(String)

Parâmetros

Comentários

Aplica-se a

Icon(Icon, Size)

Parâmetros

Exceções

Comentários

Aplica-se a

Icon(Stream, Size)

Parâmetros

Exceções

Aplica-se a

Icon(String, Size)

Parâmetros

Exceções

Comentários

Aplica-se a

Icon(Type, String)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

Icon(Icon, Int32, Int32)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

Icon(Stream, Int32, Int32)

Parâmetros

Exceções

Aplica-se a

Icon(String, Int32, Int32)

Parâmetros

Exceções

Comentários

Aplica-se a

Comentários

Recursos adicionais