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 o 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.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
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.Runtime.InteropServices.ComVisible(false)>]
[<System.Serializable>]
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 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

Pode construir Icon objetos a partir de ficheiros, fluxos ou recursos incorporados. Para uma lista de construtores, veja Icon. Também pode converter an Icon para bitmap usando o ToBitmap método.

Note

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

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

Construtores

Name 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 Icon classe a partir do fluxo de dados especificado e com a largura e altura especificadas.

Icon(Stream, Size)

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

Icon(Stream)

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

Icon(String, Int32, Int32)

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

Icon(String, Size)

Inicializa uma nova instância da Icon classe com o tamanho especificado a partir do ficheiro especificado.

Icon(String)

Inicializa uma nova instância da Icon classe a partir do nome do ficheiro especificado.

Icon(Type, String)

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

Propriedades

Name Description
Handle

Percebe a Windows isto Icon. Isto não é uma cópia do nome; Não o libertes.

Height

Percebe o auge disto Icon.

Size

Percebe o tamanho disto Icon.

Width

Obtém a largura deste Icon.

Métodos

Name Description
Clone()

Clona o Icon, criando uma imagem duplicada.

CreateObjRef(Type)

Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto.

(Herdado de MarshalByRefObject)
Dispose()

Liberta todos os recursos utilizados por este Icon.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
ExtractAssociatedIcon(String)

Devolve uma representação de ícone de uma imagem contida no ficheiro especificado.

Finalize()

Permite que um objeto tente libertar recursos e realizar outras operações de limpeza antes de ser recuperado pela recolha de lixo.

FromHandle(IntPtr)

Cria um GDI+ Icon do handle de Windows especificado para um ícone (HICON).

GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso.

(Herdado de MarshalByRefObject)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InitializeLifetimeService()

Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(Herdado de MarshalByRefObject)
Save(Stream)

Guarda isto Icon na saída Streamespecificada .

ToBitmap()

Converte isto Icon num GDI+ Bitmap.

ToString()

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

Implementações de Interface Explícita

Name Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Preenche a SerializationInfo com os dados necessários para serializar o objeto alvo.

Aplica-se a

Ver também