Share via

CButton-klasse

Opmerking

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

Biedt de functionaliteit van Windows-knopbesturingselementen.

Syntaxis

class CButton : public CWnd

Leden

Openbare constructors

Naam Description
CButton::CButton Maakt een CButton object.

Openbare methoden

Naam Description
CButton::Maken Hiermee maakt u het Besturingselement windows-knop en koppelt u het aan het CButton object.
CButton::D rawItem Overschrijven om een door de eigenaar getekend CButton object te tekenen.
CButton::GetBitmap Haalt de ingang van de bitmap op die eerder is ingesteld met SetBitmap.
CButton::GetButtonStyle Hiermee wordt informatie opgehaald over de stijl van het besturingselement voor knoppen.
CButton::GetCheck Hiermee haalt u de controlestatus van een knop besturingselement op.
CButton::GetCursor Hiermee haalt u de ingang van de cursorafbeelding op die eerder is ingesteld met SetCursor.
CButton::GetIcon Haalt de ingang van het pictogram op dat eerder is ingesteld met SetIcon.
CButton::GetIdealSize Hiermee wordt de ideale grootte van het besturingselement voor knoppen opgehaald.
CButton::GetImageList Hiermee haalt u de lijst met afbeeldingen van het knop besturingselement op.
CButton::GetNote Hiermee wordt het notitieonderdeel van het huidige besturingselement voor opdrachtkoppeling opgehaald.
CButton::GetNoteLength Hiermee haalt u de lengte van de notitietekst voor het huidige besturingselement voor de opdrachtkoppeling op.
CButton::GetSplitGlyph Hiermee wordt het symbool opgehaald dat is gekoppeld aan het huidige besturingselement voor gesplitste knoppen.
CButton::GetSplitImageList Hiermee wordt de lijst met afbeeldingen opgehaald voor het huidige besturingselement voor gesplitste knoppen.
CButton::GetSplitInfo Hiermee haalt u informatie op waarmee het huidige besturingselement voor gesplitste knoppen wordt gedefinieerd.
CButton::GetSplitSize Hiermee haalt u de begrenzingsrechthoek van het vervolgkeuzeonderdeel van het huidige besturingselement voor gesplitste knoppen op.
CButton::GetSplitStyle Hiermee worden de stijlen voor gesplitste knoppen opgehaald waarmee het huidige besturingselement voor gesplitste knoppen wordt gedefinieerd.
CButton::GetState Hiermee haalt u de controlestatus, markeringsstatus en focusstatus van een knop besturingselement op.
CButton::GetTextMargin Hiermee haalt u de tekstmarge van het knop besturingselement op.
CButton::SetBitmap Hiermee geeft u een bitmap op die op de knop moet worden weergegeven.
CButton::SetButtonStyle Hiermee wijzigt u de stijl van een knop.
CButton::SetCheck Hiermee stelt u de controlestatus van een knop besturingselement in.
CButton::SetCursor Hiermee geeft u een cursorafbeelding op die op de knop moet worden weergegeven.
CButton::SetDropDownState Hiermee stelt u de vervolgkeuzelijst van het huidige besturingselement voor gesplitste knoppen in.
CButton::SetIcon Hiermee geeft u een pictogram op dat op de knop moet worden weergegeven.
CButton::SetImageList Hiermee stelt u de lijst met afbeeldingen van het knop besturingselement in.
CButton::SetNote Hiermee stelt u de notitie in op het huidige besturingselement voor opdrachtkoppeling.
CButton::SetSplitGlyph Koppelt een opgegeven glyph aan het huidige besturingselement voor gesplitste knoppen.
CButton::SetSplitImageList Hiermee koppelt u een lijst met afbeeldingen aan het huidige besturingselement voor gesplitste knoppen.
CButton::SetSplitInfo Hiermee geeft u informatie op waarmee het huidige besturingselement voor gesplitste knoppen wordt gedefinieerd.
CButton::SetSplitSize Hiermee stelt u de begrenzingsrechthoek van de vervolgkeuzelijst van het huidige besturingselement splitsknop in.
CButton::SetSplitStyle Hiermee stelt u de stijl van het huidige besturingselement voor gesplitste knoppen in.
CButton::SetState Hiermee stelt u de markeringsstatus van een knop besturingselement in.
CButton::SetTextMargin Hiermee stelt u de tekstmarge van het knop besturingselement in.

Opmerkingen

Een knop besturingselement is een klein, rechthoekig onderliggend venster dat kan worden geklikt en uitgeschakeld. Knoppen kunnen alleen of in groepen worden gebruikt en kunnen worden gelabeld of zonder tekst worden weergegeven. Een knop verandert doorgaans het uiterlijk wanneer de gebruiker erop klikt.

Typische knoppen zijn het selectievakje, keuzerondje en drukknop. Een CButton object kan elk van deze worden, volgens de knopstijl die is opgegeven bij de initialisatie door de functie Lid maken .

Bovendien ondersteunt de CBitmapButton-klasse die is afgeleid van CButton het maken van knopbesturingselementen die zijn gelabeld met bitmapafbeeldingen in plaats van tekst. Een CBitmapButton kan afzonderlijke bitmaps hebben voor de statussen omhoog, omlaag, gericht en uitgeschakeld van een knop.

U kunt een knopbesturing maken op basis van een dialoogvenstersjabloon of rechtstreeks in uw code. Roep in beide gevallen eerst de constructor CButton aan om het CButton object te maken. Roep vervolgens de Create lidfunctie aan om het Besturingselement windows-knop te maken en deze aan het CButton object te koppelen.

Constructie kan een proces in één stap zijn in een klasse die is afgeleid van CButton. Schrijf een constructor voor de afgeleide klasse en roep Create aan vanuit de constructor.

Als u Windows-meldingsberichten wilt verwerken die door een knopbesturingselement worden verzonden naar het bovenliggende besturingselement (meestal een klasse die is afgeleid van CDialog), voegt u een berichttoewijzingsvermelding en een berichtenhandlerlidfunctie toe aan de bovenliggende klasse voor elk bericht.

Elke berichtkaartvermelding heeft het volgende formulier:

ON_Notification(id, memberFxn)

waarbij de id de id van het onderliggende venster opgeeft van het besturingselement dat de melding verzendt en memberFxn de naam is van de bovenliggende lidfunctie die u hebt geschreven om de melding te verwerken.

