Share via


CPagerCtrl-klasse

Opmerking

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

De CPagerCtrl klasse verpakt het besturingselement Windows Pager, dat kan schuiven naar een ingesloten venster dat niet past bij het venster met inhoud.

Syntaxis

class CPagerCtrl : public CWnd

Leden

Openbare constructors

Naam Description
CPagerCtrl::CPagerCtrl Maakt een CPagerCtrl object.

Openbare methoden

Naam Description
CPagerCtrl::Maken Hiermee maakt u een pager-besturingselement met opgegeven stijlen en koppelt u dit aan het huidige CPagerCtrl object.
CPagerCtrl::CreateEx Hiermee maakt u een pager-besturingselement met opgegeven uitgebreide stijlen en koppelt u dit aan het huidige CPagerCtrl object.
CPagerCtrl::ForwardMouse Hiermee schakelt u het doorsturen van WM_MOUSEMOVE berichten in of uit naar het venster dat is opgenomen in het huidige pager-besturingselement.
CPagerCtrl::GetBkColor Haalt de achtergrondkleur van het huidige pager-besturingselement op.
CPagerCtrl::GetBorder Hiermee wordt de randgrootte van het huidige pager-besturingselement opgehaald.
CPagerCtrl::GetButtonSize Hiermee wordt de knopgrootte van het huidige pager-besturingselement opgehaald.
CPagerCtrl::GetButtonState Haalt de status van de opgegeven knop op in het huidige pager-besturingselement.
CPagerCtrl::GetDropTarget Haalt de IDropTarget-interface voor het huidige pagerbesturingselement op.
CPagerCtrl::GetScrollPos Hiermee haalt u de schuifpositie van het huidige pager-besturingselement op.
CPagerCtrl::IsButtonDepressed Geeft aan of de opgegeven knop van het huidige pager-besturingselement de pressed status heeft.
CPagerCtrl::IsButtonGrayed Geeft aan of de opgegeven knop van het huidige pager-besturingselement de grayed status heeft.
CPagerCtrl::IsButtonHot Geeft aan of de opgegeven knop van het huidige pager-besturingselement de hot status heeft.
CPagerCtrl::IsButtonInvisible Geeft aan of de opgegeven knop van het huidige pager-besturingselement de invisible status heeft.
CPagerCtrl::IsButtonNormal Geeft aan of de opgegeven knop van het huidige pager-besturingselement de normal status heeft.
CPagerCtrl::Herberekening Hiermee wordt ervoor gezorgd dat het huidige pagerbesturingselement de grootte van het ingesloten venster opnieuw berekent.
CPagerCtrl::SetBkColor Hiermee stelt u de achtergrondkleur van het huidige pager-besturingselement in.
CPagerCtrl::SetBorder Hiermee stelt u de randgrootte van het huidige pager-besturingselement in.
CPagerCtrl::SetButtonSize Hiermee stelt u de knopgrootte van het huidige pager-besturingselement in.
CPagerCtrl::SetChild Hiermee stelt u het ingesloten venster voor het huidige pager-besturingselement in.
CPagerCtrl::SetScrollPos Hiermee stelt u de schuifpositie van het huidige pager-besturingselement in.

Opmerkingen

Een pager-besturingselement is een venster dat een ander venster bevat dat lineair en groter is dan het venster dat het bevat, en waarmee u het ingesloten venster in beeld kunt schuiven. In het besturingselement pager worden twee schuifknoppen weergegeven die automatisch verdwijnen wanneer het ingesloten venster naar de meest verre gebieden wordt geschoven en anders opnieuw worden weergegeven. U kunt een pager-besturingselement maken dat horizontaal of verticaal schuift.

Als uw toepassing bijvoorbeeld een werkbalk heeft die niet breed genoeg is om alle items weer te geven, kunt u de werkbalk toewijzen aan een pager-besturingselement en kunnen gebruikers de werkbalk naar links of rechts schuiven om toegang te krijgen tot alle items. Microsoft Internet Explorer versie 4.0 (commctrl.dll versie 4.71) introduceert het pager-besturingselement.

De CPagerCtrl klasse is afgeleid van de klasse CWnd . Zie Pager-besturingselementen voor meer informatie en een afbeelding van een paginabesturingselement.

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CPagerCtrl

Requirements

Koptekst: afxcmn.h

CPagerCtrl::CPagerCtrl

