Icon Classe

Definição

Representa um ícone do Windows, que é uma pequena imagem bitmap usada para representar um objeto. Os ícones podem ser considerados bitmaps transparentes, embora seu tamanho seja determinado pelo sistema.

public ref class Icon sealed : MarshalByRefObject, ICloneable, IDisposable, System::Runtime::Serialization::ISerializable
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter("System.Drawing.IconConverter, System.Windows.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51")]
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))]
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))]
[System.Serializable]
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(false)]
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
type Icon = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
[<System.ComponentModel.TypeConverter("System.Drawing.IconConverter, System.Windows.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51")>]
type Icon = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
type Icon = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
[<System.Serializable>]
type Icon = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(false)>]
type Icon = class
    inherit MarshalByRefObject
    interface ISerializable
    interface ICloneable
    interface IDisposable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
[<System.Serializable>]
type Icon = class
    inherit MarshalByRefObject
    interface ISerializable
    interface ICloneable
    interface IDisposable
Public NotInheritable Class Icon
Inherits MarshalByRefObject
Implements ICloneable, IDisposable, ISerializable
Herança
Atributos
Implementações

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

Você pode construir Icon objetos de arquivos, fluxos ou recursos inseridos. Para obter uma lista de construtores, consulte Icon. Você também pode converter um Icon em um bitmap usando o ToBitmap método .

Observação

No .NET 6 e versões posteriores, o pacote System.Drawing.Common, que inclui esse tipo, só tem suporte em sistemas operacionais Windows. O uso desse tipo em aplicativos multiplataforma causa avisos de tempo de compilação e exceções em tempo de execução. Para obter mais informações, consulte System.Drawing.Common com suporte apenas no Windows.

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

Construtores

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(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)

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

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(Stream, Size)

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

Icon(String)

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

Icon(String, Int32, Int32)

Inicializa uma nova instância da classe Icon com a largura e altura especificadas do arquivo 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.

Propriedades

Handle

Obtém o identificador do Windows para esse Icon. Isso não é uma cópia do identificador, não a libere.

Height

Obtém a altura desse Icon.

Size

Obtém o tamanho desse Icon.

Width

Obtém a largura desse Icon.

Métodos

Clone()

Clones o Icon, criando uma imagem duplicada.

CreateObjRef(Type)

Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto.

(Herdado de MarshalByRefObject)
Dispose()

Libera todos os recursos usados por este Icon.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
ExtractAssociatedIcon(String)

Retorna uma representação de ícone de uma imagem que está contida no arquivo especificado.

ExtractIcon(String, Int32, Boolean)

Extrai um ícone especificado do determinado filePath.

ExtractIcon(String, Int32, Int32)

Extrai um ícone especificado do determinado filePath.

Finalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes de ser recuperado pela coleta de lixo.

FromHandle(IntPtr)

Cria um Icon GDI+ com base no identificador especificado do Windows para um ícone (HICON).

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetLifetimeService()
Obsoleto.

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.

(Herdado de MarshalByRefObject)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InitializeLifetimeService()
Obsoleto.

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.

(Herdado de MarshalByRefObject)
Save(Stream)

Salva esse Icon na saída Stream especificada.

ToBitmap()

Converte este Icon em um Bitmap GDI+.

ToString()

Obtém uma cadeia de caracteres legível por humanos que descreve o Icon.

Implantações explícitas de interface

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Popula um SerializationInfo com os dados necessários para serializar o objeto de destino.

Aplica-se a

Confira também