Język

Icon Klasa

Definicja

Reprezentuje ikonę 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
[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
Dziedziczenie
Atrybuty
Implementuje

Przykłady

W poniższym przykładzie kodu pokazano, jak używać ToBitmap metody . Ten przykład został zaprojektowany do użycia z formularzami systemu Windows. 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 z plików, strumieni lub zasobów osadzonych. Aby uzyskać listę konstruktorów, zobacz Icon. Możesz również przekonwertować Icon element na mapę bitową przy użyciu ToBitmap metody .

Note

W wersjach .NET 6 i nowszych pakiet System.Drawing.Common, który zawiera 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 supported only 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 o 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

Nazwa Opis
Icon(Icon, Int32, Int32)

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

Icon(Icon, Size)

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

Icon(Stream, Int32, Int32)

Inicjuje nowe wystąpienie Icon klasy z określonego strumienia danych i 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(Stream)

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

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

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

Icon(Type, String)

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

Właściwości

Nazwa Opis
Handle

Pobiera dojście Windows dla tego Icon. Nie jest to kopia uchwytu; nie zwalniaj go.

Height

Pobiera wysokość tego Iconelementu .

Size

Pobiera rozmiar tego elementu Icon.

Width

Pobiera szerokość tego elementu Icon.

Metody

Nazwa Opis
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 określony obiekt jest równy bieżącemu obiektowi.

(Odziedziczone po Object)
ExtractAssociatedIcon(String)

Zwraca ikonę reprezentacji 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 interfejs GDI+ Icon z określonego dojścia 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()

Pobiera Type 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 Object.

(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, który opisuje element Icon.

Jawne implementacje interfejsu

Nazwa Opis
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

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

Dotyczy

Zobacz też