Maakt een CPagerCtrl object.

CPagerCtrl();

Opmerkingen

Gebruik de methode CPagerCtrl::Create of CPagerCtrl::CreateEx om een pager-besturingselement te maken en deze aan het CPagerCtrl object te koppelen.

CPagerCtrl::Maken

Hiermee maakt u een pager-besturingselement met opgegeven stijlen en koppelt u dit aan het huidige CPagerCtrl object.

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

Parameterwaarden

dwStyle
[in] Een bitsgewijze combinatie (OR) van vensterstijlen en pager-besturingsstijlen die moeten worden toegepast op het besturingselement.

Rect
[in] Een verwijzing naar een RECT-structuur die de positie en grootte van het besturingselement in clientcoördinaten bevat.

pParentWnd
[in] Een aanwijzer naar een CWnd-object dat het bovenliggende venster van het besturingselement is. Deze parameter kan niet NULL zijn.

nID
[in] De id van het besturingselement.

Retourwaarde

WAAR als deze methode is geslaagd; anders, ONWAAR.

Opmerkingen

Als u een pager-besturingselement wilt maken, declareert u een CPagerCtrl variabele en roept u de methode CPagerCtrl::Create of CPagerCtrl::CreateEx op die variabele aan.

Example

In het volgende voorbeeld wordt een pagerbesturingselement gemaakt en vervolgens de methode CPagerCtrl::SetChild gebruikt om een zeer lang knopbesturingselement te koppelen aan het pagerbesturingselement. In het voorbeeld wordt vervolgens de methode CPagerCtrl::SetButtonSize gebruikt om de hoogte van het pager-besturingselement in te stellen op 20 pixels en de methode CPagerCtrl::SetBorder om de randdikte in te stellen op 1 pixel.

// Initialize the dropdown menu of the splitbutton control.
m_splitButton.SetDropDownMenu(IDR_MENU1, 0);

// Create the pager control.
BOOL nRet;
CRect rect;
GetClientRect(&rect);
nRet = m_pager.Create(
    (WS_VISIBLE | WS_CHILD | PGS_HORZ),
    CRect(rect.Width() / 4, 5, (rect.Width() * 3) / 4, 55),
    this,
    IDC_PAGER1);

m_pager.GetClientRect(&rect);
nRet = m_button.Create(
    _T("This is a very, very long button. 012345678901234567890"),
    (WS_VISIBLE | WS_CHILD), // Do not use CCS_NORESIZE.
    CRect(0, 0, rect.Width(), 30),
    &m_pager, IDC_BUTTON1);

m_pager.SetChild(m_button.m_hWnd);
m_pager.SetButtonSize(20);
m_pager.SetBorder(1);

CPagerCtrl::CreateEx

Hiermee maakt u een pager-besturingselement met opgegeven uitgebreide stijlen en koppelt u dit aan het huidige CPagerCtrl object.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameterwaarden

dwExStyle
[in] Een bitsgewijze combinatie van uitgebreide stijlen die op het besturingselement moeten worden toegepast. Zie de dwExStyle-parameter van de functie CreateWindowEx voor meer informatie.

dwStyle
[in] Een bitsgewijze combinatie (OR) van vensterstijlen en pager-besturingsstijlen die moeten worden toegepast op het besturingselement.

Rect
[in] Een verwijzing naar een RECT-structuur die de positie en grootte van het besturingselement in clientcoördinaten bevat.

pParentWnd
[in] Een aanwijzer naar een CWnd-object dat het bovenliggende venster van het besturingselement is. Deze parameter kan niet NULL zijn.

nID
[in] De id van het besturingselement.

Retourwaarde

WAAR als deze methode is geslaagd; anders, ONWAAR.

Opmerkingen

Als u een pager-besturingselement wilt maken, declareert u een CPagerCtrl variabele en roept u de methode CPagerCtrl::Create of CPagerCtrl::CreateEx op die variabele aan.

CPagerCtrl::ForwardMouse

Hiermee schakelt u het doorsturen van WM_MOUSEMOVE berichten in of uit naar het venster dat is opgenomen in het huidige pager-besturingselement.

void ForwardMouse(BOOL bForward);

Parameterwaarden

bForward
[in] WAAR als u muisberichten wilt doorsturen of ONWAAR om geen muisberichten door te sturen.

Opmerkingen

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

