Share via


Afbeeldingslijsten van structuurbesturingselement

Aan elk item in een structuurbesturingselement (CTreeCtrl) kunnen twee afbeeldingen met bitmaps worden gekoppeld. De afbeeldingen worden links van het label van een item weergegeven. De ene afbeelding wordt weergegeven wanneer het item is geselecteerd en de andere wordt weergegeven wanneer het item niet is geselecteerd. Een item kan bijvoorbeeld een geopende map weergeven wanneer deze is geselecteerd en een gesloten map wanneer het niet is geselecteerd.

Als u itemafbeeldingen wilt gebruiken, moet u een lijst met afbeeldingen maken door een CImageList-object te maken en de functie CImageList::Create te gebruiken om de bijbehorende lijst met afbeeldingen te maken. Voeg vervolgens de gewenste bitmaps toe aan de lijst en koppel de lijst aan het structuurbesturingselement met behulp van de functie SetImageList-lid . Standaard geven alle items de eerste afbeelding weer in de lijst met afbeeldingen voor zowel de geselecteerde als niet-geselecteerde statussen. U kunt het standaardgedrag voor een bepaald item wijzigen door de indexen van de geselecteerde en niet-geselecteerde afbeeldingen op te geven bij het toevoegen van het item aan het structuurbesturingselement met behulp van de functie InsertItem-lid . U kunt de indexen wijzigen nadat u een item hebt toegevoegd met behulp van de functie SetItemImage-lid .

De afbeeldingslijsten van een boomstructuur kunnen ook overlayafbeeldingen bevatten, die zijn ontworpen om te worden geplaatst over itemafbeeldingen. Een niet-nulwaarde in bits 8 tot en met 11 van de status van een structuurbeheeritem geeft de op één gebaseerde index van een overlay-afbeelding aan (0 geeft geen overlay-afbeelding aan). Omdat een 4-bits, op één gebaseerde index wordt gebruikt, moeten overlay-afbeeldingen onder de eerste 15 afbeeldingen in de afbeeldingslijsten zijn. Zie Overzicht van statussen van structuurbeheeritems eerder in dit onderwerp voor meer informatie over statussen van structuurbeheeritems.

Als er een lijst met statusafbeeldingen is opgegeven, behoudt een structuurbesturingselement ruimte links van het pictogram van elk item voor een statusafbeelding. Een toepassing kan statusafbeeldingen, zoals ingeschakelde en uitgeschakelde selectievakjes, gebruiken om door de toepassing gedefinieerde itemstatussen aan te geven. Een niet-nulwaarde in bits 12 tot en met 15 geeft de op één gebaseerde index van een statusafbeelding aan (0 geeft geen statusafbeelding aan).

Door de I_IMAGECALLBACK waarde op te geven in plaats van de index van een afbeelding, kunt u het opgeven van de geselecteerde of niet-geselecteerde afbeelding vertragen totdat het item op het punt staat opnieuw te worden getekend. I_IMAGECALLBACK stuurt het structuurbesturingselement om een query uit te voeren op de toepassing voor de index door het TVN_GETDISPINFO meldingsbericht te verzenden.

Met de functie GetImageList wordt de handle van de afbeeldingenlijst van een boomweergave opgehaald. Deze functie is handig als u meer afbeeldingen aan de lijst wilt toevoegen. Zie CImageList, CImageList gebruiken in de MFC-verwijzing en afbeeldingslijsten in de Windows SDK voor meer informatie over afbeeldingslijsten.

Zie ook

CTreeCtrl gebruiken
Besturingselementen