Het prototype van de functie van de bovenliggende functie is als volgt:

afx_msg void memberFxn();

Mogelijke berichtenoverzichtvermeldingen zijn als volgt:

Kaartvermelding Verzonden naar bovenliggend item wanneer...
ON_BN_CLICKED De gebruiker klikt op een knop.
ON_BN_DOUBLECLICKED De gebruiker dubbelklikt op een knop.

Als u een CButton object maakt op basis van een dialoogvensterresource, wordt het CButton object automatisch vernietigd wanneer de gebruiker het dialoogvenster sluit.

Als u een CButton object in een venster maakt, moet u het mogelijk vernietigen. Als u het CButton object op de heap maakt met behulp van de new functie, moet u het object aanroepen delete om het te vernietigen wanneer de gebruiker het besturingselement Windows-knop sluit. Als u het CButton object op de stapel maakt of als het is ingesloten in het bovenliggende dialoogvensterobject, wordt het automatisch vernietigd.

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CButton

Requirements

Koptekst: afxwin.h

CButton::CButton

Maakt een CButton object.

CButton();

Example

// Declare a button object.
CButton myButton;

CButton::Maken

Hiermee maakt u het Besturingselement windows-knop en koppelt u het aan het CButton object.

virtual BOOL Create(
    LPCTSTR lpszCaption,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameterwaarden

lpszCaption
Hiermee geeft u de tekst van het knop besturingselement.

dwStyle-
Hiermee geeft u de stijl van het knop besturingselement. Pas een combinatie van knopstijlen toe op de knop.

Rect
Hiermee geeft u de grootte en positie van het knop besturingselement. Het kan een CRect object of een RECT structuur zijn.

pParentWnd
Hiermee geeft u het bovenliggende venster van het knop besturingselement, meestal een CDialog. Deze mag niet NULL zijn.

nID-
Hiermee geeft u de id van het knop besturingselement.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

U maakt een CButton object in twee stappen. Roep eerst de constructor aan en roep Createvervolgens het besturingselement windows-knop aan en koppel deze aan het CButton object.

Als de stijl WS_VISIBLE is opgegeven, verzendt Windows het knopbeheer alle berichten die nodig zijn om de knop te activeren en weer te geven.

Pas de volgende vensterstijlen toe op een besturingselement voor knoppen:

  • altijd WS_CHILD

  • WS_VISIBLE meestal

  • WS_DISABLED zelden

  • WS_GROUP Besturingselementen groeperen

  • WS_TABSTOP De knop opnemen in de tabvolgorde

Example

CButton myButton1, myButton2, myButton3, myButton4;

// Create a push button.
myButton1.Create(_T("My button"), WS_CHILD | WS_VISIBLE | BS_PUSHBUTTON,
                 CRect(10, 10, 100, 30), pParentWnd, 1);

// Create a radio button.
myButton2.Create(_T("My button"), WS_CHILD | WS_VISIBLE | BS_RADIOBUTTON,
                 CRect(10, 40, 100, 70), pParentWnd, 2);

// Create an auto 3-state button.
myButton3.Create(_T("My button"), WS_CHILD | WS_VISIBLE | BS_AUTO3STATE,
                 CRect(10, 70, 100, 100), pParentWnd, 3);

// Create an auto check box.
myButton4.Create(_T("My button"), WS_CHILD | WS_VISIBLE | BS_AUTOCHECKBOX,
                 CRect(10, 100, 100, 130), pParentWnd, 4);

CButton::D rawItem

Aangeroepen door het framework wanneer een visueel aspect van een door de eigenaar getekende knop is gewijzigd.

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

Parameterwaarden

lpDrawItemStruct
Een lange aanwijzer naar een DRAWITEMSTRUCT-structuur . De structuur bevat informatie over het te tekenen item en het type tekening dat nodig is.

Opmerkingen

Een door de eigenaar getekende knop bevat de BS_OWNERDRAW stijlset. Overschrijf deze lidfunctie om tekening te implementeren voor een door de eigenaar getekend CButton object. De toepassing moet alle GDI-objecten (Graphics Device Interface) herstellen die zijn geselecteerd voor de weergavecontext die is opgegeven in lpDrawItemStruct voordat de lidfunctie wordt beëindigd.

Zie ook de BS_ stijlwaarden.

Example

// NOTE: CMyButton is a class derived from CButton. The CMyButton
// object was created as follows:
//
// CMyButton myButton;
// myButton.Create(_T("My button"),
//      WS_CHILD|WS_VISIBLE|BS_PUSHBUTTON|BS_OWNERDRAW,
//      CRect(10,10,100,30), pParentWnd, 1);
//

// This example implements the DrawItem method for a CButton-derived
// class that draws the button's text using the color red.
void CMyButton::DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct)
{
   UINT uStyle = DFCS_BUTTONPUSH;

   // This code only works with buttons.
   ASSERT(lpDrawItemStruct->CtlType == ODT_BUTTON);

   // If drawing selected, add the pushed style to DrawFrameControl.
   if (lpDrawItemStruct->itemState & ODS_SELECTED)
      uStyle |= DFCS_PUSHED;

   // Draw the button frame.
   ::DrawFrameControl(lpDrawItemStruct->hDC, &lpDrawItemStruct->rcItem,
                      DFC_BUTTON, uStyle);

   // Get the button's text.
   CString strText;
   GetWindowText(strText);

   // Draw the button text using the text color red.
   COLORREF crOldColor = ::SetTextColor(lpDrawItemStruct->hDC, RGB(255, 0, 0));
   ::DrawText(lpDrawItemStruct->hDC, strText, strText.GetLength(),
              &lpDrawItemStruct->rcItem, DT_SINGLELINE | DT_VCENTER | DT_CENTER);
   ::SetTextColor(lpDrawItemStruct->hDC, crOldColor);
}

CButton::GetBitmap

Roep deze lidfunctie aan om de ingang van een bitmap op te halen, eerder ingesteld met SetBitmap, die is gekoppeld aan een knop.

HBITMAP GetBitmap() const;

Retourwaarde

Een greep naar een bitmap. NULL als er eerder geen bitmap is opgegeven.

Example

CButton myBitmapButton;

// Create a bitmap button.
myBitmapButton.Create(_T("My button"), WS_CHILD | WS_VISIBLE | BS_BITMAP,
                      CRect(10, 10, 60, 50), pParentWnd, 1);