CPagerCtrl::GetBorder

Hiermee wordt de randgrootte van het huidige pager-besturingselement opgehaald.

int GetBorder() const;

Retourwaarde

De huidige randgrootte, gemeten in pixels.

Opmerkingen

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

Example

In het volgende voorbeeld wordt de methode CPagerCtrl::GetBorder gebruikt om de dikte van de rand van het pager-besturingselement op te halen.

void CCSplitButton_s2Dlg::OnXBorder()
{
   int borderSize = m_pager.GetBorder();
   CString str;
   str.Format(_T("The border is %d pixel(s) thick."), borderSize);
   MessageBox(str);
}

CPagerCtrl::GetBkColor

Haalt de achtergrondkleur van het huidige pager-besturingselement op.

COLORREF GetBkColor() const;

Retourwaarde

Een COLORREF-waarde die de huidige achtergrondkleur van het besturingselement pager bevat.

Opmerkingen

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

Example

In het volgende voorbeeld wordt de methode CPagerCtrl::SetBkColor gebruikt om de achtergrondkleur van het besturingselement pager in te stellen op rood en de methode CPagerCtrl::GetBkColor om te bevestigen dat de wijziging is aangebracht.

void CCSplitButton_s2Dlg::OnXColor()
{
   COLORREF originalColor;
   //  Set color to red.
   originalColor = m_pager.SetBkColor(RGB(255, 0, 0));
   if (m_pager.GetBkColor() != RGB(255, 0, 0))
   {
      MessageBox(_T("Control did not return RED as the previous color."));
   }
   // The following statement is one way to restore the color.
   // m_pager.SetBkColor( originalColor );
}

CPagerCtrl::GetButtonSize

Hiermee wordt de knopgrootte van het huidige pager-besturingselement opgehaald.

int GetButtonSize() const;

Retourwaarde

De huidige knopgrootte, gemeten in pixels.

Opmerkingen

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

Als het besturingselement pager de stijl PGS_HORZ heeft, bepaalt de knopgrootte de breedte van de pagerknoppen en bepaalt de knopgrootte de hoogte van de pagerknoppen als het besturingselement pager de stijl PGS_VERT heeft. Zie Pager Control Styles voor meer informatie.

CPagerCtrl::GetButtonState

Haalt de status van de opgegeven schuifknop op in het huidige pager-besturingselement.

DWORD GetButtonState(int iButton) const;

Parameterwaarden

iButton
[in] Geeft de knop aan waarvoor de status wordt opgehaald. Als de stijl van het besturingselement pager is PGS_HORZ, geeft u PGB_TOPORLEFT op voor de linkerknop en PGB_BOTTOMORRIGHT voor de rechterknop. Als de stijl van de pager-besturingselement is PGS_VERT, geeft u PGB_TOPORLEFT op voor de bovenste knop en PGB_BOTTOMORRIGHT voor de onderste knop. Zie Pager Control Styles voor meer informatie.

Retourwaarde

De status van de knop die is opgegeven door de parameter iButton . De status is PGF_INVISIBLE, PGF_NORMAL, PGF_GRAYED, PGF_DEPRESSED of PGF_HOT. Zie de sectie Retourwaarde van het PGM_GETBUTTONSTATE bericht voor meer informatie.

Opmerkingen

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

CPagerCtrl::GetDropTarget

Haalt de IDropTarget-interface voor het huidige pagerbesturingselement op.

IDropTarget* GetDropTarget() const;

Retourwaarde

Een aanwijzer naar de IDropTarget interface voor het huidige pager-besturingselement.

Opmerkingen

IDropTarget is een van de interfaces die u implementeert ter ondersteuning van slepen-en-neerzetten-bewerkingen in uw toepassing.

Met deze methode wordt het PGM_GETDROPTARGET bericht verzonden, dat wordt beschreven in de Windows SDK. De aanroeper van deze methode is verantwoordelijk voor het aanroepen van het Release lid van de IDropTarget-interface wanneer de interface niet meer nodig is.

CPagerCtrl::GetScrollPos

Hiermee haalt u de schuifpositie van het huidige pager-besturingselement op.

int GetScrollPos() const;

Retourwaarde

De huidige schuifpositie, gemeten in pixels.

Opmerkingen

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

Example

