CImageList-Klasse

Artikel
02/26/2013

Stellt die Funktionalität des allgemeinen Bildlistensteuerelements Windows bereit.

class CImageList : public CObject

Mitglieder

Öffentliche Konstruktoren

Name	Description
CImageList::CImageList	Erstellt ein CImageList-Objekt.

Öffentliche Methoden

Name	Description
CImageList::Add	Fügt ein Bild oder einer Bildliste Bilder hinzu.
CImageList::Attach	Fügt eine Bildliste zu einem CImageList-Objekt bei.
CImageList::BeginDrag	Startet, ein Bild zu ziehen.
CImageList::Copy	Kopiert ein Bild innerhalb eines CImageList-Objekts.
CImageList::Create	Initialisiert eine Bildliste und fügt sie zu einem CImageList-Objekt.
CImageList::DeleteImageList	Löscht eine Bildliste.
CImageList::DeleteTempMap	Aufgerufen durch den CWinApp Leerlaufhandler, entweder CImageList temporäres Objekt gelöscht erstellt durch FromHandle.
CImageList::Detach	Trennt ein Bildlistenobjekt von einem CImageList-Objekt und gibt ein Handle einer Bildliste zurück.
CImageList::DragEnter	Sperrenupdates während eines Ziehvorgangs und das Anzeigen der Ziehbild an einer angegebenen Position.
CImageList::DragLeave	Entsperrt das und blendet das Ziehbild aus, damit das Fenster aktualisiert werden kann.
CImageList::DragMove	Verschiebt das Bild, das während eines Drag & Drop-Vorgangs gezogen wird.
CImageList::DragShowNolock	In oder aus das Ziehbild während eines Ziehvorgangs, ohne das Fenster zu sperren.
CImageList::Draw	Zeichnet das Bild, das während eines Drag & Drop-Vorgangs gezogen wird.
CImageList::DrawEx	Zeichnet ein Bildlistenelement im angegebenen Gerätekontext.Die Funktion verwendet das angegebene Zeichnungsformat und mischt das Bild mit der angegebenen Farbe.
CImageList::DrawIndirect	Zeichnet ein Bild aus einer Bildliste.
CImageList::EndDrag	Beendet einen Ziehvorgang.
CImageList::ExtractIcon	Erstellt ein Symbol auf einem Bild und Maske in einer Bildliste.
CImageList::FromHandle	Gibt einen Zeiger auf ein Objekt CImageList zurück, wenn Sie ein Handle einer Bildliste angegeben werden.Wenn ein CImageList-Objekt nicht in Anspruch angefügt wird, wird ein temporäres Objekt erstellt und CImageList angefügt.
CImageList::FromHandlePermanent	Gibt einen Zeiger auf ein Objekt CImageList zurück, wenn Sie ein Handle einer Bildliste angegeben werden.Wenn ein CImageList-Objekt nicht in Anspruch angefügt wird, wird NULL zurückgegeben.
CImageList::GetBkColor	Ruft die aktuelle Hintergrundfarbe für eine Bildliste ab.
CImageList::GetDragImage	Ruft die temporäre Bildliste ab, die für das Ziehen verwendet wird.
CImageList::GetImageCount	Ruft die Anzahl von Bildern in einer Bildliste ab.
CImageList::GetImageInfo	Ruft Informationen über ein Bild ab.
CImageList::GetSafeHandle	Ruft m_hImageList ab.
CImageList::Read	Liest eine Bildliste aus einem Archiv.
CImageList::Remove	Entfernt ein Bild aus einer Bildliste.
CImageList::Replace	Ersetzt ein Bild in einer Bildliste durch ein neues Bild.
CImageList::SetBkColor	Legt die Hintergrundfarbe für eine Bildliste fest.
CImageList::SetDragCursorImage	Erstellt ein neues Ziehbild.
CImageList::SetImageCount	Setzt die Anzahl von Bildern in einer Bildliste zurück.
CImageList::SetOverlayImage	Fügt den nullbasierten Index eines Bilds der Liste der als hinzu Overlaymasken verwendet werden Bilder.
CImageList::Write	Schreibt eine Bildliste zu einem Archiv.

Öffentliche Operatoren

Name	Description
CImageList::operator HIMAGELIST	Gibt HIMAGELIST zurück, das in CImageList angefügt wird.

Öffentliche Datenmember

Name	Description
CImageList::m_hImageList	Ein Handle, das die Bildliste angefügt auf dieses Objekt enthält.

Hinweise

Eine "Bildliste" ist eine Auflistung gleich-groß Bilder, von denen jedes über seinen nullbasierten Index verwiesen werden kann.Bildlisten werden verwendet, um große Mengen von Symbole oder Bitmaps effizient zu verwalten.Alle Bilder in einer Bildliste werden in einer einzelnen, Anordnen Bitmap im Bildschirmgerätenformat enthalten.Eine Bildliste enthält möglicherweise auch eine monochrome Bitmap, die die Masken enthält, die verwendet werden, um Bildes transparent zu zeichnen (Symbolformat).Die Microsoft Win32-Fensters Anwendungsprogrammierschnittstelle (API) stellt Bildlistenfunktionen, die es Ihnen ermöglichen, Bildern zu zeichnen, Bildlisten zu erstellen und zu zerstören, Bilder hinzufügen und entfernen, ersetzen Bilder, Zusammenführungsimages und Ziehbilder.

Dieses Steuerelement (und daher die CImageList-Klasse) ist nur für - Programmen verfügbar, die unter Windows 95/98- und Windows NT 3,51 und höher ausgeführt werden.

Weitere Informationen zur Verwendung von CImageList, finden Sie unter Steuerelemente und Verwenden von CImageList.