Megosztás a következőn keresztül:


CPagerCtrl osztály

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

CObject

CCmdTarget

CWnd

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.

Lásd még

CPagerCtrl osztály
hierarchiadiagram
Pager-vezérlők