Icon Construtores

Definição

Espaço de Nomes:: System.Drawing

Assemblagem:: System.Drawing.Common.dll

Assemblagem:: System.Drawing.dll

Pacote:: System.Drawing.Common v11.0.0-preview.4.26230.115

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da Icon classe.

Sobrecargas

Name	Description
Icon(Stream)	Inicializa uma nova instância da Icon classe a partir do fluxo de dados especificado.
Icon(String)	Inicializa uma nova instância da Icon classe a partir do nome do ficheiro especificado.
Icon(Icon, Size)	Inicializa uma nova instância da Icon classe e tenta encontrar uma versão do ícone que corresponda ao tamanho solicitado.
Icon(Stream, Size)	Inicializa uma nova instância da Icon classe de tamanho especificado a partir do fluxo especificado.
Icon(String, Size)	Inicializa uma nova instância da Icon classe com o tamanho especificado a partir do ficheiro especificado.
Icon(Type, String)	Inicializa uma nova instância da Icon classe a partir de um recurso na assembly especificada.
Icon(Icon, Int32, Int32)	Inicializa uma nova instância da Icon classe e tenta encontrar uma versão do ícone que corresponda ao tamanho solicitado.
Icon(Stream, Int32, Int32)	Inicializa uma nova instância da Icon classe a partir do fluxo de dados especificado e com a largura e altura especificadas.
Icon(String, Int32, Int32)	Inicializa uma nova instância da Icon classe com a largura e altura especificadas a partir do ficheiro especificado.

Icon(Stream)

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Inicializa uma nova instância da Icon classe a partir 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 a partir do qual se deve carregar o Icon.

Exceções

ArgumentException

O stream parâmetro é null.

Observações

Um recurso de ícones pode conter múltiplas imagens de ícones. Um ficheiro de ícones pode conter imagens de vários tamanhos e profundidades de cor. A imagem utilizada numa aplicação depende do sistema operativo e das definições. A lista seguinte detalha os tamanhos típicos de um ícone:

16 píxeis x 16 píxeis
32 píxeis x 32 píxeis
48 píxeis x 48 píxeis

Este construtor devolve a menor imagem contida no fluxo especificado.

Aplica-se a

Icon(String)

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Inicializa uma nova instância da Icon classe a partir do nome do ficheiro 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 ficheiro para carregar o Icon de.

Observações

16 píxeis x 16 píxeis
32 píxeis x 32 píxeis
48 píxeis x 48 píxeis

Este construtor devolve a menor imagem contida no ficheiro especificado.

Aplica-se a

Icon(Icon, Size)

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Inicializa uma nova instância da Icon classe e tenta encontrar uma versão do ícone que corresponda 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

De onde Icon carregar o ícone de novo tamanho.

size: Size

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

Exceções

ArgumentException

O original parâmetro é null.

Observações

Se não for possível encontrar uma versão que corresponda exatamente ao tamanho, usa-se a correspondência mais próxima. Se o original parâmetro for um Icon que tenha um único tamanho, este método apenas cria um ícone duplicado. Use as capacidades 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

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Inicializa uma nova instância da Icon classe de tamanho especificado a partir 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

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

Aplica-se a

Icon(String, Size)

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Inicializa uma nova instância da Icon classe com o tamanho especificado a partir do ficheiro 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 o caminho para o ficheiro que contém os dados do ícone.

size: Size

O tamanho desejado do ícone.

Exceções

ArgumentException

O fileName contém null ou não contém dados de imagem.

Observações

Se o ficheiro especificado não contiver uma imagem que corresponda ao tamanho desejado, o ícone com o tamanho mais próximo é devolvido.

Devem fileName incluir o caminho completo se não estiver no diretório atual da aplicação.

Aplica-se a

Icon(Type, String)

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Inicializa uma nova instância da Icon classe a partir de um recurso na assembly especificada.

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

A Type que especifica o conjunto onde procurar o recurso.

resource: String

O nome do recurso a carregar.

Exceções

ArgumentException

Um ícone especificado por resource não pode ser encontrado no conjunto que contenha o .type

Exemplos

O exemplo de código seguinte demonstra como usar o Icon construtor. Para executar este exemplo, cole o código num formulário Windows e trate do evento Paint do formulário. Chame o ConstructAnIconFromAType método a partir do Paint tratador 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

Observações

Este construtor cria um Icon a partir de um recurso com o nome especificado pelo resource parâmetro na montagem que contém o tipo especificado pelo type parâmetro.

Este construtor combina o namespace do tipo dado com o nome da cadeia do recurso e procura uma correspondência no manifesto assembly. Por exemplo, podes passar o tipo Control e Error.ico a este 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

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Inicializa uma nova instância da Icon classe e tenta encontrar uma versão do ícone que corresponda 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 para carregar o tamanho diferente.

width: Int32

A largura do novo ícone.

height: Int32

A altura do novo ícone.

Exceções

ArgumentException

O original parâmetro é null.

Exemplos

O exemplo de código seguinte demonstra como usar o ToBitmap método. Este exemplo foi concebido para ser usado com Windows Forms. Crie um formulário e cole o código seguinte nele. Chame o IconToBitmap método no gestor 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

Observações

Aplica-se a

Icon(Stream, Int32, Int32)

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Inicializa uma nova instância da Icon classe a partir do fluxo de dados especificado e com a largura e altura 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 a partir do qual carregar o ícone.

width: Int32

A largura, em píxeis, do ícone.

height: Int32

A altura, em pixels, do ícone.

Exceções

ArgumentException

O stream parâmetro é null.

Aplica-se a

Icon(String, Int32, Int32)

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Origem:: Icon.cs

Inicializa uma nova instância da Icon classe com a largura e altura especificadas a partir do ficheiro 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 o caminho para o ficheiro que contém os Icon dados.

width: Int32

A largura desejada do Icon.

height: Int32

A altura desejada do Icon.

Exceções

ArgumentException

O fileName contém null ou não contém dados de imagem.

Observações

Se o ficheiro especificado não contiver uma imagem que corresponda à altura e largura desejadas, o ícone com o tamanho mais próximo é devolvido.

Devem fileName incluir o caminho completo se não estiver no diretório atual da aplicação.

Aplica-se a

Comentários

Esta página foi útil?