// If no bitmap is defined for the button, define the bitmap to the
// system close bitmap.
if (myBitmapButton.GetBitmap() == NULL)
   myBitmapButton.SetBitmap(::LoadBitmap(NULL, MAKEINTRESOURCE(OBM_CLOSE)));

CButton::GetButtonStyle

Hiermee wordt informatie opgehaald over de stijl van het besturingselement voor knoppen.

UINT GetButtonStyle() const;

Retourwaarde

Retourneert de knopstijlen voor dit CButton object. Deze functie retourneert alleen de BS_ stijlwaarden, niet een van de andere vensterstijlen.

Example

CButton myRadioButton;

// Create a radio button.
myRadioButton.Create(_T("My button"), WS_CHILD | WS_VISIBLE | BS_RADIOBUTTON,
                     CRect(10, 10, 100, 30), pParentWnd, 1);

// Change the button style to use one of the "auto" styles; for
// push button, change to def push button.
UINT uStyle = myRadioButton.GetButtonStyle();
if (uStyle == BS_PUSHBUTTON)
   uStyle = BS_DEFPUSHBUTTON;
else if (uStyle == BS_RADIOBUTTON)
   uStyle = BS_AUTORADIOBUTTON;
else if (uStyle == BS_CHECKBOX)
   uStyle = BS_AUTOCHECKBOX;
else if (uStyle == BS_3STATE)
   uStyle = BS_AUTO3STATE;

// Change the button style to the one wanted.
myRadioButton.SetButtonStyle(uStyle);

CButton::GetCheck

Hiermee haalt u de controlestatus van een keuzerondje of selectievakje op.

int GetCheck() const;

Retourwaarde

De retourwaarde van een knop besturingselement dat is gemaakt met de stijl BS_AUTOCHECKBOX, BS_AUTORADIOBUTTON, BS_AUTO3STATE, BS_CHECKBOX, BS_RADIOBUTTON of BS_3STATE is een van de volgende waarden:

Waarde Meaning
BST_UNCHECKED Knopstatus is uitgeschakeld.
BST_CHECKED Knopstatus is ingeschakeld.
BST_INDETERMINATE Knopstatus is onbepaald (geldt alleen als de knop de stijl BS_3STATE of BS_AUTO3STATE heeft).

Als de knop een andere stijl heeft, wordt de retourwaarde BST_UNCHECKED.

Example

CButton myA3Button;

// Create an auto 3-state button.
myA3Button.Create(_T("My button"), WS_CHILD | WS_VISIBLE | BS_AUTO3STATE,
                  CRect(10, 10, 100, 30), pParentWnd, 1);

// Set the check state to the next state
// (i.e. BST_UNCHECKED changes to BST_CHECKED
// BST_CHECKED changes to BST_INDETERMINATE
// BST_INDETERMINATE changes to BST_UNCHECKED).
myA3Button.SetCheck(((myA3Button.GetCheck() + 1) % 3));

CButton::GetCursor

Roep deze lidfunctie aan om de ingang van een cursor op te halen, eerder ingesteld met SetCursor, die is gekoppeld aan een knop.

HCURSOR GetCursor();

Retourwaarde

Een greep naar een cursorafbeelding. NULL als er eerder geen cursor is opgegeven.

Example

CButton myIconButton;

// Create an icon button.
myIconButton.Create(_T("My button"), WS_CHILD | WS_VISIBLE | BS_ICON,
                    CRect(10, 10, 60, 50), pParentWnd, 1);

// If no image is defined for the button, define the image to the
// system arrow and question mark cursor.
if (myIconButton.GetCursor() == NULL)
   myIconButton.SetCursor(::LoadCursor(NULL, IDC_HELP));

CButton::GetIcon

Roep deze lidfunctie aan om de ingang van een pictogram op te halen, eerder ingesteld met SetIcon, dat is gekoppeld aan een knop.

HICON GetIcon() const;

Retourwaarde

Een greep naar een pictogram. NULL als er eerder geen pictogram is opgegeven.

Example

CButton myIconButton2;

// Create an icon button.
myIconButton2.Create(_T("My button"), WS_CHILD | WS_VISIBLE | BS_ICON,
                     CRect(10, 10, 60, 50), pParentWnd, 1);

// If no icon is defined for the button, define the icon to the
// system error icon.
if (myIconButton2.GetIcon() == NULL)
   myIconButton2.SetIcon(::LoadIcon(NULL, IDI_ERROR));

CButton::GetIdealSize

Hiermee haalt u de ideale grootte voor het besturingselement voor de knop op.

BOOL GetIdealSize(SIZE* psize);

Parameterwaarden

psize
Een aanwijzer naar de huidige grootte van de knop.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het BCM_GETIDEALSIZE bericht geëmuleren, zoals beschreven in de sectie Knoppen van de Windows SDK.

CButton::GetImageList

Roep deze methode aan om de lijst met afbeeldingen op te halen uit het knop besturingselement.

BOOL GetImageList(PBUTTON_IMAGELIST pbuttonImagelist);

Parameterwaarden

pbuttonImagelist
Een aanwijzer naar de lijst met afbeeldingen van het CButton object.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Deze lidfunctie emuleert de functionaliteit van het BCM_GETIMAGELIST bericht, zoals beschreven in de sectie Knoppen van de Windows SDK.

CButton::GetNote

Haalt de notitietekst op die is gekoppeld aan het huidige besturingselement voor de opdrachtkoppeling.

CString GetNote() const;

BOOL GetNote(
    LPTSTR lpszNote,
    UINT* cchNote) const;

Parameterwaarden

lpszNote
[uit] Wijs een buffer aan, die de aanroeper verantwoordelijk is voor het toewijzen en toewijzen van de toewijzing. Als de retourwaarde WAAR is, bevat de buffer de notitietekst die is gekoppeld aan het huidige besturingselement voor opdrachtkoppelingen; anders is de buffer ongewijzigd.

cchNote
[in, uit] Een aanwijzer naar een variabele met een niet-ondertekend geheel getal. Wanneer deze methode wordt aangeroepen, bevat de variabele de grootte van de buffer die is opgegeven door de parameter lpszNote . Als deze methode retourneert, bevat de variabele de grootte van de notitie die is gekoppeld aan het huidige besturingselement voor opdrachtkoppeling. Als de retourwaarde ONWAAR is, bevat de variabele de buffergrootte die nodig is om de notitie te bevatten.

Retourwaarde

