Icon Classe

Definição

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

public ref class Icon sealed : 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
[System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))]
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))>]
[<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
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
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
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 o Windows Forms. Crie 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 a partir 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.

Note

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 cores. 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

Nome Description
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(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, Int32, Int32)

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

Icon(Stream, Size)

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

Icon(Stream)

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

Icon(String, Int32, Int32)

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

Icon(String, Size)

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

Icon(String)

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

Icon(Type, String)

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

Propriedades

Nome Description
Handle

Obtém o identificador de Windows deste Icon. Isso não é uma cópia do identificador; não liberá-lo.

Height

Obtém a altura deste Icon.

Size

Obtém o tamanho deste Icon.

Width

Obtém a largura deste Icon.

Métodos

Nome Description
Clone()

Clona a Iconimagem , 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 isso 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 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 GDI+ Icon do identificador de Windows especificado 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 tempo de vida para essa 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 dessa instância.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(Herdado de MarshalByRefObject)
Save(Stream)

Salva isso Icon na saída Streamespecificada.

ToBitmap()

Converte isso Icon em um GDI+ Bitmap.

ToString()

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

Implantações explícitas de interface

Nome Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

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

Aplica-se a

Confira também