Partager via


CImageList::Create

Initialise une liste d'images et la attaché à un objet de CImageList, classe .

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  
);

Paramètres

  • cx
    Dimensions de chaque image, en pixels.

  • cy
    Dimensions de chaque image, en pixels.

  • nFlags
    Spécifie le type de liste d'images à créer. Ce paramètre peut être une combinaison de valeurs suivantes, mais il peut inclure un seul des valeurs d' ILC_COLOR .

    Valeur

    Signification

    ILC_COLOR

    Utilisez le comportement par défaut si aucun de l'autre ILC_COLOR* des balises est spécifié. En général, la valeur par défaut est ILC_COLOR4; mais pour les pilotes d'affichage plus anciens, la valeur par défaut est ILC_COLORDDB.

    ILC_COLOR4

    Utilisez une section de (DIB) .dib de 4 bits couleur (16) en tant que bitmap pour la liste d'images.

    ILC_COLOR8

    Utilisez une section de 8 bits de la bitmap indépendante du périphérique. Les couleurs utilisées pour la table des couleurs sont les mêmes couleurs de la palette de demi-teintes.

    ILC_COLOR16

    Utilisez (couleur 32/64k) une section 16 bits de la bitmap indépendante du périphérique.

    ILC_COLOR24

    Utilisez une section 24 bits de la bitmap indépendante du périphérique.

    ILC_COLOR32

    Utilisez une section de 32 bits de la bitmap indépendante du périphérique.

    ILC_COLORDDB

    Utilisez une bitmap du périphérique.

    ILC_MASK

    Utilise un masque. La liste d'images contient deux bitmap, l'une est une bitmap de monochrome utilisée comme masque. Si cette valeur n'est pas incluse, la liste d'images contient uniquement une bitmap. Consultez images de dessin d'une liste d'images pour plus d'informations sur les images masquées.

  • nInitial
    Nombre d'images de la liste d'images contient initialement.

  • nGrow
    Nombre d'images par lesquelles la liste d'images peut développer lorsque le système doit redimensionner la liste pour faire de la place pour les nouvelles images. Ce paramètre indique le nombre de nouvelles images de la liste d'images redimensionné peut contenir.

  • nBitmapID
    ID de ressource de la bitmap à associer à la liste d'images.

  • crMask
    Couleur utilisée pour générer un masque. Chaque pixel de cette couleur dans la bitmap spécifiée est modifié pour noircir, et le bit correspondant dans le masque est placé à un.

  • lpszBitmapID
    Chaîne contenant les identificateurs de ressource des images.

  • imagelist1
    Référence à un objet CImageList.

  • nImage1
    Index de la première image existante.

  • imagelist2
    Référence à un objet CImageList.

  • nImage2
    Index de la deuxième image existante.

  • dx
    Offset de l'axe x de la deuxième image dans la relation à la première image, en pixels.

  • dy
    Offset de l'axe Y de la deuxième image dans la relation à la première image, en pixels.

  • pImageList
    Un pointeur vers un objet d' CImageList .

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon 0.

Notes

Vous construisez CImageList en deux étapes. D'abord, appelez le constructeur puis appelez Create, qui crée la liste d'images et la attaché à l'objet d' CImageList.

Exemple

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

Configuration requise

en-tête : afxcmn.h

Voir aussi

Référence

CImageList, classe

Graphique de la hiérarchie

CImageList::CImageList

COLORREF

images de dessin d'une liste d'images