Icon Construtores
Definição
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
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
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
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
- 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
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.