In het volgende voorbeeld wordt de methode CPagerCtrl::GetScrollPos gebruikt om de huidige schuifpositie van het besturingselement pager op te halen. Als het pager-besturingselement nog niet naar nul is geschoven, gebruikt het voorbeeld de methode CPagerCtrl::SetScrollPos om de schuifpositie in te stellen op nul.

void CCSplitButton_s2Dlg::OnXScrollposition()
{
   int pos;
   CString str;
   pos = m_pager.GetScrollPos();
   if (pos != 0)
      m_pager.SetScrollPos(0);
   str.Format(_T("Old position = %d; new position = 0"), pos);
   MessageBox(str);
}

CPagerCtrl::IsButtonDepressed

Geeft aan of de opgegeven schuifknop van het huidige pager-besturingselement de status Ingedrukt heeft.

BOOL IsButtonDepressed(int iButton) const;

Parameterwaarden

iButton
[in] Geeft de knop aan waarvoor de status wordt opgehaald. Als de stijl van het besturingselement pager is PGS_HORZ, geeft u PGB_TOPORLEFT op voor de linkerknop en PGB_BOTTOMORRIGHT voor de rechterknop. Als de stijl van de pager-besturingselement is PGS_VERT, geeft u PGB_TOPORLEFT op voor de bovenste knop en PGB_BOTTOMORRIGHT voor de onderste knop. Zie Pager Control Styles voor meer informatie.

Retourwaarde

WAAR als de opgegeven knop de status Ingedrukt heeft; anders, ONWAAR.

Opmerkingen

Met deze methode wordt het PGM_GETBUTTONSTATE bericht verzonden, dat wordt beschreven in de Windows SDK. Vervolgens wordt getest of de geretourneerde status PGF_DEPRESSED. Zie de sectie Retourwaarde van het PGM_GETBUTTONSTATE bericht voor meer informatie.

CPagerCtrl::IsButtonGrayed

Geeft aan of de opgegeven schuifknop van het huidige pager-besturingselement grijs is.

BOOL IsButtonGrayed(int iButton) const;

Parameterwaarden

iButton
[in] Geeft de knop aan waarvoor de status wordt opgehaald. Als de stijl van het besturingselement pager is PGS_HORZ, geeft u PGB_TOPORLEFT op voor de linkerknop en PGB_BOTTOMORRIGHT voor de rechterknop. Als de stijl van de pager-besturingselement is PGS_VERT, geeft u PGB_TOPORLEFT op voor de bovenste knop en PGB_BOTTOMORRIGHT voor de onderste knop. Zie Pager Control Styles voor meer informatie.

Retourwaarde

WAAR als de opgegeven knop grijs is; anders, ONWAAR.

Opmerkingen

Met deze methode wordt het PGM_GETBUTTONSTATE bericht verzonden, dat wordt beschreven in de Windows SDK. Vervolgens wordt getest of de geretourneerde status PGF_GRAYED. Zie de sectie Retourwaarde van het PGM_GETBUTTONSTATE bericht voor meer informatie.

CPagerCtrl::IsButtonHot

Hiermee wordt aangegeven of de opgegeven schuifknop van het huidige pager-besturingselement de dynamische status heeft.

BOOL IsButtonHot(int iButton) const;

Parameterwaarden

iButton
[in] Geeft de knop aan waarvoor de status wordt opgehaald. Als de stijl van het besturingselement pager is PGS_HORZ, geeft u PGB_TOPORLEFT op voor de linkerknop en PGB_BOTTOMORRIGHT voor de rechterknop. Als de stijl van de pager-besturingselement is PGS_VERT, geeft u PGB_TOPORLEFT op voor de bovenste knop en PGB_BOTTOMORRIGHT voor de onderste knop. Zie Pager Control Styles voor meer informatie.

Retourwaarde

WAAR als de opgegeven knop de dynamische status heeft; anders, ONWAAR.

Opmerkingen

Met deze methode wordt het PGM_GETBUTTONSTATE bericht verzonden, dat wordt beschreven in de Windows SDK. Vervolgens wordt getest of de geretourneerde status PGF_HOT is. Zie de sectie Retourwaarde van het PGM_GETBUTTONSTATE bericht voor meer informatie.

CPagerCtrl::IsButtonInvisible

Geeft aan of de opgegeven schuifknop van het huidige pager-besturingselement onzichtbaar is.

BOOL IsButtonInvisible(int iButton) const;

Parameterwaarden

