Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
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
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