Freigeben über


CImageList::Create

Initialisiert eine Bildliste und fügt sie zu einem CImageList-Klasse-Objekt.

BOOL Create(
   int cx,
   int cy,
   UINT nFlags,
   int nInitial,
   int nGrow 
);
BOOL Create(
   UINT nBitmapID,
   int cx,
   int nGrow,
   COLORREF crMask 
);
BOOL Create(
   LPCTSTR lpszBitmapID,
   int cx,
   int nGrow,
   COLORREF crMask 
);
BOOL Create(
   CImageList& imagelist1,
   int nImage1,
   CImageList& imagelist2,
   int nImage2,
   int dx,
   int dy 
);
BOOL Create(
   CImageList* pImageList 
);

Parameter

  • cx
    Dimensionen jedes Bilder, in Pixel.

  • cy
    Dimensionen jedes Bilder, in Pixel.

  • nFlags
    Gibt den Typ der Bildliste an, um zu erstellen.Dieser Parameter kann eine Kombination der folgenden Werte sein, aber er kann nur eine der ILC_COLOR-Werte enthalten.

    Wert

    Bedeutung

    ILC_COLOR

    Verwenden Sie das Standardverhalten wenn keine anderen ILC_COLOR* Flags angegeben wird.In der Regel ist die Standardeinstellung ILC_COLOR4; jedoch für ältere Anzeigentreiber, ist der Standardwert ILC_COLORDDB.

    ILC_COLOR4

    Verwenden Sie einen Abschnitt der geräteunabhängigen Bitmaps des 4-Bits Farbe (16) (DIBs) als Bitmap für die Bildliste.

    ILC_COLOR8

    Verwenden Sie einen Abschnitt des 8-Bits DIB.Die Farben, die für die Farbtabelle verwendet werden, sind die gleichen wie die Farben Halbtonpalette.

    ILC_COLOR16

    Verwenden Sie einen Abschnitt des 16-Bits (32/64k Farbe DIBs).

    ILC_COLOR24

    Verwenden Sie einen Abschnitt des 24-Bits DIB.

    ILC_COLOR32

    Verwenden Sie einen Abschnitt des 32-Bits DIB.

    ILC_COLORDDB

    Verwenden Sie eine Bitmap geräteabhängige.

    ILC_MASK

    Verwendet eine Maske.Die Bildliste enthält zwei Bitmaps, von denen eine monochrome ist eine Bitmap, die als Maske verwendet wird.Wenn dieser Wert nicht eingeschlossen ist, enthält die Bildliste nur eine Bitmap.Siehe Zeichnungs-Images aus einer Bildliste für zusätzliche Informationen über maskierte Bilder.

  • nInitial
    Zahl, die die Bildliste Bilder zuerst enthält.

  • nGrow
    Zahl Bilder, durch die die Bildliste wachsen kann, wenn das System die Größe der Liste ändern muss, um für neue Bilder Platz zu schaffen.Dieser Parameter stellt die Anzahl von neuen Bilder dar, die die Größe geänderte Bildliste enthalten kann.

  • nBitmapID
    Ressourcen-IDs der mit der Bildliste zugeordnet werden, Bitmaps.

  • crMask
    Farbe verwendet wird, um eine Maske zu generieren.Jedes Pixel dieser Farbe in der angegebenen Bitmap wird geändert, um zu überwachen, und das entsprechende Bit in der Maske wird von eine festgelegt.

  • lpszBitmapID
    Eine Zeichenfolge, die die Ressourcen-IDs der Bilder enthält.

  • imagelist1
    Ein Verweis auf ein CImageList-Objekt.

  • nImage1
    Index des ersten Bildes.

  • imagelist2
    Ein Verweis auf ein CImageList-Objekt.

  • nImage2
    Index des zweiten Bildes.

  • dx
    Offset der X-Achse des zweiten Bilder in der Beziehung zum ersten Bild, in Pixel.

  • dy
    Offset der y-Achse des zweiten Bilder in der Beziehung zum ersten Bild, in Pixel.

  • pImageList
    Ein Zeiger auf ein Objekt CImageList.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; 0 andernfalls.

Hinweise

Sie erstellen CImageList in zwei Schritten.Zuerst rufen Sie den Konstruktor auf und dann Create auf, der die Bildliste erstellt und an den CImageList-Objekt angefügt werden.

Beispiel

m_myImageList.Create(32, 32, ILC_COLOR8, 0, 4);

Anforderungen

Header: afxcmn.h

Siehe auch

Referenz

CImageList-Klasse

Hierarchien-Diagramm

CImageList::CImageList

COLORREF

Zeichnungs-Images aus einer Bildliste