iButton
[in] Geeft de knop aan waarvoor de status wordt opgehaald. Als de stijl van het besturingselement pager is PGS_HORZ, geeft u PGB_TOPORLEFT op voor de linkerknop en PGB_BOTTOMORRIGHT voor de rechterknop. Als de stijl van de pager-besturingselement is PGS_VERT, geeft u PGB_TOPORLEFT op voor de bovenste knop en PGB_BOTTOMORRIGHT voor de onderste knop. Zie Pager Control Styles voor meer informatie.

Retourwaarde

WAAR als de opgegeven knop onzichtbaar is; anders, ONWAAR.

Opmerkingen

Windows maakt de schuifknop in een bepaalde richting onzichtbaar wanneer het ingesloten venster naar de dichtstbijzijnde mate wordt geschoven, omdat het klikken op de knop verder niet meer van het ingesloten venster in beeld kan brengen.

Met deze methode wordt het PGM_GETBUTTONSTATE bericht verzonden, dat wordt beschreven in de Windows SDK. Vervolgens wordt getest of de geretourneerde status PGF_INVISIBLE. Zie de sectie Retourwaarde van het PGM_GETBUTTONSTATE bericht voor meer informatie.

Example

In het volgende voorbeeld wordt de methode CPagerCtrl::IsButtonInvisible gebruikt om te bepalen of de linker- en rechterschuifknoppen van het pager-besturingselement zichtbaar zijn.

void CCSplitButton_s2Dlg::OnXIsbuttoninvisible()
{
   BOOL bLeft = m_pager.IsButtonInvisible(PGB_TOPORLEFT);
   BOOL bRight = m_pager.IsButtonInvisible(PGB_BOTTOMORRIGHT);
   CString str;
   str.Format(_T("The left button is%s visible; the right button is%s visible."),
              (bLeft ? _T(" not") : _T("")),
              (bRight ? _T(" not") : _T("")));
   MessageBox(str);
}

CPagerCtrl::IsButtonNormal

Geeft aan of de opgegeven schuifknop van het huidige pager-besturingselement de normale status heeft.

BOOL IsButtonNormal(int iButton) const;

Parameterwaarden

iButton
[in] Geeft de knop aan waarvoor de status wordt opgehaald. Als de stijl van het besturingselement pager is PGS_HORZ, geeft u PGB_TOPORLEFT op voor de linkerknop en PGB_BOTTOMORRIGHT voor de rechterknop. Als de stijl van de pager-besturingselement is PGS_VERT, geeft u PGB_TOPORLEFT op voor de bovenste knop en PGB_BOTTOMORRIGHT voor de onderste knop. Zie Pager Control Styles voor meer informatie.

Retourwaarde

WAAR als de opgegeven knop de normale status heeft; anders, ONWAAR.

Opmerkingen

Met deze methode wordt het PGM_GETBUTTONSTATE bericht verzonden, dat wordt beschreven in de Windows SDK. Vervolgens wordt getest of de geretourneerde status PGF_NORMAL. Zie de sectie Retourwaarde van het PGM_GETBUTTONSTATE bericht voor meer informatie.

CPagerCtrl::Herberekening

Hiermee wordt ervoor gezorgd dat het huidige pagerbesturingselement de grootte van het ingesloten venster opnieuw berekent.

void RecalcSize();

Opmerkingen

Met deze methode wordt het PGM_RECALCSIZE bericht verzonden, dat wordt beschreven in de Windows SDK. Het besturingselement pager verzendt de PGN_CALCSIZE melding om de schuifbare afmetingen van het ingesloten venster te verkrijgen.

Voorbeeld 1

In het volgende voorbeeld wordt de methode CPagerCtrl::RecalcSize gebruikt om het huidige pagerbesturingselement aan te vragen om de grootte opnieuw te berekenen.

void CCSplitButton_s2Dlg::OnXRecalcsize()
{
   // If the child control changes size, call RecalcSize() to change
   // the size of the pager control accordingly.
   m_pager.RecalcSize();
   MessageBox(_T("The pager control size has been recalculated."));
}

Voorbeeld 2

