Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Megjegyzés:
A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.
Az CPagerCtrl osztály körbefuttatja a Windows lapozó vezérlőt, amely görgetéssel megjeleníthet egy olyan tartalmazott ablakot, amely nem fér el a tárolóablakban.
Szemantika
class CPagerCtrl : public CWnd
Tagok
Nyilvános konstruktorok
| Név | Description |
|---|---|
| CPagerCtrl::CPagerCtrl | Egy CPagerCtrl objektumot hoz létre. |
Nyilvános metódusok
| Név | Description |
|---|---|
| CPagerCtrl::Létrehozás | Létrehoz egy lapozóvezérlőt a megadott stílusokkal, és csatolja az aktuális CPagerCtrl objektumhoz. |
| CPagerCtrl::CreateEx | Létrehoz egy lapozóvezérlőt a megadott kiterjesztett stílusokkal, és csatolja az aktuális CPagerCtrl objektumhoz. |
| CPagerCtrl::ForwardMouse | Engedélyezi vagy letiltja WM_MOUSEMOVE üzenetek továbbítását az aktuális lapozó vezérlőelemben található ablakba. |
| CPagerCtrl::GetBkColor | Lekéri az aktuális lapozó vezérlőelem háttérszínét. |
| CPagerCtrl::GetBorder | Lekéri az aktuális lapozóvezérlő szegélyméretét. |
| CPagerCtrl::GetButtonSize | Lekéri az aktuális lapozóvezérlő gombméretét. |
| CPagerCtrl::GetButtonState | Lekéri a megadott gomb állapotát az aktuális lapozó vezérlőelemben. |
| CPagerCtrl::GetDropTarget | Lekéri az aktuális lapozóvezérlő IDropTarget felületét. |
| CPagerCtrl::GetScrollPos | Lekéri az aktuális lapozó vezérlőelem görgetési pozícióját. |
| CPagerCtrl::IsButtonDepressed | Azt jelzi, hogy az aktuális lapozó vezérlőelem megadott gombja állapotban pressed van-e. |
| CPagerCtrl::IsButtonGrayed | Azt jelzi, hogy az aktuális lapozó vezérlőelem megadott gombja állapotban grayed van-e. |
| CPagerCtrl::IsButtonHot | Azt jelzi, hogy az aktuális lapozó vezérlőelem megadott gombja állapotban hot van-e. |
| CPagerCtrl::IsButtonInvisible | Azt jelzi, hogy az aktuális lapozó vezérlőelem megadott gombja állapotban invisible van-e. |
| CPagerCtrl::IsButtonNormal | Azt jelzi, hogy az aktuális lapozó vezérlőelem megadott gombja állapotban normal van-e. |
| CPagerCtrl::RecalcSize | Az aktuális lapozó vezérlőelem újraszámítja a benne foglalt ablak méretét. |
| CPagerCtrl::SetBkColor | Az aktuális lapozó vezérlőelem háttérszínét állítja be. |
| CPagerCtrl::SetBorder | Az aktuális lapozó vezérlőelem szegélyméretét állítja be. |
| CPagerCtrl::SetButtonSize | Beállítja az aktuális lapozóvezérlő gombméretét. |
| CPagerCtrl::SetChild | Beállítja az aktuális lapozó vezérlőelem tartalmazott ablakát. |
| CPagerCtrl::SetScrollPos | Az aktuális lapozó vezérlőelem görgetési pozícióját állítja be. |
Megjegyzések
A lapozó vezérlőelem egy olyan ablak, amely egy másik, lineáris és nagyobb ablakot tartalmaz, mint az azt tartalmazó ablak, és lehetővé teszi a tartalmazott ablak nézetbe görgetését. A lapozó vezérlőelem két görgetőgombot jelenít meg, amelyek automatikusan eltűnnek, ha a benne lévő ablakot a legtávolabbra görgetik, és máskülönben újra megjelennek. Létrehozhat egy lapozóvezérlőt, amely vízszintesen vagy függőlegesen görget.
Ha például az alkalmazás olyan eszköztárral rendelkezik, amely nem elég széles az összes elem megjelenítéséhez, hozzárendelheti az eszköztárat egy lapozóvezérlőhöz, és a felhasználók az eszköztárat balra vagy jobbra görgetve elérhetik az összes elemet. A Microsoft Internet Explorer 4.0-s verziója (commctrl.dll 4.71-es verzió) bevezeti a lapozó vezérlőt.
Az CPagerCtrl osztály a CWnd osztályból származik . További információkért és egy lapozó vezérlőelem illusztrációja: Pager Controls.
Öröklési hierarchia
CPagerCtrl
Requirements
Fejléc: afxcmn.h
CPagerCtrl::CPagerCtrl
Egy CPagerCtrl objektumot hoz létre.
CPagerCtrl();
Megjegyzések
A CPagerCtrl::Create vagy CPagerCtrl::CreateEx metódussal hozzon létre egy lapozóvezérlőt, és csatolja az CPagerCtrl objektumhoz.
CPagerCtrl::Létrehozás
Létrehoz egy lapozóvezérlőt a megadott stílusokkal, és csatolja az aktuális CPagerCtrl objektumhoz.
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Paraméterek
dwStyle
[in] A vezérlőelemre alkalmazni kívánt ablakstílusok és lapozóvezérlő-stílusok bitenkénti kombinációja (OR).
téglalap
[in] Hivatkozás egy RECT-struktúrára , amely tartalmazza a vezérlő helyét és méretét az ügyfélkoordinátákban.
pParentWnd
[in] Mutató egy CWnd objektumra, amely a vezérlő szülőablaka. Ez a paraméter nem lehet NULL értékű.
nID
[in] A vezérlő azonosítója.
Visszaadott érték
IGAZ, ha ez a módszer sikeres; egyéb esetben HAMIS.
Megjegyzések
Lapozó vezérlőelem létrehozásához deklaráljon egy CPagerCtrl változót, majd hívja meg a CPagerCtrl::Create vagy CPagerCtrl::CreateEx metódust a változón.
Example
Az alábbi példa létrehoz egy lapozóvezérlőt, majd a CPagerCtrl::SetChild metódussal társít egy nagyon hosszú gombvezérlőt a lapozó vezérlőelemhez. A példa ezután a CPagerCtrl::SetButtonSize metódust használja a lapozóvezérlő magasságának 20 képpontra való beállításához, a CPagerCtrl::SetBorder metódus pedig 1 képpontra állítja a szegély vastagságát.
// 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
Létrehoz egy lapozóvezérlőt a megadott kiterjesztett stílusokkal, és csatolja az aktuális CPagerCtrl objektumhoz.
virtual BOOL CreateEx(
DWORD dwExStyle,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Paraméterek
dwExStyle
[in] A vezérlőelemre alkalmazni kívánt kiterjesztett stílusok bitenkénti kombinációja. További információ: a CreateWindowEx függvény dwExStyle paramétere.
dwStyle
[in] A vezérlőelemre alkalmazni kívánt ablakstílusok és lapozóvezérlő-stílusok bitenkénti kombinációja (OR).
téglalap
[in] Hivatkozás egy RECT-struktúrára , amely tartalmazza a vezérlő helyét és méretét az ügyfélkoordinátákban.
pParentWnd
[in] Mutató egy CWnd objektumra, amely a vezérlő szülőablaka. Ez a paraméter nem lehet NULL értékű.
nID
[in] A vezérlő azonosítója.
Visszaadott érték
IGAZ, ha ez a módszer sikeres; egyéb esetben HAMIS.
Megjegyzések
Lapozó vezérlőelem létrehozásához deklaráljon egy CPagerCtrl változót, majd hívja meg a CPagerCtrl::Create vagy CPagerCtrl::CreateEx metódust a változón.
CPagerCtrl::ForwardMouse
Engedélyezi vagy letiltja WM_MOUSEMOVE üzenetek továbbítását az aktuális lapozó vezérlőelemben található ablakba.
void ForwardMouse(BOOL bForward);
Paraméterek
bForward
[in] IGAZ az egérüzenetek továbbításához, a HAMIS érték pedig az egérüzenetek továbbításának tiltásához.
Megjegyzések
Ez a metódus elküldi a Windows SDK-ban leírt PGM_FORWARDMOUSE üzenetet.
CPagerCtrl::GetBorder
Lekéri az aktuális lapozóvezérlő szegélyméretét.
int GetBorder() const;
Visszaadott érték
Az aktuális szegélyméret képpontban mérve.
Megjegyzések
Ez a metódus elküldi a Windows SDK-ban leírt PGM_GETBORDER üzenetet.
Example
Az alábbi példa a CPagerCtrl::GetBorder metódust használja a lapozóvezérlő szegélyének vastagságának lekéréséhez.
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
Lekéri az aktuális lapozó vezérlőelem háttérszínét.
COLORREF GetBkColor() const;
Visszaadott érték
A pager vezérlőelem aktuális háttérszínét tartalmazó COLORREF érték.
Megjegyzések
Ez a metódus elküldi a Windows SDK-ban leírt PGM_GETBKCOLOR üzenetet.
Example
A következő példa a CPagerCtrl::SetBkColor metódust használja a lapozóvezérlő háttérszínének pirosra való beállításához, a CPagerCtrl::GetBkColor metódus pedig a módosítás megerősítéséhez.
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
Lekéri az aktuális lapozóvezérlő gombméretét.
int GetButtonSize() const;
Visszaadott érték
Az aktuális gombméret képpontban mérve.
Megjegyzések
Ez a metódus elküldi a Windows SDK-ban leírt PGM_GETBUTTONSIZE üzenetet.
Ha a lapozó vezérlőelem PGS_HORZ stílussal rendelkezik, a gombméret határozza meg a lapozógombok szélességét, és ha a lapozó vezérlőelem PGS_VERT stílussal rendelkezik, a gombméret határozza meg a lapozógombok magasságát. További információ: Pager Control Styles.
CPagerCtrl::GetButtonState
Lekéri a megadott görgetőgomb állapotát az aktuális lapozóvezérlőben.
DWORD GetButtonState(int iButton) const;
Paraméterek
iButton
[in] Azt a gombot jelzi, amelyhez az állapot be van kérve. Ha a lapozó vezérlőelem stílusa PGS_HORZ, adja meg a bal oldali gomb PGB_TOPORLEFT, a jobb gombbal pedig PGB_BOTTOMORRIGHT. Ha a lapozó vezérlőelem stílusa PGS_VERT, adja meg a felső gomb PGB_TOPORLEFT és az alsó gomb PGB_BOTTOMORRIGHT. További információ: Pager Control Styles.
Visszaadott érték
Az iButton paraméter által megadott gomb állapota. Az állapot vagy PGF_INVISIBLE, PGF_NORMAL, PGF_GRAYED, PGF_DEPRESSED vagy PGF_HOT. További információt a PGM_GETBUTTONSTATE üzenet Visszatérési érték szakaszában talál.
Megjegyzések
Ez a metódus elküldi a Windows SDK-ban leírt PGM_GETBUTTONSTATE üzenetet.
CPagerCtrl::GetDropTarget
Lekéri az aktuális lapozóvezérlő IDropTarget felületét.
IDropTarget* GetDropTarget() const;
Visszaadott érték
Az aktuális lapozóvezérlő felületére mutató mutató IDropTarget .
Megjegyzések
IDropTarget az egyik olyan felület, amelyet az alkalmazás húzási műveleteinek támogatására implementál.
Ez a metódus elküldi a Windows SDK-ban leírt PGM_GETDROPTARGET üzenetet. A metódus hívója felelős az ReleaseIDropTarget-felület tagjának meghívásáért, ha már nincs szükség a felületre.
CPagerCtrl::GetScrollPos
Lekéri az aktuális lapozó vezérlőelem görgetési pozícióját.
int GetScrollPos() const;
Visszaadott érték
Az aktuális görgetési pozíció képpontban mérve.
Megjegyzések
Ez a metódus elküldi a Windows SDK-ban leírt PGM_GETPOS üzenetet.
Example
Az alábbi példa a CPagerCtrl::GetScrollPos metódust használja a lapozóvezérlő aktuális görgetési pozíciójának lekéréséhez. Ha a lapozó vezérlőelem még nincs görgetve nullára, a bal szélső pozíció, a példa a CPagerCtrl::SetScrollPos metódust használja a görgetési pozíció nullára való beállításához.
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
Azt jelzi, hogy az aktuális lapozó vezérlőelem megadott görgetőgombja le van-e nyomva.
BOOL IsButtonDepressed(int iButton) const;
Paraméterek
iButton
[in] Azt a gombot jelzi, amelyhez az állapot be van kérve. Ha a lapozó vezérlőelem stílusa PGS_HORZ, adja meg a bal oldali gomb PGB_TOPORLEFT, a jobb gombbal pedig PGB_BOTTOMORRIGHT. Ha a lapozó vezérlőelem stílusa PGS_VERT, adja meg a felső gomb PGB_TOPORLEFT és az alsó gomb PGB_BOTTOMORRIGHT. További információ: Pager Control Styles.
Visszaadott érték
IGAZ, ha a megadott gomb le van nyomva; egyéb esetben HAMIS.
Megjegyzések
Ez a metódus elküldi a Windows SDK-ban leírt PGM_GETBUTTONSTATE üzenetet. Ezután ellenőrzi, hogy a visszaadott állapot PGF_DEPRESSED-e. További információt a PGM_GETBUTTONSTATE üzenet Visszatérési érték szakaszában talál.
CPagerCtrl::IsButtonGrayed
Azt jelzi, hogy az aktuális lapozó vezérlőelem megadott görgetőgombja szürkén jelenik-e meg.
BOOL IsButtonGrayed(int iButton) const;
Paraméterek
iButton
[in] Azt a gombot jelzi, amelyhez az állapot be van kérve. Ha a lapozó vezérlőelem stílusa PGS_HORZ, adja meg a bal oldali gomb PGB_TOPORLEFT, a jobb gombbal pedig PGB_BOTTOMORRIGHT. Ha a lapozó vezérlőelem stílusa PGS_VERT, adja meg a felső gomb PGB_TOPORLEFT és az alsó gomb PGB_BOTTOMORRIGHT. További információ: Pager Control Styles.
Visszaadott érték
IGAZ, ha a megadott gomb szürkés állapotban van; egyéb esetben HAMIS.
Megjegyzések
Ez a metódus elküldi a Windows SDK-ban leírt PGM_GETBUTTONSTATE üzenetet. Ezután ellenőrzi, hogy a visszaadott állapot PGF_GRAYED-e. További információt a PGM_GETBUTTONSTATE üzenet Visszatérési érték szakaszában talál.
CPagerCtrl::IsButtonHot
Azt jelzi, hogy az aktuális lapozóvezérlő megadott görgetőgombja forró állapotban van-e.
BOOL IsButtonHot(int iButton) const;
Paraméterek
iButton
[in] Azt a gombot jelzi, amelyhez az állapot be van kérve. Ha a lapozó vezérlőelem stílusa PGS_HORZ, adja meg a bal oldali gomb PGB_TOPORLEFT, a jobb gombbal pedig PGB_BOTTOMORRIGHT. Ha a lapozó vezérlőelem stílusa PGS_VERT, adja meg a felső gomb PGB_TOPORLEFT és az alsó gomb PGB_BOTTOMORRIGHT. További információ: Pager Control Styles.
Visszaadott érték
IGAZ, ha a megadott gomb gyakori elérésű állapotban van; egyéb esetben HAMIS.
Megjegyzések
Ez a metódus elküldi a Windows SDK-ban leírt PGM_GETBUTTONSTATE üzenetet. Ezután ellenőrzi, hogy a visszaadott állapot PGF_HOT-e. További információt a PGM_GETBUTTONSTATE üzenet Visszatérési érték szakaszában talál.
CPagerCtrl::IsButtonInvisible
Azt jelzi, hogy az aktuális lapozó vezérlőelem megadott görgetőgombja láthatatlan állapotban van-e.
BOOL IsButtonInvisible(int iButton) const;
Paraméterek
iButton
[in] Azt a gombot jelzi, amelyhez az állapot be van kérve. Ha a lapozó vezérlőelem stílusa PGS_HORZ, adja meg a bal oldali gomb PGB_TOPORLEFT, a jobb gombbal pedig PGB_BOTTOMORRIGHT. Ha a lapozó vezérlőelem stílusa PGS_VERT, adja meg a felső gomb PGB_TOPORLEFT és az alsó gomb PGB_BOTTOMORRIGHT. További információ: Pager Control Styles.
Visszaadott érték
IGAZ, ha a megadott gomb láthatatlan állapotban van; egyéb esetben HAMIS.
Megjegyzések
A Windows egy adott irányban láthatatlanná teszi a görgetési gombot, ha a benne lévő ablak a legtávolabbi mértékben van görgetve, mert a gombra való kattintással nem jeleníthető meg több benne lévő ablak.
Ez a metódus elküldi a Windows SDK-ban leírt PGM_GETBUTTONSTATE üzenetet. Ezután ellenőrzi, hogy a visszaadott állapot PGF_INVISIBLE-e. További információt a PGM_GETBUTTONSTATE üzenet Visszatérési érték szakaszában talál.
Example
Az alábbi példa a CPagerCtrl::IsButtonInvisible metódust használja annak meghatározására, hogy a lapozóvezérlő bal és jobb görgetőgombjai láthatók-e.
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
Azt jelzi, hogy az aktuális lapozóvezérlő megadott görgetőgombja normál állapotban van-e.
BOOL IsButtonNormal(int iButton) const;
Paraméterek
iButton
[in] Azt a gombot jelzi, amelyhez az állapot be van kérve. Ha a lapozó vezérlőelem stílusa PGS_HORZ, adja meg a bal oldali gomb PGB_TOPORLEFT, a jobb gombbal pedig PGB_BOTTOMORRIGHT. Ha a lapozó vezérlőelem stílusa PGS_VERT, adja meg a felső gomb PGB_TOPORLEFT és az alsó gomb PGB_BOTTOMORRIGHT. További információ: Pager Control Styles.
Visszaadott érték
IGAZ, ha a megadott gomb normál állapotban van; egyéb esetben HAMIS.
Megjegyzések
Ez a metódus elküldi a Windows SDK-ban leírt PGM_GETBUTTONSTATE üzenetet. Ezután ellenőrzi, hogy a visszaadott állapot PGF_NORMAL-e. További információt a PGM_GETBUTTONSTATE üzenet Visszatérési érték szakaszában talál.
CPagerCtrl::RecalcSize
Az aktuális lapozó vezérlőelem újraszámítja a benne foglalt ablak méretét.
void RecalcSize();
Megjegyzések
Ez a metódus elküldi a Windows SDK-ban leírt PGM_RECALCSIZE üzenetet. Következésképpen a lapozó vezérlőelem elküldi a PGN_CALCSIZE értesítést a benne foglalt ablak görgethető dimenzióinak lekéréséhez.
1. példa
Az alábbi példa a CPagerCtrl::RecalcSize metódust használja a jelenlegi lapozóvezérlő kéréséhez a méret újraszámításához.
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."));
}
2. példa
Az alábbi példa üzenetvisszaveréssel teszi lehetővé, hogy a lapozó vezérlőelem újraszámolja a saját méretét, ahelyett, hogy a vezérlő szülő párbeszédpaneljét kellene megkövetelnie a számítás elvégzéséhez. A példa az osztályt MyPagerCtrl a CPagerCtrl osztályból származtatja, majd egy üzenettérkép használatával társítja a PGN_CALCSIZE értesítést az OnCalcsize értesítéskezelővel. Ebben a példában az értesítéskezelő rögzített értékekre állítja a lapozóvezérlő szélességét és magasságát.
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
Az aktuális lapozó vezérlőelem háttérszínét állítja be.
COLORREF SetBkColor(COLORREF clrBk);
Paraméterek
clrBk
[in] A pager vezérlőelem új háttérszínét tartalmazó COLORREF érték.
Visszaadott érték
COLORREF érték, amely a lapozó vezérlőelem előző háttérszínét tartalmazza.
Megjegyzések
Ez a metódus elküldi a Windows SDK-ban leírt PGM_SETBKCOLOR üzenetet.
Example
A következő példa a CPagerCtrl::SetBkColor metódust használja a lapozóvezérlő háttérszínének pirosra való beállításához, a CPagerCtrl::GetBkColor metódus pedig a módosítás megerősítéséhez.
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
Az aktuális lapozó vezérlőelem szegélyméretét állítja be.
int SetBorder(int iBorder);
Paraméterek
iBorder
[in] Az új szegélyméret képpontban mérve. Ha az iBorder paraméter negatív, a szegélyméret nullára van állítva.
Visszaadott érték
Az előző szegélyméret képpontban mérve.
Megjegyzések
Ez a metódus elküldi a Windows SDK-ban leírt PGM_SETBORDER üzenetet.
Example
Az alábbi példa létrehoz egy lapozóvezérlőt, majd a CPagerCtrl::SetChild metódussal társít egy nagyon hosszú gombvezérlőt a lapozó vezérlőelemhez. A példa ezután a CPagerCtrl::SetButtonSize metódust használja a lapozóvezérlő magasságának 20 képpontra való beállításához, a CPagerCtrl::SetBorder metódus pedig 1 képpontra állítja a szegély vastagságát.
// 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
Beállítja az aktuális lapozóvezérlő gombméretét.
int SetButtonSize(int iButtonSize);
Paraméterek
iButtonSize
[in] Az új gombméret képpontban mérve.
Visszaadott érték
Az előző gombméret képpontban mérve.
Megjegyzések
Ez a metódus elküldi a Windows SDK-ban leírt PGM_SETBUTTONSIZE üzenetet.
Ha a lapozó vezérlőelem PGS_HORZ stílussal rendelkezik, a gombméret határozza meg a lapozógombok szélességét, és ha a lapozó vezérlőelem PGS_VERT stílussal rendelkezik, a gombméret határozza meg a lapozógombok magasságát. Az alapértelmezett gombméret a görgetősáv szélességének háromnegyede, a minimális gombméret pedig 12 képpont. További információ: Pager Control Styles.
Example
Az alábbi példa létrehoz egy lapozóvezérlőt, majd a CPagerCtrl::SetChild metódussal társít egy nagyon hosszú gombvezérlőt a lapozó vezérlőelemhez. A példa ezután a CPagerCtrl::SetButtonSize metódust használja a lapozóvezérlő magasságának 20 képpontra való beállításához, a CPagerCtrl::SetBorder metódus pedig 1 képpontra állítja a szegély vastagságát.
// 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
Beállítja az aktuális lapozó vezérlőelem tartalmazott ablakát.
void SetChild(HWND hwndChild);
Paraméterek
hwndChild
[in] Fogópont a tárolni kívánt ablakhoz.
Megjegyzések
Ez a metódus elküldi a Windows SDK-ban leírt PGM_SETCHILD üzenetet.
Ez a metódus nem módosítja a tartalmazott ablak szülőét; csak egy ablakfogópontot rendel a lapozó vezérlőelemhez görgetéshez. A legtöbb esetben a tartalmazott ablak a lapozó vezérlőelem gyermekablaka lesz.
Example
Az alábbi példa létrehoz egy lapozóvezérlőt, majd a CPagerCtrl::SetChild metódussal társít egy nagyon hosszú gombvezérlőt a lapozó vezérlőelemhez. A példa ezután a CPagerCtrl::SetButtonSize metódust használja a lapozóvezérlő magasságának 20 képpontra való beállításához, a CPagerCtrl::SetBorder metódus pedig 1 képpontra állítja a szegély vastagságát.
// 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
Az aktuális lapozó vezérlőelem görgetési pozícióját állítja be.
void SetScrollPos(int iPos);
Paraméterek
iPos
[in] Az új görgetési pozíció képpontban mérve.
Megjegyzések
Ez a metódus elküldi a Windows SDK-ban leírt PGM_SETPOS üzenetet.