In de eerste overbelasting, een CString-object dat de notitietekst bevat die is gekoppeld aan het huidige besturingselement voor opdrachtkoppeling.

– of –

In de tweede overbelasting, TRUE als deze methode succesvol is; anders, ONWAAR.

Opmerkingen

Gebruik deze methode alleen met besturingselementen waarvan de knopstijl is BS_COMMANDLINK of BS_DEFCOMMANDLINK.

Met deze methode wordt het BCM_GETNOTE bericht verzonden, dat wordt beschreven in de Windows SDK.

CButton::GetNoteLength

Hiermee haalt u de lengte van de notitietekst voor het huidige besturingselement voor de opdrachtkoppeling op.

UINT GetNoteLength() const;

Retourwaarde

De lengte van de notitietekst, in 16-bits Unicode-tekens, voor het huidige besturingselement voor opdrachtkoppeling.

Opmerkingen

Gebruik deze methode alleen met besturingselementen waarvan de knopstijl is BS_COMMANDLINK of BS_DEFCOMMANDLINK.

Met deze methode wordt het BCM_GETNOTELENGTH bericht verzonden, dat wordt beschreven in de Windows SDK.

CButton::GetSplitGlyph

Hiermee wordt het symbool opgehaald dat is gekoppeld aan het huidige besturingselement voor gesplitste knoppen.

TCHAR GetSplitGlyph() const;

Retourwaarde

Het symbool dat is gekoppeld aan het huidige besturingselement splitsknop.

Opmerkingen

Een symbool is de fysieke weergave van een teken in een bepaald lettertype. Een besturingselement voor een splitsknop kan bijvoorbeeld worden versierd met het symbool van het Unicode-vinkje (U+2713).

Gebruik deze methode alleen met besturingselementen waarvan de knopstijl is BS_SPLITBUTTON of BS_DEFSPLITBUTTON.

Met deze methode wordt het mask lid van een BUTTON_SPLITINFO-structuur geïnitialiseerd met de vlag BCSIF_GLYPH en wordt die structuur vervolgens verzonden in het BCM_GETSPLITINFO bericht dat wordt beschreven in de Windows SDK. Wanneer de berichtfunctie wordt geretourneerd, wordt met deze methode het symbool opgehaald uit het himlGlyph lid van de structuur.

CButton::GetSplitImageList

Hiermee wordt de lijst met afbeeldingen opgehaald voor het huidige besturingselement voor gesplitste knoppen.

CImageList* GetSplitImageList() const;

Retourwaarde

Een aanwijzer naar een CImageList-object .

Opmerkingen

Gebruik deze methode alleen met besturingselementen waarvan de knopstijl is BS_SPLITBUTTON of BS_DEFSPLITBUTTON.

Met deze methode wordt het mask lid van een BUTTON_SPLITINFO structuur geïnitialiseerd met de vlag BCSIF_IMAGE en wordt die structuur vervolgens verzonden in het BCM_GETSPLITINFO bericht dat wordt beschreven in de Windows SDK. Wanneer de berichtfunctie wordt geretourneerd, haalt deze methode de lijst met afbeeldingen op van het himlGlyph lid van de structuur.

CButton::GetSplitInfo

Hiermee worden parameters opgehaald die bepalen hoe Windows het huidige besturingselement voor gesplitste knoppen tekent.

BOOL GetSplitInfo(PBUTTON_SPLITINFO pInfo) const;

Parameterwaarden

Pinfo
[uit] Wijs een BUTTON_SPLITINFO structuur aan die informatie ontvangt over het huidige besturingselement voor gesplitste knoppen. De beller is verantwoordelijk voor het toewijzen van de structuur.

Retourwaarde

WAAR als deze methode is geslaagd; anders, ONWAAR.

Opmerkingen

Gebruik deze methode alleen met besturingselementen waarvan de knopstijl is BS_SPLITBUTTON of BS_DEFSPLITBUTTON.

Met deze methode wordt het BCM_GETSPLITINFO bericht verzonden, dat wordt beschreven in de Windows SDK.

CButton::GetSplitSize

Hiermee haalt u de begrenzingsrechthoek van het vervolgkeuzeonderdeel van het huidige besturingselement voor gesplitste knoppen op.

BOOL GetSplitSize(LPSIZE pSize) const;

Parameterwaarden

pSize
[uit] Wijs een groottestructuur aan die de beschrijving van een rechthoek ontvangt.

Retourwaarde

WAAR als deze methode is geslaagd; anders, ONWAAR.

Opmerkingen

Gebruik deze methode alleen met besturingselementen waarvan de knopstijl is BS_SPLITBUTTON of BS_DEFSPLITBUTTON.

Wanneer het besturingselement voor gesplitste knoppen is uitgevouwen, kan er een vervolgkeuzelijst worden weergegeven, zoals een besturingselement voor lijsten of paginabesturingselementen. Met deze methode wordt de begrenzingsrechthoek opgehaald die het vervolgkeuzeonderdeel bevat.

Met deze methode wordt het mask lid van een BUTTON_SPLITINFO-structuur geïnitialiseerd met de vlag BCSIF_SIZE en wordt die structuur vervolgens verzonden in het BCM_GETSPLITINFO bericht dat wordt beschreven in de Windows SDK. Wanneer de berichtfunctie wordt geretourneerd, wordt met deze methode de begrenzingsrechthoek opgehaald uit het size lid van de structuur.

CButton::GetSplitStyle

Hiermee worden de stijlen voor gesplitste knoppen opgehaald waarmee het huidige besturingselement voor gesplitste knoppen wordt gedefinieerd.

UINT GetSplitStyle() const;

Retourwaarde

Een bitsgewijze combinatie van gesplitste knopstijlen. Zie het uSplitStyle lid van de BUTTON_SPLITINFO structuur voor meer informatie.

Opmerkingen

Gebruik deze methode alleen met besturingselementen waarvan de knopstijl is BS_SPLITBUTTON of BS_DEFSPLITBUTTON.

Met de stijlen voor gesplitste knoppen geeft u de uitlijning, hoogte-breedteverhouding en grafische indeling op waarmee Windows een pictogram voor een gesplitste knop tekent.

Met deze methode wordt het mask lid van een BUTTON_SPLITINFO-structuur geïnitialiseerd met de vlag BCSIF_STYLE en wordt die structuur vervolgens verzonden in het BCM_GETSPLITINFO bericht dat wordt beschreven in de Windows SDK. Wanneer de berichtfunctie wordt geretourneerd, worden met deze methode de stijlen voor gesplitste knoppen opgehaald uit het uSplitStyle lid van de structuur.

