Knop (Windows-besturingselementen)

Deze sectie bevat informatie over de programmeerelementen die worden gebruikt met knopbesturingselementen. Een knop is een besturingselement dat de gebruiker kan klikken om invoer voor een toepassing op te geven.

Overzichten

Onderwerp	Inhoud
knopberichten	In dit onderwerp worden berichten besproken die worden gebruikt met knoppen.
knopstatussen	In deze sectie wordt beschreven hoe het selecteren van een knop de status wijzigt en hoe de toepassing moet reageren.
knoptypen	In dit onderwerp worden de verschillende soorten knoppen besproken.
Knoppen gebruiken	In deze sectie wordt uitgelegd hoe u bepaalde taken uitvoert die zijn gekoppeld aan knoppen.

Functies

Onderwerp	Inhoud
CheckDlgButton-	Hiermee wijzigt u de controlestatus van een knop besturingselement.
CheckRadioButton-	Hiermee voegt u een vinkje toe aan (controles) een opgegeven keuzerondje in een groep en verwijdert u een vinkje uit (wist) alle andere keuzerondjes in de groep.
IsDlgButtonChecked	De functie IsDlgButtonChecked bepaalt of een knopbesturingselement met drie statussen is ingeschakeld, uitgeschakeld of onbepaald is.

Macro 's

Onderwerp	Inhoud
Button_Enable	Hiermee schakelt u een knop in of uit.
Button_GetCheck	Hiermee haalt u de controlestatus van een keuzerondje of selectievakje op. U kunt deze macro gebruiken of het BM_GETCHECK bericht expliciet verzenden.
Button_GetIdealSize	Hiermee wordt de grootte opgehaald van de knop die het beste past bij de tekst en afbeelding, als er een lijst met afbeeldingen aanwezig is. U kunt deze macro gebruiken of het BCM_GETIDEALSIZE bericht expliciet verzenden.
Button_GetImageList	Hiermee haalt u de BUTTON_IMAGELIST structuur op die de lijst met afbeeldingen beschrijft die is ingesteld voor een knopbesturing. U kunt deze macro gebruiken of het BCM_GETIMAGELIST bericht expliciet verzenden.
Button_GetNote	Hiermee haalt u de tekst op van de notitie die is gekoppeld aan een opdrachtkoppelingsknop. U kunt deze macro gebruiken of het BCM_GETNOTE bericht expliciet verzenden.
Button_GetNoteLength	Hiermee wordt de lengte opgehaald van de notitietekst die in de beschrijving voor een opdrachtkoppeling kan worden weergegeven. Gebruik deze macro of verzend het BCM_GETNOTELENGTH bericht expliciet.
Button_GetSplitInfo	Hiermee haalt u informatie op voor een opgegeven besturingselement voor gesplitste knoppen. Gebruik deze macro of verzend het BCM_GETSPLITINFO bericht expliciet.
Button_GetState	Hiermee haalt u de controlestatus van een keuzerondje of selectievakje op. U kunt deze macro gebruiken of het BM_GETSTATE bericht expliciet verzenden.
Button_GetText	Hiermee haalt u de tekst van een knop op.
Button_GetTextLength	Hiermee haalt u het aantal tekens op in de tekst van een knop.
Button_GetTextMargin	Hiermee haalt u de marges op die worden gebruikt om tekst te tekenen in een knop besturingselement. U kunt deze macro gebruiken of het BCM_GETTEXTMARGIN bericht expliciet verzenden.
Button_SetCheck	Hiermee stelt u de controlestatus van een keuzerondje of selectievakje in. U kunt deze macro gebruiken of het BM_SETCHECK bericht expliciet verzenden.
Button_SetDropDownState	Hiermee stelt u de vervolgkeuzelijst in voor een opgegeven knop met de stijl van BS_SPLITBUTTON. Gebruik deze macro of verzend het BCM_SETDROPDOWNSTATE bericht expliciet.
Button_SetElevationRequiredState	Hiermee stelt u de vereiste hoogtestatus in voor een opgegeven knop of opdrachtkoppeling om een pictogram met verhoogde bevoegdheid weer te geven. Gebruik deze macro of verzend het BCM_SETSHIELD bericht expliciet.
Button_SetImageList	Hiermee wijst u een lijst met afbeeldingen toe aan een knop besturingselement. U kunt deze macro gebruiken of het BCM_SETIMAGELIST bericht expliciet verzenden.
Button_SetNote	Hiermee stelt u de tekst van de notitie in die is gekoppeld aan een opgegeven opdrachtkoppelingsknop. U kunt deze macro gebruiken of het BCM_SETNOTE bericht expliciet verzenden.
Button_SetSplitInfo	Hiermee stelt u informatie in voor een opgegeven besturingselement voor gesplitste knoppen. Gebruik deze macro of verzend het BCM_SETSPLITINFO bericht expliciet.
Button_SetState	Hiermee stelt u de markeringsstatus van een knop in. De markeringsstatus geeft aan of de knop is gemarkeerd alsof de gebruiker deze had gepusht. U kunt deze macro gebruiken of het BM_SETSTATE bericht expliciet verzenden.
Button_SetStyle	Hiermee stelt u de stijl van een knop in. U kunt deze macro gebruiken of het BM_SETSTYLE bericht expliciet verzenden.
Button_SetText	Hiermee stelt u de tekst van een knop in.
Button_SetTextMargin	Hiermee stelt u de marges in voor het tekenen van tekst in een knop besturingselement. U kunt deze macro gebruiken of het BCM_SETTEXTMARGIN bericht expliciet verzenden.