In het volgende voorbeeld wordt berichtspiegeling gebruikt om het pagerbesturingselement in staat te stellen een eigen grootte opnieuw te berekenen in plaats van dat het bovenliggende dialoogvenster van het besturingselement de berekening moet uitvoeren. In het voorbeeld wordt de MyPagerCtrl klasse afgeleid van de klasse CPagerCtrl en wordt vervolgens een berichttoewijzing gebruikt om de PGN_CALCSIZE melding te koppelen aan de OnCalcsize meldingshandler. In dit voorbeeld stelt de meldingshandler de breedte en hoogte van het pager-besturingselement in op vaste waarden.

BEGIN_MESSAGE_MAP(CMyPagerCtrl, CPagerCtrl)
ON_NOTIFY_REFLECT(PGN_CALCSIZE, &CMyPagerCtrl::OnCalcSize)
END_MESSAGE_MAP()

// CMyPagerCtrl message handlers
void CMyPagerCtrl::OnCalcSize(NMHDR *code, LRESULT *param)
{
   // If the control contained in the pager control changes size, use this
   // handler to change the size of the pager control accordingly.

   LPNMPGCALCSIZE tmp = (LPNMPGCALCSIZE)code;
   *param = 0;
   tmp->iWidth = 500;
   tmp->iHeight = 50;
}

CPagerCtrl::SetBkColor

Hiermee stelt u de achtergrondkleur van het huidige pager-besturingselement in.

COLORREF SetBkColor(COLORREF clrBk);

Parameterwaarden

clrBk
[in] Een COLORREF-waarde die de nieuwe achtergrondkleur van het besturingselement pager bevat.

Retourwaarde

Een COLORREF-waarde die de vorige achtergrondkleur van het besturingselement pager bevat.

Opmerkingen

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

Example

In het volgende voorbeeld wordt de methode CPagerCtrl::SetBkColor gebruikt om de achtergrondkleur van het besturingselement pager in te stellen op rood en de methode CPagerCtrl::GetBkColor om te bevestigen dat de wijziging is aangebracht.

void CCSplitButton_s2Dlg::OnXColor()
{
   COLORREF originalColor;
   //  Set color to red.
   originalColor = m_pager.SetBkColor(RGB(255, 0, 0));
   if (m_pager.GetBkColor() != RGB(255, 0, 0))
   {
      MessageBox(_T("Control did not return RED as the previous color."));
   }
   // The following statement is one way to restore the color.
   // m_pager.SetBkColor( originalColor );
}

CPagerCtrl::SetBorder

Hiermee stelt u de randgrootte van het huidige pager-besturingselement in.

int SetBorder(int iBorder);

Parameterwaarden

iBorder
[in] De nieuwe randgrootte, gemeten in pixels. Als de parameter iBorder negatief is, wordt de randgrootte ingesteld op nul.

Retourwaarde

De vorige randgrootte, gemeten in pixels.

Opmerkingen

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

Example

In het volgende voorbeeld wordt een pagerbesturingselement gemaakt en vervolgens de methode CPagerCtrl::SetChild gebruikt om een zeer lang knopbesturingselement te koppelen aan het pagerbesturingselement. In het voorbeeld wordt vervolgens de methode CPagerCtrl::SetButtonSize gebruikt om de hoogte van het pager-besturingselement in te stellen op 20 pixels en de methode CPagerCtrl::SetBorder om de randdikte in te stellen op 1 pixel.

// Initialize the dropdown menu of the splitbutton control.
m_splitButton.SetDropDownMenu(IDR_MENU1, 0);

// Create the pager control.
BOOL nRet;
CRect rect;
GetClientRect(&rect);
nRet = m_pager.Create(
    (WS_VISIBLE | WS_CHILD | PGS_HORZ),
    CRect(rect.Width() / 4, 5, (rect.Width() * 3) / 4, 55),
    this,
    IDC_PAGER1);

m_pager.GetClientRect(&rect);
nRet = m_button.Create(
    _T("This is a very, very long button. 012345678901234567890"),
    (WS_VISIBLE | WS_CHILD), // Do not use CCS_NORESIZE.
    CRect(0, 0, rect.Width(), 30),
    &m_pager, IDC_BUTTON1);

m_pager.SetChild(m_button.m_hWnd);
m_pager.SetButtonSize(20);
m_pager.SetBorder(1);

CPagerCtrl::SetButtonSize

Hiermee stelt u de knopgrootte van het huidige pager-besturingselement in.

int SetButtonSize(int iButtonSize);

Parameterwaarden

iButtonSize
[in] De nieuwe knopgrootte, gemeten in pixels.