CButton::GetState

Haalt de status van een knop besturingselement op.

UINT GetState() const;

Retourwaarde

Een bitveld dat de combinatie van waarden bevat die de huidige status van een knop besturingselement aangeven. De volgende tabel bevat mogelijke waarden.

Knopstatus Waarde Description
BST_UNCHECKED 0x0000 De initiële status.
BST_CHECKED 0x0001 Het besturingselement voor de knop is ingeschakeld.
BST_INDETERMINATE 0x0002 De status is onbepaald (alleen mogelijk wanneer het knopbesturingselement drie statussen heeft).
BST_PUSHED 0x0004 Het besturingselement voor de knop wordt ingedrukt.
BST_FOCUS 0x0008 Het knop besturingselement heeft de focus.

Opmerkingen

Een knopbesturingselement met de BS_3STATE of BS_AUTO3STATE knopstijl maakt een selectievakje met een derde status met de naam van de onbepaalde status. De onbepaalde status geeft aan dat het selectievakje niet is ingeschakeld of uitgeschakeld.

Example

CButton myPushButton;

// Create a push button.
myPushButton.Create(_T("My button"), WS_CHILD | WS_VISIBLE | BS_PUSHBUTTON,
                    CRect(10, 10, 100, 30), pParentWnd, 1);

// Invert the highlight state of the button.
myPushButton.SetState(!(myPushButton.GetState() & 0x0004));

CButton::GetTextMargin

Roep deze methode aan om de tekstmarge van het CButton object op te halen.

BOOL GetTextMargin(RECT* pmargin);

Parameterwaarden

pmargin
Een aanwijzer naar de tekstmarge van het CButton object.

Retourwaarde

Retourneert de tekstmarge. Niet-nul indien geslaagd; anders 0.

Opmerkingen

Deze lidfunctie emuleert de functionaliteit van het BCM_GETTEXTMARGIN bericht, zoals beschreven in de sectie Knoppen van de Windows SDK.

CButton::SetBitmap

Roep deze lidfunctie aan om een nieuwe bitmap aan de knop te koppelen.

HBITMAP SetBitmap(HBITMAP hBitmap);

Parameterwaarden

hBitmap
De greep van een bitmap.

Retourwaarde

De greep van een bitmap die eerder aan de knop is gekoppeld.

Opmerkingen

De bitmap wordt automatisch op het gezicht van de knop geplaatst, standaard gecentreerd. Als de bitmap te groot is voor de knop, wordt deze aan beide zijden geknipt. U kunt andere uitlijningsopties kiezen, waaronder het volgende:

  • BS_TOP

  • BS_LEFT

  • BS_RIGHT

  • BS_CENTER

  • BS_BOTTOM

  • BS_VCENTER

In tegenstelling tot CBitmapButton, waarvoor vier bitmaps per knop worden gebruikt, SetBitmap wordt slechts één bitmap per knop gebruikt. Wanneer de knop wordt ingedrukt, lijkt de bitmap omlaag en naar rechts te schuiven.

U bent verantwoordelijk voor het vrijgeven van de bitmap wanneer u er klaar mee bent.

Example

CButton myBitmapButton;

// Create a bitmap button.
myBitmapButton.Create(_T("My button"), WS_CHILD | WS_VISIBLE | BS_BITMAP,
                      CRect(10, 10, 60, 50), pParentWnd, 1);

// If no bitmap is defined for the button, define the bitmap to the
// system close bitmap.
if (myBitmapButton.GetBitmap() == NULL)
   myBitmapButton.SetBitmap(::LoadBitmap(NULL, MAKEINTRESOURCE(OBM_CLOSE)));

CButton::SetButtonStyle

Hiermee wijzigt u de stijl van een knop.

void SetButtonStyle(
    UINT nStyle,
    BOOL bRedraw = TRUE);

Parameterwaarden

nStyle
Hiermee geeft u de knopstijl op.

bRedraw
Hiermee geeft u op of de knop opnieuw moet worden getekend. Met een niet-nulwaarde wordt de knop opnieuw getekend. Een 0-waarde tekent de knop niet opnieuw. De knop wordt standaard opnieuw getekend.

Opmerkingen

Gebruik de GetButtonStyle lidfunctie om de knopstijl op te halen. Het woord in lage volgorde van de volledige knopstijl is de knopspecifieke stijl.

Example

CButton myRadioButton;

// Create a radio button.
myRadioButton.Create(_T("My button"), WS_CHILD | WS_VISIBLE | BS_RADIOBUTTON,
                     CRect(10, 10, 100, 30), pParentWnd, 1);

// Change the button style to use one of the "auto" styles; for
// push button, change to def push button.
UINT uStyle = myRadioButton.GetButtonStyle();
if (uStyle == BS_PUSHBUTTON)
   uStyle = BS_DEFPUSHBUTTON;
else if (uStyle == BS_RADIOBUTTON)
   uStyle = BS_AUTORADIOBUTTON;
else if (uStyle == BS_CHECKBOX)
   uStyle = BS_AUTOCHECKBOX;
else if (uStyle == BS_3STATE)
   uStyle = BS_AUTO3STATE;

// Change the button style to the one wanted.
myRadioButton.SetButtonStyle(uStyle);

CButton::SetCheck

Hiermee stelt u de controlestatus van een keuzerondje of selectievakje in of stelt u deze opnieuw in.

void SetCheck(int nCheck);

Parameterwaarden

nCheck
Hiermee geeft u de controlestatus. Deze parameter kan een van de volgende zijn:

Waarde Meaning
BST_UNCHECKED Stel de knopstatus in op uitgeschakeld.
BST_CHECKED Stel de knopstatus in op ingeschakeld.
BST_INDETERMINATE Stel de knopstatus in op onbepaalde tijd. Deze waarde kan alleen worden gebruikt als de knop de stijl BS_3STATE of BS_AUTO3STATE heeft.

Opmerkingen

Deze lidfunctie heeft geen effect op een drukknop.

Example

CButton myA3Button;

// Create an auto 3-state button.
myA3Button.Create(_T("My button"), WS_CHILD | WS_VISIBLE | BS_AUTO3STATE,
                  CRect(10, 10, 100, 30), pParentWnd, 1);

