Icon Klasa

Definicja

Reprezentuje ikonę systemu Windows, która jest małym obrazem mapy bitowej używanym do reprezentowania obiektu. Ikony można traktować jako przezroczyste mapy bitowe, chociaż ich rozmiar jest określany przez 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))]
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
Dziedziczenie
Atrybuty
Implementuje

Przykłady

W poniższym przykładzie kodu pokazano, jak używać ToBitmap metody . Ten przykład jest przeznaczony do użycia z Windows Forms. Utwórz formularz i wklej do niego następujący kod. Wywołaj metodę IconToBitmap w procedurze obsługi zdarzeń formularza Paint , przekazując e jako 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

Uwagi

Obiekty można tworzyć Icon na podstawie plików, strumieni lub zasobów osadzonych. Aby uzyskać listę konstruktorów, zobacz Icon. Możesz również przekonwertować Icon obiekt na mapę bitową przy użyciu ToBitmap metody .

Uwaga

W programie .NET 6 i nowszych wersjach pakiet System.Drawing.Common, który obejmuje ten typ, jest obsługiwany tylko w systemach operacyjnych Windows. Użycie tego typu w aplikacjach międzyplatformowych powoduje ostrzeżenia w czasie kompilacji i wyjątki czasu wykonywania. Aby uzyskać więcej informacji, zobacz System.Drawing.Common only supported on Windows (Obsługiwane tylko w systemie Windows).

Zasób ikony może zawierać wiele obrazów ikon. Jeden plik ikon może zawierać obrazy w kilku rozmiarach i głębokościach kolorów. Obraz używany w aplikacji zależy od systemu operacyjnego i ustawień. Poniższa lista zawiera szczegółowe informacje o typowych rozmiarach ikony:

  • 16 pikseli x 16 pikseli

  • 32 piksele x 32 piksele

  • 48 pikseli x 48 pikseli

Konstruktory

Icon(Icon, Int32, Int32)

Inicjuje Icon nowe wystąpienie klasy i próbuje znaleźć wersję ikony zgodnej z żądanym rozmiarem.

Icon(Icon, Size)

Inicjuje Icon nowe wystąpienie klasy i próbuje znaleźć wersję ikony zgodnej z żądanym rozmiarem.

Icon(Stream)

Inicjuje Icon nowe wystąpienie klasy z określonego strumienia danych.

Icon(Stream, Int32, Int32)

Inicjuje Icon nowe wystąpienie klasy z określonego strumienia danych oraz o określonej szerokości i wysokości.

Icon(Stream, Size)

Inicjuje nowe wystąpienie Icon klasy określonego rozmiaru z określonego strumienia.

Icon(String)

Inicjuje Icon nowe wystąpienie klasy z określonej nazwy pliku.

Icon(String, Int32, Int32)

Inicjuje Icon nowe wystąpienie klasy o określonej szerokości i wysokości z określonego pliku.

Icon(String, Size)

Inicjuje nowe wystąpienie Icon klasy określonego rozmiaru z określonego pliku.

Icon(Type, String)

Inicjuje Icon nowe wystąpienie klasy z zasobu w określonym zestawie.

Właściwości

Handle

Pobiera dojście systemu Windows dla tego Iconpliku . To nie jest kopia dojścia; nie zwalniaj go.

Height

Pobiera wysokość tego Iconobiektu .

Size

Pobiera rozmiar tego Iconelementu .

Width

Pobiera szerokość tego obiektu Icon.

Metody

Clone()

Klonuje element Icon, tworząc zduplikowany obraz.

CreateObjRef(Type)

Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym.

(Odziedziczone po MarshalByRefObject)
Dispose()

Zwalnia wszystkie zasoby używane przez ten Iconprogram .

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
ExtractAssociatedIcon(String)

Zwraca reprezentację ikony obrazu zawartego w określonym pliku.

ExtractIcon(String, Int32, Boolean)

Wyodrębnia określoną ikonę z danego filePathelementu .

ExtractIcon(String, Int32, Int32)

Wyodrębnia określoną ikonę z danego filePathelementu .

Finalize()

Umożliwia obiektowi próbę zwolnienia zasobów i wykonania innych operacji oczyszczania przed odzyskaniem przez odzyskiwanie pamięci.

FromHandle(IntPtr)

Tworzy GDI+ Icon z określonego dojścia systemu Windows do ikony (HICON).

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetLifetimeService()
Przestarzałe.

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.

(Odziedziczone po MarshalByRefObject)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
InitializeLifetimeService()
Przestarzałe.

Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu.

(Odziedziczone po MarshalByRefObject)
Save(Stream)

Zapisuje to Icon w określonych danych wyjściowych Stream.

ToBitmap()

Konwertuje to Icon na GDI+ Bitmap.

ToString()

Pobiera czytelny dla człowieka ciąg opisujący element Icon.

Jawne implementacje interfejsu

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Wypełnia element SerializationInfo danymi wymaganymi do serializacji obiektu docelowego.

Dotyczy

Zobacz też