Berichten

Onderwerp	Inhoud
BCM_GETIDEALSIZE	Hiermee wordt de grootte opgehaald van de knop die het beste past bij de tekst en afbeelding, als er een lijst met afbeeldingen aanwezig is. U kunt dit bericht expliciet verzenden of de Button_GetIdealSize macro gebruiken.
BCM_GETIMAGELIST	Hiermee haalt u de BUTTON_IMAGELIST structuur op waarmee de lijst met afbeeldingen wordt beschreven die is toegewezen aan een knop besturingselement. U kunt dit bericht expliciet verzenden of de Button_GetImageList macro gebruiken.
BCM_GETNOTE	Hiermee haalt u de tekst op van de notitie die is gekoppeld aan een opdrachtkoppelingsknop. U kunt dit bericht expliciet verzenden of de Button_GetNote macro gebruiken.
BCM_GETNOTELENGTH	Hiermee haalt u de lengte op van de notitietekst die mogelijk wordt weergegeven in de beschrijving voor een opdrachtkoppelingsknop. Verzend dit bericht expliciet of met behulp van de Button_GetNoteLength macro.
BCM_GETSPLITINFO	Hiermee haalt u informatie op voor een besturingselement voor gesplitste knoppen. Verzend dit bericht expliciet of met behulp van de macro Button_GetSplitInfo.
BCM_GETTEXTMARGIN	Hiermee haalt u de marges op die worden gebruikt om tekst te tekenen in een knop besturingselement. U kunt dit bericht expliciet verzenden of de Button_GetTextMargin macro gebruiken.
BCM_SETDROPDOWNSTATE	Hiermee stelt u de vervolgkeuzelijst in voor een knop met stijl TBSTYLE_DROPDOWN. Verzend dit bericht expliciet of met behulp van de Button_SetDropDownState macro.
BCM_SETIMAGELIST	Hiermee wijst u een lijst met afbeeldingen toe aan een knop besturingselement. U kunt dit bericht expliciet verzenden of de Button_SetImageList macro gebruiken.
BCM_SETNOTE	Hiermee stelt u de tekst van de notitie in die is gekoppeld aan een opdrachtkoppelingsknop. U kunt dit bericht expliciet verzenden of de Button_SetNote macro gebruiken.
BCM_SETSHIELD	Hiermee stelt u de vereiste hoogtestatus in voor een opgegeven knop of opdrachtkoppeling om een pictogram met verhoogde bevoegdheid weer te geven. Verzend dit bericht expliciet of met behulp van de Button_SetElevationRequiredState macro.
BCM_SETSPLITINFO	Hiermee stelt u informatie in voor een besturingselement voor gesplitste knoppen. Verzend dit bericht expliciet of met behulp van de Button_SetSplitInfo macro.
BCM_SETTEXTMARGIN	Het BCM_SETTEXTMARGIN bericht stelt de marges in voor het tekenen van tekst in een knop.
BM_CLICK	Simuleert de gebruiker die op een knop klikt. Dit bericht zorgt ervoor dat de knop de WM_LBUTTONDOWN en WM_LBUTTONUP berichten ontvangt en het bovenliggende venster van de knop een meldingscode van BN_CLICKED ontvangt.
BM_GETCHECK	Hiermee haalt u de controlestatus van een keuzerondje of selectievakje op. U kunt dit bericht expliciet verzenden of de Button_GetCheck macro gebruiken.
BM_GETIMAGE	Hiermee wordt een ingang opgehaald naar de afbeelding (pictogram of bitmap) die aan de knop is gekoppeld.
BM_GETSTATE	Hiermee haalt u de status van een knop of selectievakje op. U kunt dit bericht expliciet verzenden of de Button_GetState macro gebruiken.
BM_SETCHECK	Hiermee stelt u de controlestatus van een keuzerondje of selectievakje in. U kunt dit bericht expliciet verzenden of met behulp van de Button_SetCheck macro.
BM_SETDONTCLICK	Hiermee stelt u een vlag in op een keuzerondje waarmee het genereren van BN_CLICKED berichten wordt bepaald wanneer de focus op de knop wordt ontvangen.
BM_SETIMAGE	Hiermee koppelt u een nieuwe afbeelding (pictogram of bitmap) aan de knop.
BM_SETSTATE	Hiermee stelt u de markeringsstatus van een knop in. De markeringsstatus geeft aan of de knop is gemarkeerd alsof de gebruiker deze had gepusht. U kunt dit bericht expliciet verzenden of de Button_SetState macro gebruiken.
BM_SETSTYLE	Hiermee stelt u de stijl van een knop in. U kunt dit bericht expliciet verzenden of de Button_SetStyle macro gebruiken.