// Set the check state to the next state
// (i.e. BST_UNCHECKED changes to BST_CHECKED
// BST_CHECKED changes to BST_INDETERMINATE
// BST_INDETERMINATE changes to BST_UNCHECKED).
myA3Button.SetCheck(((myA3Button.GetCheck() + 1) % 3));

CButton::SetCursor

Roep deze lidfunctie aan om een nieuwe cursor aan de knop te koppelen.

HCURSOR SetCursor(HCURSOR hCursor);

Parameterwaarden

hCursor
De greep van een cursor.

Retourwaarde

De greep van een cursor die eerder aan de knop is gekoppeld.

Opmerkingen

De cursor wordt automatisch op het gezicht van de knop geplaatst, standaard gecentreerd. Als de cursor te groot is voor de knop, wordt deze aan beide zijden geknipt. U kunt andere uitlijningsopties kiezen, waaronder het volgende:

  • BS_TOP

  • BS_LEFT

  • BS_RIGHT

  • BS_CENTER

  • BS_BOTTOM

  • BS_VCENTER

In tegenstelling tot CBitmapButton, waarbij vier bitmaps per knop worden gebruikt, SetCursor wordt slechts één cursor per knop gebruikt. Wanneer de knop wordt ingedrukt, wordt de cursor weergegeven om omlaag en naar rechts te schuiven.

Example

CButton myIconButton;

// Create an icon button.
myIconButton.Create(_T("My button"), WS_CHILD | WS_VISIBLE | BS_ICON,
                    CRect(10, 10, 60, 50), pParentWnd, 1);

// If no image is defined for the button, define the image to the
// system arrow and question mark cursor.
if (myIconButton.GetCursor() == NULL)
   myIconButton.SetCursor(::LoadCursor(NULL, IDC_HELP));

CButton::SetDropDownState

Hiermee stelt u de vervolgkeuzelijst van het huidige besturingselement voor gesplitste knoppen in.

BOOL SetDropDownState(BOOL fDropDown);

Parameterwaarden

fDropDown
[in] WAAR om BST_DROPDOWNPUSHED status in te stellen; anders, ONWAAR.

Retourwaarde

WAAR als deze methode is geslaagd; anders, ONWAAR.

Opmerkingen

Een besturingselement voor een splitsknop heeft een stijl van BS_SPLITBUTTON of BS_DEFSPLITBUTTON en bestaat uit een knop en een vervolgkeuzepijl aan de rechterkant. Zie Knopstijlen voor meer informatie. Meestal wordt de vervolgkeuzelijst ingesteld wanneer de gebruiker op de vervolgkeuzepijl klikt. Gebruik deze methode om de vervolgkeuzelijststatus van het besturingselement programmatisch in te stellen. De vervolgkeuzepijl wordt gearceerd om de status aan te geven.

Met deze methode wordt het BCM_SETDROPDOWNSTATE bericht verzonden, dat wordt beschreven in de Windows SDK.

Example

In het eerste codevoorbeeld wordt de variabele gedefinieerd, m_splitButtondie wordt gebruikt om programmatisch toegang te krijgen tot het besturingselement voor gesplitste knoppen. Deze variabele wordt gebruikt in het volgende voorbeeld.

public:
// Variable to access programmatically defined command link control.
CButton m_cmdLink;
// Variable to access programmatically defined split button control.
CButton m_splitButton;

In het volgende codevoorbeeld wordt de status van het besturingselement splitsknop ingesteld om aan te geven dat de vervolgkeuzepijl wordt gepusht.

/* Set the state of the split button control to indicate that 
   the drop-down arrow is pushed. The arrow is drawn shaded to 
   indicate the state.
   */
m_splitButton.SetDropDownState(TRUE);

CButton::SetElevationRequired

Hiermee stelt u de status van het huidige knop besturingselement elevation requiredin op , wat nodig is voor het besturingselement om een beveiligingspictogram met verhoogde bevoegdheid weer te geven.

BOOL SetElevationRequired(BOOL fElevationRequired);

Parameterwaarden

fElevationRequired
[in] WAAR om de status in te stellen elevation required ; anders ONWAAR.

Retourwaarde

WAAR als deze methode is geslaagd; anders, ONWAAR.

Opmerkingen

Als voor een besturingselement voor knop- of opdrachtkoppeling verhoogde beveiligingsmachtigingen zijn vereist om een actie uit te voeren, stelt u het besturingselement in op elevation required status. Vervolgens wordt in Windows het UAC-schildpictogram (User Account Control) weergegeven op het besturingselement. Zie Gebruikersaccountbeheer voor meer informatie.

Met deze methode wordt het BCM_SETSHIELD bericht verzonden, dat wordt beschreven in de Windows SDK.

CButton::SetIcon

Roep deze lidfunctie aan om een nieuw pictogram aan de knop te koppelen.

HICON SetIcon(HICON hIcon);

Parameterwaarden

hIcon
De greep van een pictogram.

Retourwaarde

De greep van een pictogram dat eerder aan de knop is gekoppeld.

Opmerkingen

Het pictogram wordt automatisch op het gezicht van de knop geplaatst, standaard gecentreerd. Als het pictogram te groot is voor de knop, wordt het aan beide zijden geknipt. U kunt andere uitlijningsopties kiezen, waaronder het volgende:

  • BS_TOP

  • BS_LEFT

  • BS_RIGHT

  • BS_CENTER

  • BS_BOTTOM

  • BS_VCENTER

In tegenstelling tot CBitmapButton, waarvoor vier bitmaps per knop worden gebruikt, SetIcon wordt slechts één pictogram per knop gebruikt. Wanneer de knop wordt ingedrukt, wordt het pictogram weergegeven om omlaag en naar rechts te schuiven.

Example

CButton myIconButton2;

// Create an icon button.
myIconButton2.Create(_T("My button"), WS_CHILD | WS_VISIBLE | BS_ICON,
                     CRect(10, 10, 60, 50), pParentWnd, 1);

// If no icon is defined for the button, define the icon to the
// system error icon.
if (myIconButton2.GetIcon() == NULL)
   myIconButton2.SetIcon(::LoadIcon(NULL, IDI_ERROR));

CButton::SetImageList

Roep deze methode aan om de lijst met afbeeldingen van het CButton object in te stellen.

BOOL SetImageList(PBUTTON_IMAGELIST pbuttonImagelist);

