Icon Classe

Definição

Representa um ícone do Windows, que é uma pequena imagem bitmap usada para representar um objeto.Represents a Windows icon, which is a small bitmap image that is used to represent an object. Os ícones podem ser considerados bitmaps transparentes, embora seu tamanho seja determinado pelo sistema.Icons can be thought of as transparent bitmaps, although their size is determined by the system.

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))]
[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
type Icon = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
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 método ToBitmap.The following code example demonstrates how to use the ToBitmap method. Este exemplo foi projetado para ser usado com Windows Forms.This example is designed to be used with Windows Forms. Crie um formulário e cole o código a seguir nele.Create a form and paste the following code into it. Chame o método IconToBitmap no manipulador de eventos Paint do formulário, passando e como PaintEventArgs.Call the IconToBitmap method in the form's Paint event handler, passing e as 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 por meio de arquivos, fluxos ou recursos incorporados.You can construct Icon objects from files, streams, or embedded resources. Para obter uma lista de construtores, consulte Icon.For a list of constructors, see Icon. Você também pode converter um Icon em um bitmap usando o método ToBitmap.You can also convert an Icon to a bitmap by using the ToBitmap method.

Um recurso de ícone pode conter várias imagens de ícone.An icon resource can contain multiple icon images. Um arquivo de ícone pode conter imagens em vários tamanhos e profundidades de cor.One icon file may contain images in several sizes and color depths. A imagem usada em um aplicativo depende do sistema operacional e das configurações.The image that is used in an application depends on the operating system and settings. A lista a seguir detalha os tamanhos típicos para um ícone:The following list details the typical sizes for an icon:

  • 16 pixels x 16 pixels16 pixels x 16 pixels

  • 32 pixels x 32 pixels32 pixels x 32 pixels

  • 48 pixels x 48 pixels48 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.Initializes a new instance of the Icon class and attempts to find a version of the icon that matches the requested size.

Icon(Icon, Size)

Inicializa uma nova instância da classe Icon e tenta localizar uma versão do ícone que corresponde ao tamanho solicitado.Initializes a new instance of the Icon class and attempts to find a version of the icon that matches the requested size.

Icon(Stream)

Inicializa uma nova instância da classe Icon do fluxo de dados especificado.Initializes a new instance of the Icon class from the specified data stream.

Icon(Stream, Int32, Int32)

Inicializa uma nova instância da classe Icon do fluxo de dados especificado e com a altura e largura especificadas.Initializes a new instance of the Icon class from the specified data stream and with the specified width and height.

Icon(Stream, Size)

Inicializa uma nova instância da classe Icon do tamanho especificado do fluxo especificado.Initializes a new instance of the Icon class of the specified size from the specified stream.

Icon(String)

Inicializa uma nova instância da classe Icon do nome do arquivo especificado.Initializes a new instance of the Icon class from the specified file name.

Icon(String, Int32, Int32)

Inicializa uma nova instância da classe Icon com a largura e altura especificadas do arquivo especificado.Initializes a new instance of the Icon class with the specified width and height from the specified file.

Icon(String, Size)

Inicializa uma nova instância da classe Icon do tamanho especificado do arquivo especificado.Initializes a new instance of the Icon class of the specified size from the specified file.

Icon(Type, String)

Inicializa uma nova instância da classe Icon de um recurso no assembly especificado.Initializes a new instance of the Icon class from a resource in the specified assembly.

Propriedades

Handle

Obtém o identificador do Windows para esse Icon.Gets the Windows handle for this Icon. Isso não é uma cópia do identificador, não a libere.This is not a copy of the handle; do not free it.

Height

Obtém a altura desse Icon.Gets the height of this Icon.

Size

Obtém o tamanho desse Icon.Gets the size of this Icon.

Width

Obtém a largura desse Icon.Gets the width of this Icon.

Métodos

Clone()

Clones o Icon, criando uma imagem duplicada.Clones the Icon, creating a duplicate image.

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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Herdado de MarshalByRefObject)
Dispose()

Libera todos os recursos usados por este Icon.Releases all resources used by this Icon.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
ExtractAssociatedIcon(String)

Retorna uma representação de ícone de uma imagem que está contida no arquivo especificado.Returns an icon representation of an image that is contained in the specified file.

Finalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes de ser recuperado pela coleta de lixo.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

FromHandle(IntPtr)

Cria um Icon GDI+ com base no identificador especificado do Windows para um ícone (HICON).Creates a GDI+ Icon from the specified Windows handle to an icon (HICON).

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Herdado de MarshalByRefObject)
Save(Stream)

Salva esse Icon na saída Stream especificada.Saves this Icon to the specified output Stream.

ToBitmap()

Converte este Icon em um Bitmap GDI+.Converts this Icon to a GDI+ Bitmap.

ToString()

Obtém uma cadeia de caracteres legível por humanos que descreve o Icon.Gets a human-readable string that describes the 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.Populates a SerializationInfo with the data that is required to serialize the target object.

Aplica-se a

Veja também