Meldingen

Onderwerp	Inhoud
BCN_DROPDOWN	Verzonden wanneer de gebruiker op een vervolgkeuzepijl op een knop klikt. Het bovenliggende venster van het besturingselement ontvangt deze meldingscode in de vorm van een WM_NOTIFY bericht.
BCN_HOTITEMCHANGE	Hiermee wordt de eigenaar van het knopbesturingselement aangegeven dat de muis het clientgebied van het knopbesturingselement invoert of verlaat. Het knopbesturingselement verzendt deze meldingscode in de vorm van een WM_NOTIFY bericht.
BN_CLICKED	Verzonden wanneer de gebruiker op een knop klikt. Het bovenliggende venster van de knop ontvangt de BN_CLICKED meldingscode via het WM_COMMAND bericht.
BN_DBLCLK	Verzonden wanneer de gebruiker dubbelklikt op een knop. Deze meldingscode wordt automatisch verzonden voor knoppen BS_USERBUTTON, BS_RADIOBUTTONen BS_OWNERDRAW. Andere knoptypen verzenden alleen BN_DBLCLK als ze de BS_NOTIFY stijl hebben. Het bovenliggende venster van de knop ontvangt de BN_DBLCLK meldingscode via het WM_COMMAND bericht.
BN_DISABLE	Verzonden wanneer een knop is uitgeschakeld. Opmerking: Deze meldingscode is alleen beschikbaar voor compatibiliteit met 16-bits versies van Windows ouder dan versie 3.0. Toepassingen moeten de knopstijl BS_OWNERDRAW en de DRAWITEMSTRUCT structuur voor deze taak gebruiken. Het bovenliggende venster van de knop ontvangt de BN_DISABLE meldingscode via het WM_COMMAND bericht.
BN_DOUBLECLICKED	Verzonden wanneer de gebruiker dubbelklikt op een knop. Deze meldingscode wordt automatisch verzonden voor knoppen BS_USERBUTTON, BS_RADIOBUTTONen BS_OWNERDRAW. Andere knoptypen verzenden alleen BN_DOUBLECLICKED als ze de stijl BS_NOTIFY hebben. Het bovenliggende venster van de knop ontvangt de BN_DOUBLECLICKED meldingscode via het WM_COMMAND bericht.
BN_HILITE	Verzonden wanneer de gebruiker een knop selecteert. Opmerking: Deze meldingscode is alleen beschikbaar voor compatibiliteit met 16-bits versies van Windows ouder dan versie 3.0. Toepassingen moeten de knopstijl BS_OWNERDRAW en de DRAWITEMSTRUCT structuur voor deze taak gebruiken. Het bovenliggende venster van de knop ontvangt de BN_HILITE meldingscode via het WM_COMMAND bericht.
BN_KILLFOCUS	Verzonden wanneer een knop de focus van het toetsenbord verliest. De knop moet de BS_NOTIFY stijl hebben om deze meldingscode te verzenden. Het bovenliggende venster van de knop ontvangt de BN_KILLFOCUS meldingscode via het WM_COMMAND bericht.
BN_PAINT	Verzonden wanneer een knop moet worden geschilderd. Opmerking: Deze meldingscode is alleen beschikbaar voor compatibiliteit met 16-bits versies van Windows ouder dan versie 3.0. Toepassingen moeten de knopstijl BS_OWNERDRAW en de DRAWITEMSTRUCT structuur voor deze taak gebruiken. Het bovenliggende venster van de knop ontvangt de BN_PAINT meldingscode via het WM_COMMAND bericht.
BN_PUSHED	Verzonden wanneer de drukstatus van een knop is ingesteld op gepusht. Opmerking: Deze meldingscode is alleen beschikbaar voor compatibiliteit met 16-bits versies van Windows ouder dan versie 3.0. Toepassingen moeten de knopstijl BS_OWNERDRAW en de DRAWITEMSTRUCT structuur voor deze taak gebruiken. Het bovenliggende venster van de knop ontvangt de BN_PUSHED meldingscode via het WM_COMMAND bericht.
BN_SETFOCUS	Verzonden wanneer een knop de focus van het toetsenbord ontvangt. De knop moet de BS_NOTIFY stijl hebben om deze meldingscode te verzenden. Het bovenliggende venster van de knop ontvangt de BN_SETFOCUS meldingscode via het WM_COMMAND bericht.
BN_UNHILITE	Verzonden wanneer de markering uit een knop moet worden verwijderd. Opmerking: Deze meldingscode is alleen beschikbaar voor compatibiliteit met 16-bits versies van Windows ouder dan versie 3.0. Toepassingen moeten de knopstijl BS_OWNERDRAW en de DRAWITEMSTRUCT structuur voor deze taak gebruiken. Het bovenliggende venster van de knop ontvangt de BN_UNHILITE meldingscode via het WM_COMMAND bericht.
BN_UNPUSHED	Verzonden wanneer de drukstatus van een knop is ingesteld op niet-gepusht. Opmerking: Deze meldingscode is alleen beschikbaar voor compatibiliteit met 16-bits versies van Windows ouder dan versie 3.0. Toepassingen moeten de knopstijl BS_OWNERDRAW en de DRAWITEMSTRUCT structuur voor deze taak gebruiken. Het bovenliggende venster van de knop ontvangt de BN_UNPUSHED meldingscode via het WM_COMMAND bericht.
NM_CUSTOMDRAW (knop)	Hiermee wordt het bovenliggende venster van een knopbesturingselement op de knop op de hoogte gesteld van aangepaste tekenbewerkingen. Het knopbesturingselement verzendt deze meldingscode in de vorm van een WM_NOTIFY bericht.
WM_CTLCOLORBTN	Het WM_CTLCOLORBTN bericht wordt verzonden naar het bovenliggende venster van een knop voordat u de knop tekent. Het bovenliggende venster kan de tekst en achtergrondkleuren van de knop wijzigen. Alleen door de eigenaar getekende knoppen reageren echter op het bovenliggende venster dat dit bericht verwerkt.

Structuren

Onderwerp	Inhoud
BUTTON_IMAGELIST	Bevat informatie over een lijst met afbeeldingen die wordt gebruikt met een knop besturingselement.
BUTTON_SPLITINFO	Bevat informatie die een splitsknop definieert (BS_SPLITBUTTON en BS_DEFSPLITBUTTON stijlen). Wordt gebruikt met de BCM_GETSPLITINFO en BCM_SETSPLITINFO berichten.
NMBCDROPDOWN-	Bevat informatie over een BCN_DROPDOWN melding.
NMBCHOTITEM-	Bevat informatie over de beweging van de muis over een knopbesturing.

Constanten

Onderwerp	Inhoud
knopstijlen	Hiermee geeft u een combinatie van knopstijlen. Als u een knop maakt met de klasse BUTTON met de CreateWindow- of functie CreateWindowEx, kunt u een van de onderstaande knopstijlen opgeven.