Parameterwaarden

pbuttonImagelist
Een aanwijzer naar de nieuwe lijst met afbeeldingen.

Retourwaarde

Retourneert TRUE bij succes, ONWAAR bij mislukt.

Opmerkingen

Deze lidfunctie emuleert de functionaliteit van het BCM_SETIMAGELIST bericht, zoals beschreven in de sectie Knoppen van de Windows SDK.

CButton::SetNote

Hiermee stelt u de notitietekst voor het huidige besturingselement voor opdrachtkoppeling in.

BOOL SetNote(LPCTSTR lpszNote);

Parameterwaarden

lpszNote
[in] Wijs een Unicode-tekenreeks aan die is ingesteld als de notitietekst voor het besturingselement voor de opdrachtkoppeling.

Retourwaarde

WAAR als deze methode is geslaagd; anders, ONWAAR.

Opmerkingen

Gebruik deze methode alleen met besturingselementen waarvan de knopstijl is BS_COMMANDLINK of BS_DEFCOMMANDLINK.

Met deze methode wordt het BCM_SETNOTE bericht verzonden, dat wordt beschreven in de Windows SDK.

Example

Het eerste codevoorbeeld definieert de variabele, m_cmdLinkdie wordt gebruikt om programmatisch toegang te krijgen tot het besturingselement voor opdrachtkoppelingen. Deze variabele wordt gebruikt in het volgende voorbeeld.

public:
// Variable to access programmatically defined command link control.
CButton m_cmdLink;
// Variable to access programmatically defined split button control.
CButton m_splitButton;

In het volgende codevoorbeeld wordt de notitietekst voor het besturingselement voor de opdrachtkoppeling ingesteld.

// Set the command link text.
m_cmdLink.SetNote(_T("This is the command link note."));

CButton::SetSplitGlyph

Koppelt een opgegeven glyph aan het huidige besturingselement voor gesplitste knoppen.

BOOL SetSplitGlyph(TCHAR chGlyph);

Parameterwaarden

chGlyph
[in] Een teken dat het symbool opgeeft dat moet worden gebruikt als de vervolgkeuzepijl voor de splitsknop.

Retourwaarde

WAAR als deze methode is geslaagd; anders, ONWAAR.

Opmerkingen

Gebruik deze methode alleen met besturingselementen met de knopstijl BS_SPLITBUTTON of BS_DEFSPLITBUTTON.

Een symbool is de fysieke weergave van een teken in een bepaald lettertype. De parameter chGlyph wordt niet gebruikt als de glyph, maar wordt in plaats daarvan gebruikt om een glyph te selecteren uit een set door het systeem gedefinieerde glyphs. De standaard vervolgkeuzepijl glyph wordt opgegeven door een teken '6' en lijkt op het Unicode-teken BLACK DOWN-POINTING DRIEHOEK (U+25BC).

Met deze methode wordt het mask lid van een BUTTON_SPLITINFO-structuur geïnitialiseerd met de vlag BCSIF_GLYPH en het himlGlyph lid met de parameter chGlyph . Vervolgens wordt die structuur verzonden in het BCM_GETSPLITINFO bericht dat wordt beschreven in de Windows SDK.

CButton::SetSplitImageList

Hiermee koppelt u een lijst met afbeeldingen aan het huidige besturingselement voor gesplitste knoppen.

BOOL SetSplitImageList(CImageList* pSplitImageList);

Parameterwaarden

pSplitImageList
[in] Aanwijzer naar een CImageList-object om toe te wijzen aan het huidige besturingselement voor gesplitste knoppen.

Retourwaarde

WAAR als deze methode is geslaagd; anders, ONWAAR.

Opmerkingen

Gebruik deze methode alleen met besturingselementen waarvan de knopstijl is BS_SPLITBUTTON of BS_DEFSPLITBUTTON.

Met deze methode wordt het mask lid van een BUTTON_SPLITINFO structuur geïnitialiseerd met de vlag BCSIF_IMAGE en het himlGlyph lid met de parameter pSplitImageList . Vervolgens wordt die structuur verzonden in het BCM_GETSPLITINFO bericht dat wordt beschreven in de Windows SDK.

CButton::SetSplitInfo

Hiermee geeft u parameters op die bepalen hoe Windows het huidige besturingselement splitsknop tekent.

BOOL SetSplitInfo(PBUTTON_SPLITINFO pInfo);

Parameterwaarden

Pinfo
[in] Wijs een BUTTON_SPLITINFO structuur aan waarmee het huidige besturingselement voor gesplitste knoppen wordt gedefinieerd.

Retourwaarde

WAAR als deze methode is geslaagd; anders, ONWAAR.

Opmerkingen

Gebruik deze methode alleen met besturingselementen waarvan de knopstijl is BS_SPLITBUTTON of BS_DEFSPLITBUTTON.

Met deze methode wordt het BCM_SETSPLITINFO bericht verzonden, dat wordt beschreven in de Windows SDK.

Example

In het eerste codevoorbeeld wordt de variabele gedefinieerd, m_splitButtondie wordt gebruikt om programmatisch toegang te krijgen tot het besturingselement voor gesplitste knoppen.

public:
// Variable to access programmatically defined command link control.
CButton m_cmdLink;
// Variable to access programmatically defined split button control.
CButton m_splitButton;

In het volgende codevoorbeeld wordt het symbool gewijzigd dat wordt gebruikt voor de vervolgkeuzepijl voor de splitsknop. In het voorbeeld wordt een omhoog wijzende driehoeksglyf vervangen door de standaard driehoeksdriehoek met een omlaag wijzend driehoekje. Het symbool dat wordt weergegeven, is afhankelijk van het teken dat u opgeeft in het himlGlyph lid van de BUTTON_SPLITINFO structuur. De driehoeksglyf met omlaag wijzen wordt opgegeven door een teken '6' en het omhoog wijzende driehoeksglyf wordt opgegeven door een teken '5'. Zie de gemaksmethode CButton::SetSplitGlyph ter vergelijking.

/* 
   The drop-down arrow glyph is a function of the specified character. 
   The default "down" drop-down arrow glyph is specified by a 
   character '6'. Set the "up" arrow glyph, which is a character '5'.
   See the convenience method, SetSplitGlyph(), for comparison.
   */