Retourwaarde

De vorige knopgrootte, gemeten in pixels.

Opmerkingen

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

Als het besturingselement pager de stijl PGS_HORZ heeft, bepaalt de knopgrootte de breedte van de pagerknoppen en bepaalt de knopgrootte de hoogte van de pagerknoppen als het besturingselement pager de stijl PGS_VERT heeft. De standaardknopgrootte is drie-vierde van de breedte van de schuifbalk en de minimale knopgrootte is 12 pixels. Zie Pager Control Styles voor meer informatie.

Example

In het volgende voorbeeld wordt een pagerbesturingselement gemaakt en vervolgens de methode CPagerCtrl::SetChild gebruikt om een zeer lang knopbesturingselement te koppelen aan het pagerbesturingselement. In het voorbeeld wordt vervolgens de methode CPagerCtrl::SetButtonSize gebruikt om de hoogte van het pager-besturingselement in te stellen op 20 pixels en de methode CPagerCtrl::SetBorder om de randdikte in te stellen op 1 pixel.

// Initialize the dropdown menu of the splitbutton control.
m_splitButton.SetDropDownMenu(IDR_MENU1, 0);

// Create the pager control.
BOOL nRet;
CRect rect;
GetClientRect(&rect);
nRet = m_pager.Create(
    (WS_VISIBLE | WS_CHILD | PGS_HORZ),
    CRect(rect.Width() / 4, 5, (rect.Width() * 3) / 4, 55),
    this,
    IDC_PAGER1);

m_pager.GetClientRect(&rect);
nRet = m_button.Create(
    _T("This is a very, very long button. 012345678901234567890"),
    (WS_VISIBLE | WS_CHILD), // Do not use CCS_NORESIZE.
    CRect(0, 0, rect.Width(), 30),
    &m_pager, IDC_BUTTON1);

m_pager.SetChild(m_button.m_hWnd);
m_pager.SetButtonSize(20);
m_pager.SetBorder(1);

CPagerCtrl::SetChild

Hiermee stelt u het ingesloten venster voor het huidige pager-besturingselement in.

void SetChild(HWND hwndChild);

Parameterwaarden

hwndChild
[in] Greep naar het venster dat moet worden opgenomen.

Opmerkingen

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

Met deze methode wordt het bovenliggende venster van het ingesloten venster niet gewijzigd; er wordt alleen een venstergreep toegewezen aan het pager-besturingselement voor schuiven. In de meeste gevallen is het ingesloten venster een onderliggend venster van het besturingselement pager.

Example

In het volgende voorbeeld wordt een pagerbesturingselement gemaakt en vervolgens de methode CPagerCtrl::SetChild gebruikt om een zeer lang knopbesturingselement te koppelen aan het pagerbesturingselement. In het voorbeeld wordt vervolgens de methode CPagerCtrl::SetButtonSize gebruikt om de hoogte van het pager-besturingselement in te stellen op 20 pixels en de methode CPagerCtrl::SetBorder om de randdikte in te stellen op 1 pixel.

// Initialize the dropdown menu of the splitbutton control.
m_splitButton.SetDropDownMenu(IDR_MENU1, 0);

// Create the pager control.
BOOL nRet;
CRect rect;
GetClientRect(&rect);
nRet = m_pager.Create(
    (WS_VISIBLE | WS_CHILD | PGS_HORZ),
    CRect(rect.Width() / 4, 5, (rect.Width() * 3) / 4, 55),
    this,
    IDC_PAGER1);

m_pager.GetClientRect(&rect);
nRet = m_button.Create(
    _T("This is a very, very long button. 012345678901234567890"),
    (WS_VISIBLE | WS_CHILD), // Do not use CCS_NORESIZE.
    CRect(0, 0, rect.Width(), 30),
    &m_pager, IDC_BUTTON1);

m_pager.SetChild(m_button.m_hWnd);
m_pager.SetButtonSize(20);
m_pager.SetBorder(1);

CPagerCtrl::SetScrollPos

Hiermee stelt u de schuifpositie van het huidige pager-besturingselement in.

void SetScrollPos(int iPos);

Parameterwaarden

Ipo
[in] De nieuwe schuifpositie, gemeten in pixels.

Opmerkingen

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

Zie ook

CPagerCtrl-klasse
Hiërarchiegrafiek
Pager-besturingselementen