Klasse CDragListBox

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Naast het bieden van de functionaliteit van een Windows-keuzelijst, kan de gebruiker met de CDragListBox klasse keuzelijstitems, zoals bestandsnamen, in de keuzelijst verplaatsen.

Syntaxis

class CDragListBox : public CListBox

Leden

Openbare constructors

Naam	Description
CDragListBox::CDragListBox	Maakt een CDragListBox object.

Openbare methoden

Naam	Description
CDragListBox::BeginDrag	Aangeroepen door het framework wanneer een sleepbewerking wordt gestart.
CDragListBox::CancelDrag	Aangeroepen door het framework wanneer een sleepbewerking is geannuleerd.
CDragListBox::D ragging	Aangeroepen door het framework tijdens een sleepbewerking.
CDragListBox::D rawInsert	Hiermee tekent u de invoeghulplijn van de keuzelijst voor slepen.
CDragListBox::D ropped	Aangeroepen door het framework nadat het item is verwijderd.
CDragListBox::ItemFromPt	Retourneert de coördinaten van het item dat wordt gesleept.

Opmerkingen

Met keuzelijsten met deze mogelijkheid kunnen gebruikers de items in een lijst op de gewenste manier bestellen. Standaard verplaatst de keuzelijst het item naar de nieuwe locatie in de lijst. CDragListBox Objecten kunnen echter worden aangepast om items te kopiëren in plaats van ze te verplaatsen.

Het besturingselement voor keuzelijsten dat aan de CDragListBox klasse is gekoppeld, mag niet de LBS_SORT of de stijl LBS_MULTIPLESELECT hebben. Zie List-Box Stijlen voor een beschrijving van keuzelijsten.

Als u een keuzelijst met slepen wilt gebruiken in een bestaand dialoogvenster van uw toepassing, voegt u een keuzelijstbesturingselement toe aan de dialoogvenstersjabloon met behulp van de dialoogvenstereditor en wijst u vervolgens een lidvariabele (van categorie Control en type variabele CDragListBox) toe die overeenkomt met het keuzelijstbesturingselement in uw dialoogvenstersjabloon.

Zie Snelkoppeling voor het definiëren van lidvariabelen voor dialoogvensterbesturingselementen voor meer informatie over het toewijzen van besturingselementen aan ledenvariabelen.

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CListBox

CDragListBox

Requirements

Koptekst: afxcmn.h

CDragListBox::BeginDrag

Aangeroepen door het framework wanneer een gebeurtenis optreedt die een sleepbewerking kan starten, zoals het drukken op de linkermuisknop.

virtual BOOL BeginDrag(CPoint pt);

Parameterwaarden

Pt
Een CPoint-object dat de coördinaten bevat van het item dat wordt gesleept.

Retourwaarde

Nonzero als slepen is toegestaan, anders 0.

Opmerkingen

Overschrijf deze functie als u wilt bepalen wat er gebeurt wanneer een sleepbewerking begint. De standaard implementatie legt de muis vast en blijft in de sleepmodus totdat de gebruiker op de linker- of rechtermuisknop klikt of op Esc drukt, op welk moment de sleepbewerking wordt geannuleerd.

CDragListBox::CancelDrag

Aangeroepen door het framework wanneer een sleepbewerking is geannuleerd.

virtual void CancelDrag(CPoint pt);

Parameterwaarden

Pt
Een CPoint-object dat de coördinaten bevat van het item dat wordt gesleept.

Opmerkingen

Overschrijf deze functie om eventuele speciale verwerkingen voor het besturingselement keuzelijst af te handelen.

CDragListBox::CDragListBox

Maakt een CDragListBox object.

CDragListBox();

CDragListBox::D ragging

Aangeroepen door het framework wanneer een keuzelijstitem wordt gesleept binnen het CDragListBox object.

virtual UINT Dragging(CPoint pt);

Parameterwaarden

Pt
Een CPoint-object met de coördinaten van het x- en y-scherm van de cursor.

Retourwaarde

De resource-id van de cursor die moet worden weergegeven. De volgende waarden zijn mogelijk:

• DL_COPYCURSOR Geeft aan dat het item wordt gekopieerd.

• DL_MOVECURSOR Geeft aan dat het item wordt verplaatst.

• DL_STOPCURSOR Geeft aan dat het huidige dalingsdoel niet acceptabel is.

Opmerkingen

Het standaardgedrag retourneert DL_MOVECURSOR. Overschrijf deze functie als u extra functionaliteit wilt bieden.

CDragListBox::D rawInsert

Wordt aangeroepen door het framework om de invoeghulplijn te tekenen vóór het item met de aangegeven index.

virtual void DrawInsert(int nItem);

Parameterwaarden

nItem
Op nul gebaseerde index van de invoegpositie.

Opmerkingen

Een waarde van - 1 wist de invoeghulplijn. Overschrijf deze functie om het uiterlijk of gedrag van de invoeghulplijn te wijzigen.

CDragListBox::D ropped

Aangeroepen door het framework wanneer een item binnen een CDragListBox object wordt verwijderd.

virtual void Dropped(
    int nSrcIndex,
    CPoint pt);

Parameterwaarden

nSrcIndex
Hiermee geeft u de op nul gebaseerde index van de verwijderde tekenreeks op.

Pt
Een CPoint-object dat de coördinaten van de drop-site bevat.

Opmerkingen

Het standaardgedrag kopieert het keuzelijstitem en de bijbehorende gegevens naar de nieuwe locatie en verwijdert vervolgens het oorspronkelijke item. Overschrijf deze functie om het standaardgedrag aan te passen, zoals het inschakelen van kopieën van keuzelijstitems naar andere locaties in de lijst.

CDragListBox::ItemFromPt

Roep deze functie aan om de op nul gebaseerde index van het keuzelijstitem op te halen dat zich op pt bevindt.

int ItemFromPt(
    CPoint pt,
    BOOL bAutoScroll = TRUE) const;

Parameterwaarden

Pt
Een CPoint-object met de coördinaten van een punt in de keuzelijst.

bAutoScroll
Niet-nul als schuiven is toegestaan, anders 0.

Retourwaarde

Op nul gebaseerde index van het keuzelijstitem slepen.

Zie ook

MFC-voorbeeld TSTCON
CListBox-klasse
Hiërarchiegrafiek
CListBox-klasse