BUTTON_SPLITINFO bsInfo = {0};
bsInfo.mask = BCSIF_GLYPH;
TCHAR chGlyph = _T('5'); // "up" arrow glyph
bsInfo.himlGlyph = (HIMAGELIST)chGlyph;
bRC = m_splitButton.SetSplitInfo(&bsInfo);

CButton::SetSplitSize

Hiermee stelt u de begrenzingsrechthoek van de vervolgkeuzelijst van het huidige besturingselement splitsknop in.

BOOL SetSplitSize(LPSIZE pSize);

Parameterwaarden

pSize
[in] Wijs een groottestructuur aan waarmee een begrenzingsrechthoek wordt beschreven.

Retourwaarde

WAAR als deze methode is geslaagd; anders, ONWAAR.

Opmerkingen

Gebruik deze methode alleen met besturingselementen waarvan de knopstijl is BS_SPLITBUTTON of BS_DEFSPLITBUTTON.

Wanneer het besturingselement voor gesplitste knoppen is uitgevouwen, kan er een vervolgkeuzelijst worden weergegeven, zoals een besturingselement voor lijsten of paginabesturingselementen. Met deze methode geeft u de grootte op van de begrenzingsrechthoek die het vervolgkeuzeonderdeel bevat.

Met deze methode wordt het mask lid van een BUTTON_SPLITINFO structuur geïnitialiseerd met de vlag BCSIF_SIZE en het size lid met de parameter pSize . Vervolgens wordt die structuur verzonden in het BCM_GETSPLITINFO bericht dat wordt beschreven in de Windows SDK.

Example

In het eerste codevoorbeeld wordt de variabele gedefinieerd, m_splitButtondie wordt gebruikt om programmatisch toegang te krijgen tot het besturingselement voor gesplitste knoppen. Deze variabele wordt gebruikt in het volgende voorbeeld.

public:
// Variable to access programmatically defined command link control.
CButton m_cmdLink;
// Variable to access programmatically defined split button control.
CButton m_splitButton;

In het volgende codevoorbeeld wordt de grootte van de vervolgkeuzepijl voor de splitsknop verdubbeld.

// Double the size of the split button drop-down arrow.
SIZE sz;
bRC = m_splitButton.GetSplitSize(&sz); // current size
sz.cx = sz.cx * 2;
sz.cy = sz.cy * 2;
bRC = m_splitButton.SetSplitSize(&sz);

CButton::SetSplitStyle

Hiermee stelt u de stijl van het huidige besturingselement voor gesplitste knoppen in.

BOOL SetSplitStyle(UINT uSplitStyle);

Parameterwaarden

uSplitStyle
[in] Een bitsgewijze combinatie van gesplitste knopstijlen. Zie het uSplitStyle lid van de BUTTON_SPLITINFO structuur voor meer informatie.

Retourwaarde

WAAR als deze methode is geslaagd; anders, ONWAAR.

Opmerkingen

Gebruik deze methode alleen met besturingselementen waarvan de knopstijl is BS_SPLITBUTTON of BS_DEFSPLITBUTTON.

Met de stijlen voor gesplitste knoppen geeft u de uitlijning, hoogte-breedteverhouding en grafische indeling op waarmee Windows een pictogram voor een gesplitste knop tekent. Zie het uSplitStyle lid van de BUTTON_SPLITINFO structuur voor meer informatie.

Met deze methode initialiseert u het mask lid van een BUTTON_SPLITINFO-structuur met de vlag BCSIF_STYLE en het uSplitStyle lid met de parameter uSplitStyle en verzendt u die structuur vervolgens in het BCM_GETSPLITINFO bericht dat wordt beschreven in de Windows SDK.

Example

In het eerste codevoorbeeld wordt de variabele gedefinieerd, m_splitButtondie wordt gebruikt om programmatisch toegang te krijgen tot het besturingselement voor gesplitste knoppen.

public:
// Variable to access programmatically defined command link control.
CButton m_cmdLink;
// Variable to access programmatically defined split button control.
CButton m_splitButton;

In het volgende codevoorbeeld wordt de stijl van de vervolgkeuzepijl voor de splitsknop ingesteld. De stijl BCSS_ALIGNLEFT geeft de pijl aan de linkerkant van de knop weer en de stijl BCSS_STRETCH behoudt de verhoudingen van de vervolgkeuzepijl wanneer u het formaat van de knop wijzigt.

/* 
    Set the style of the split button drop-down arrow: Display the 
    arrow on the left and retain the arrow's proportions when resizing 
    the control.
    */
bRC = m_splitButton.SetSplitStyle(BCSS_ALIGNLEFT | BCSS_STRETCH);

CButton::SetState

Hiermee stelt u in of een knop besturingselement al dan niet is gemarkeerd.

void SetState(BOOL bHighlight);

Parameterwaarden

bHighlight
Hiermee geeft u op of de knop moet worden gemarkeerd. Een niet-nulwaarde markeert de knop; met een 0-waarde worden markeringen verwijderd.

Opmerkingen

Markering is van invloed op de buitenkant van een knopbesturingselement. Dit heeft geen effect op de controlestatus van een keuzerondje of selectievakje.

Een besturingselement voor knoppen wordt automatisch gemarkeerd wanneer de gebruiker op de linkermuisknop klikt en vasthoudt. De markering wordt verwijderd wanneer de gebruiker de muisknop loslaat.

Example

CButton myPushButton;

// Create a push button.
myPushButton.Create(_T("My button"), WS_CHILD | WS_VISIBLE | BS_PUSHBUTTON,
                    CRect(10, 10, 100, 30), pParentWnd, 1);

// Invert the highlight state of the button.
myPushButton.SetState(!(myPushButton.GetState() & 0x0004));

CButton::SetTextMargin

Roep deze methode aan om de tekstmarge van het CButton object in te stellen.

BOOL SetTextMargin(RECT* pmargin);

Parameterwaarden

pmargin
Een aanwijzer naar de nieuwe tekstmarge.

Retourwaarde

Retourneert TRUE bij succes, ONWAAR bij mislukt.

Opmerkingen

Deze lidfunctie emuleert de functionaliteit van het BCM_SETTEXTMARGIN bericht, zoals beschreven in de sectie Knoppen van de Windows SDK.

Zie ook

CWnd-klasse
Hiërarchiegrafiek
CWnd-klasse
CComboBox-klasse
CEdit-klasse
CListBox-klasse
CScrollBar-klasse
CStatic-klasse
CBitmapButton-klasse
CDialog-klasse

  • Last updated on