CPagerCtrl Sınıfı

CPagerCtrl sınıfı, Windows çağrı cihazı denetimini kaydırarak, içerilen pencereye uymayan bir içerilen pencereyi görüntülemeye kaydırabilir.

Sözdizimi

class CPagerCtrl : public CWnd

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CPagerCtrl::CPagerCtrl	Bir CPagerCtrl nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CPagerCtrl::Create	Belirtilen stiller ile bir çağrı aracı denetimi oluşturur ve bunu geçerli CPagerCtrl nesneye ekler.
CPagerCtrl::CreateEx	Belirtilen genişletilmiş stiller ile bir çağrı aracı denetimi oluşturur ve bunu geçerli CPagerCtrl nesneye ekler.
CPagerCtrl::ForwardMouse	WM_MOUSEMOVE iletilerinin geçerli çağrı aracı denetiminde yer alan pencereye iletilmesine olanak tanır veya devre dışı bırakır.
CPagerCtrl::GetBkColor	Geçerli çağrı aracı denetiminin arka plan rengini alır.
CPagerCtrl::GetBorder	Geçerli çağrı aracı denetiminin kenarlık boyutunu alır.
CPagerCtrl::GetButtonSize	Geçerli çağrı aracı denetiminin düğme boyutunu alır.
CPagerCtrl::GetButtonState	Geçerli çağrı aracı denetiminde belirtilen düğmenin durumunu alır.
CPagerCtrl::GetDropTarget	Geçerli çağrı aracı denetimi için IDropTarget arabirimini alır.
CPagerCtrl::GetScrollPos	Geçerli çağrı aracı denetiminin kaydırma konumunu alır.
CPagerCtrl::IsButtonDepressed	Geçerli çağrı aracı denetiminin pressed belirtilen düğmesinin durumunda olup olmadığını gösterir.
CPagerCtrl::IsButtonGrayed	Geçerli çağrı aracı denetiminin grayed belirtilen düğmesinin durumunda olup olmadığını gösterir.
CPagerCtrl::IsButtonHot	Geçerli çağrı aracı denetiminin hot belirtilen düğmesinin durumunda olup olmadığını gösterir.
CPagerCtrl::IsButtonInvisible	Geçerli çağrı aracı denetiminin invisible belirtilen düğmesinin durumunda olup olmadığını gösterir.
CPagerCtrl::IsButtonNormal	Geçerli çağrı aracı denetiminin normal belirtilen düğmesinin durumunda olup olmadığını gösterir.
CPagerCtrl::RecalcSize	Geçerli çağrı aracı denetiminin kapsanan pencerenin boyutunu yeniden hesaplamasına neden olur.
CPagerCtrl::SetBkColor	Geçerli çağrı aracı denetiminin arka plan rengini ayarlar.
CPagerCtrl::SetBorder	Geçerli çağrı aracı denetiminin kenarlık boyutunu ayarlar.
CPagerCtrl::SetButtonSize	Geçerli çağrı aracı denetiminin düğme boyutunu ayarlar.
CPagerCtrl::SetChild	Geçerli çağrı aracı denetimi için kapsanan pencereyi ayarlar.
CPagerCtrl::SetScrollPos	Geçerli çağrı aracı denetiminin kaydırma konumunu ayarlar.

Açıklamalar

Disk belleği denetimi, doğrusal ve içeren pencereden daha büyük olan başka bir pencere içeren ve kapsanan pencereyi görünüme kaydırmanızı sağlayan bir penceredir. Çağrı aracı denetimi, kapsanan pencere en uzak boyuta kaydırıldığında otomatik olarak kaybolan ve aksi halde yeniden görüntülenen iki kaydırma düğmesi görüntüler. Yatay veya dikey olarak kaydıran bir çağrı aracı denetimi oluşturabilirsiniz.

Örneğin, uygulamanızın tüm öğelerini gösterecek kadar geniş olmayan bir araç çubuğu varsa, araç çubuğunu bir disk belleği denetimine atayabilirsiniz ve kullanıcılar tüm öğelere erişmek için araç çubuğunu sola veya sağa kaydırabilir. Microsoft Internet Explorer Sürüm 4.0 (commctrl.dll sürüm 4.71) çağrı aracı denetimini tanıtır.

CPagerCtrl sınıfı CWnd sınıfından türetilir. Daha fazla bilgi ve bir çağrıyıcı denetiminin çizimi için bkz . Pager Denetimleri.

Devralma Hiyerarşisi

CObject

CCmdTarget

CWnd

CPagerCtrl

Gereksinimler

Üst bilgi: afxcmn.h

CPagerCtrl::CPagerCtrl

Bir CPagerCtrl nesne oluşturur.

CPagerCtrl();

Açıklamalar

CPagerCtrl::Create veya CPagerCtrl::CreateEx yöntemini kullanarak bir çağrı denetimi oluşturun ve bunu nesneye CPagerCtrl ekleyin.

CPagerCtrl::Create

Belirtilen stiller ile bir çağrı aracı denetimi oluşturur ve bunu geçerli CPagerCtrl nesneye ekler.

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

Parametreler

dwStyle
[in] Denetime uygulanacak pencere stillerinin ve disk belleği denetim stillerinin bit düzeyinde birleşimi (OR).

Rect
[in] İstemci koordinatlarındaki denetimin konumunu ve boyutunu içeren bir RECT yapısına başvuru.

pParentWnd
[in] Denetimin üst penceresi olan bir CWnd nesnesine işaretçi. Bu parametre NULL olamaz.

Nıd
[in] Denetimin kimliği.

Dönüş Değeri

Bu yöntem başarılı olursa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Disk belleği denetimi oluşturmak için bir CPagerCtrl değişken bildirin, ardından bu değişkende CPagerCtrl::Create veya CPagerCtrl::CreateEx yöntemini çağırın.

Örnek

Aşağıdaki örnek bir disk belleği denetimi oluşturur, ardından çok uzun bir düğme denetimini çağrı grubu denetimiyle ilişkilendirmek için CPagerCtrl::SetChild yöntemini kullanır. Örnek daha sonra CPagerCtrl::SetButtonSize yöntemini kullanarak disk belleği denetiminin yüksekliğini 20 piksele, CPagerCtrl::SetBorder yöntemini ise kenarlık kalınlığını 1 piksel olarak ayarlar.

// 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

Belirtilen genişletilmiş stiller ile bir çağrı aracı denetimi oluşturur ve bunu geçerli CPagerCtrl nesneye ekler.

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

Parametreler

dwExStyle
[in] Denetime uygulanacak genişletilmiş stillerin bit düzeyinde birleşimi. Daha fazla bilgi için CreateWindowEx işlevinin dwExStyle parametresine bakın.

dwStyle
[in] Denetime uygulanacak pencere stillerinin ve disk belleği denetim stillerinin bit düzeyinde birleşimi (OR).

Rect
[in] İstemci koordinatlarındaki denetimin konumunu ve boyutunu içeren bir RECT yapısına başvuru.

pParentWnd
[in] Denetimin üst penceresi olan bir CWnd nesnesine işaretçi. Bu parametre NULL olamaz.

Nıd
[in] Denetimin kimliği.

Dönüş Değeri

Bu yöntem başarılı olursa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Disk belleği denetimi oluşturmak için bir CPagerCtrl değişken bildirin, ardından bu değişkende CPagerCtrl::Create veya CPagerCtrl::CreateEx yöntemini çağırın.

CPagerCtrl::ForwardMouse

WM_MOUSEMOVE iletilerinin geçerli çağrı aracı denetiminde yer alan pencereye iletilmesine olanak tanır veya devre dışı bırakır.

void ForwardMouse(BOOL bForward);

Parametreler

bForward
[in] Fare iletilerini iletmek için TRUE veya fare iletilerini iletmemek için YANLIŞ.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan PGM_FORWARDMOUSE iletisini gönderir.

CPagerCtrl::GetBorder

Geçerli çağrı aracı denetiminin kenarlık boyutunu alır.

int GetBorder() const;

Dönüş Değeri

Piksel cinsinden ölçülen geçerli kenarlık boyutu.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan PGM_GETBORDER iletisini gönderir.

Örnek

Aşağıdaki örnekte, çağrı oluşturucu denetiminin kenarlığı kalınlığını almak için CPagerCtrl::GetBorder yöntemi kullanılır.

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

Geçerli çağrı aracı denetiminin arka plan rengini alır.

COLORREF GetBkColor() const;

Dönüş Değeri

Çağrı aracı denetiminin geçerli arka plan rengini içeren COLORREF değeri.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan PGM_GETBKCOLOR iletisini gönderir.

Örnek

Aşağıdaki örnek, çağrıyı yapan denetimin arka plan rengini kırmızı olarak ayarlamak için CPagerCtrl::SetBkColor yöntemini ve değişikliğin yapıldığını onaylamak için CPagerCtrl::GetBkColor yöntemini kullanır.

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

Geçerli çağrı aracı denetiminin düğme boyutunu alır.

int GetButtonSize() const;

Dönüş Değeri

Piksel cinsinden ölçülen geçerli düğme boyutu.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan PGM_GETBUTTONSIZE iletisini gönderir.

Çağrı aracı denetimi PGS_HORZ stiline sahipse, düğme boyutu çağrı aracı düğmelerinin genişliğini belirler ve disk belleği denetimi PGS_VERT stiline sahipse, düğme boyutu çağrı aracı düğmelerinin yüksekliğini belirler. Daha fazla bilgi için bkz . Pager Denetim Stilleri.

CPagerCtrl::GetButtonState

Geçerli çağrı aracı denetiminde belirtilen kaydırma düğmesinin durumunu alır.

DWORD GetButtonState(int iButton) const;

Parametreler

iButton
[in] Durumunun alındığı düğmeyi gösterir. Disk belleği denetim stili PGS_HORZ, sol düğme için PGB_TOPORLEFT ve sağ düğme için PGB_BOTTOMORRIGHT belirtin. Çağrı cihazı denetim stili PGS_VERT, üst düğme için PGB_TOPORLEFT ve alt düğme için PGB_BOTTOMORRIGHT belirtin. Daha fazla bilgi için bkz . Pager Denetim Stilleri.

Dönüş Değeri

iButton parametresi tarafından belirtilen düğmenin durumu. Durum PGF_INVISIBLE, PGF_NORMAL, PGF_GRAYED, PGF_DEPRESSED veya PGF_HOT. Daha fazla bilgi için PGM_GETBUTTONSTATE iletisinin Dönüş Değeri bölümüne bakın.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan PGM_GETBUTTONSTATE iletisini gönderir.

CPagerCtrl::GetDropTarget

Geçerli çağrı aracı denetimi için IDropTarget arabirimini alır.

IDropTarget* GetDropTarget() const;

Dönüş Değeri

Geçerli çağrı aracı denetiminin IDropTarget arabirimine yönelik bir işaretçi.

Açıklamalar

IDropTarget , uygulamanızda sürükle ve bırak işlemlerini desteklemek için uyguladığınız arabirimlerden biridir.

Bu yöntem, Windows SDK'sında açıklanan PGM_GETDROPTARGET iletisini gönderir. Bu yöntemin çağıranı, arabirim artık gerekli olmadığında IDropTarget arabiriminin üyesini çağırmaktan Release sorumludur.

CPagerCtrl::GetScrollPos

Geçerli çağrı aracı denetiminin kaydırma konumunu alır.

int GetScrollPos() const;

Dönüş Değeri

Piksel cinsinden ölçülen geçerli kaydırma konumu.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan PGM_GETPOS iletisini gönderir.

Örnek

Aşağıdaki örnek, çağrı aracı denetiminin geçerli kaydırma konumunu almak için CPagerCtrl::GetScrollPos yöntemini kullanır. Çağrı aracı denetimi en soldaki konumda sıfıra kaydırılmadıysa, örnek kaydırma konumunu sıfır olarak ayarlamak için CPagerCtrl::SetScrollPos yöntemini kullanır.

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

Geçerli çağrı aracı denetiminin belirtilen kaydırma düğmesinin basılmış durumda olup olmadığını gösterir.

BOOL IsButtonDepressed(int iButton) const;

Parametreler

iButton
[in] Durumunun alındığı düğmeyi gösterir. Disk belleği denetim stili PGS_HORZ, sol düğme için PGB_TOPORLEFT ve sağ düğme için PGB_BOTTOMORRIGHT belirtin. Çağrı cihazı denetim stili PGS_VERT, üst düğme için PGB_TOPORLEFT ve alt düğme için PGB_BOTTOMORRIGHT belirtin. Daha fazla bilgi için bkz . Pager Denetim Stilleri.

Dönüş Değeri

Belirtilen düğme basılı durumdaysa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan PGM_GETBUTTONSTATE iletisini gönderir. Ardından döndürülen durumun PGF_DEPRESSED olup olmadığını test eder. Daha fazla bilgi için PGM_GETBUTTONSTATE iletisinin Dönüş Değeri bölümüne bakın.

CPagerCtrl::IsButtonGrayed

Geçerli çağrı aracı denetiminin belirtilen kaydırma düğmesinin gri durumda olup olmadığını gösterir.

BOOL IsButtonGrayed(int iButton) const;

Parametreler

iButton
[in] Durumunun alındığı düğmeyi gösterir. Disk belleği denetim stili PGS_HORZ, sol düğme için PGB_TOPORLEFT ve sağ düğme için PGB_BOTTOMORRIGHT belirtin. Çağrı cihazı denetim stili PGS_VERT, üst düğme için PGB_TOPORLEFT ve alt düğme için PGB_BOTTOMORRIGHT belirtin. Daha fazla bilgi için bkz . Pager Denetim Stilleri.

Dönüş Değeri

Belirtilen düğme gri durumdaysa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan PGM_GETBUTTONSTATE iletisini gönderir. Daha sonra döndürülen durumun PGF_GRAYED olup olmadığını test eder. Daha fazla bilgi için PGM_GETBUTTONSTATE iletisinin Dönüş Değeri bölümüne bakın.

CPagerCtrl::IsButtonHot

Geçerli çağrı aracı denetiminin belirtilen kaydırma düğmesinin etkin durumda olup olmadığını gösterir.

BOOL IsButtonHot(int iButton) const;

Parametreler

iButton
[in] Durumunun alındığı düğmeyi gösterir. Disk belleği denetim stili PGS_HORZ, sol düğme için PGB_TOPORLEFT ve sağ düğme için PGB_BOTTOMORRIGHT belirtin. Çağrı cihazı denetim stili PGS_VERT, üst düğme için PGB_TOPORLEFT ve alt düğme için PGB_BOTTOMORRIGHT belirtin. Daha fazla bilgi için bkz . Pager Denetim Stilleri.

Dönüş Değeri

Belirtilen düğme etkin durumdaysa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan PGM_GETBUTTONSTATE iletisini gönderir. Ardından döndürülen durumun PGF_HOT olup olmadığını test eder. Daha fazla bilgi için PGM_GETBUTTONSTATE iletisinin Dönüş Değeri bölümüne bakın.

CPagerCtrl::IsButtonInvisible

Geçerli çağrı aracı denetiminin belirtilen kaydırma düğmesinin görünmez durumda olup olmadığını gösterir.

BOOL IsButtonInvisible(int iButton) const;

Parametreler

iButton
[in] Durumunun alındığı düğmeyi gösterir. Disk belleği denetim stili PGS_HORZ, sol düğme için PGB_TOPORLEFT ve sağ düğme için PGB_BOTTOMORRIGHT belirtin. Çağrı cihazı denetim stili PGS_VERT, üst düğme için PGB_TOPORLEFT ve alt düğme için PGB_BOTTOMORRIGHT belirtin. Daha fazla bilgi için bkz . Pager Denetim Stilleri.

Dönüş Değeri

Belirtilen düğme görünmez durumdaysa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Windows, kapsanan pencere en uzak boyuta kaydırıldığında belirli bir yöndeki kaydırma düğmesini görünmez hale getirir, çünkü düğmeye daha fazla tıklandığında kapsanan pencere daha fazla görüntülenmez.

Bu yöntem, Windows SDK'sında açıklanan PGM_GETBUTTONSTATE iletisini gönderir. Ardından döndürülen durumun PGF_INVISIBLE olup olmadığını test eder. Daha fazla bilgi için PGM_GETBUTTONSTATE iletisinin Dönüş Değeri bölümüne bakın.

Örnek

Aşağıdaki örnekte, çağrı aracı denetiminin sol ve sağ kaydırma düğmelerinin görünür olup olmadığını belirlemek için CPagerCtrl::IsButtonInvisible yöntemi kullanılır.

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

Geçerli çağrı aracı denetiminin belirtilen kaydırma düğmesinin normal durumda olup olmadığını gösterir.

BOOL IsButtonNormal(int iButton) const;

Parametreler

iButton
[in] Durumunun alındığı düğmeyi gösterir. Disk belleği denetim stili PGS_HORZ, sol düğme için PGB_TOPORLEFT ve sağ düğme için PGB_BOTTOMORRIGHT belirtin. Çağrı cihazı denetim stili PGS_VERT, üst düğme için PGB_TOPORLEFT ve alt düğme için PGB_BOTTOMORRIGHT belirtin. Daha fazla bilgi için bkz . Pager Denetim Stilleri.

Dönüş Değeri

Belirtilen düğme normal durumdaysa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan PGM_GETBUTTONSTATE iletisini gönderir. Ardından döndürülen durumun PGF_NORMAL olup olmadığını test eder. Daha fazla bilgi için PGM_GETBUTTONSTATE iletisinin Dönüş Değeri bölümüne bakın.

CPagerCtrl::RecalcSize

Geçerli çağrı aracı denetiminin kapsanan pencerenin boyutunu yeniden hesaplamasına neden olur.

void RecalcSize();

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan PGM_RECALCSIZE iletisini gönderir. Sonuç olarak, çağrı aracı denetimi, kapsanan pencerenin kaydırılabilir boyutlarını almak için PGN_CALCSIZE bildirimini gönderir.

Örnek 1

Aşağıdaki örnek, geçerli çağrı aracı denetiminin boyutunu yeniden hesaplamasını istemek için CPagerCtrl::RecalcSize yöntemini kullanır.

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."));
}

Örnek 2

Aşağıdaki örnek, çağrıyı yapan denetimin üst iletişim kutusunun hesaplamayı gerçekleştirmesini gerektirmek yerine kendi boyutunu yeniden hesaplamasını sağlamak için ileti yansımasını kullanır. Örnek, sınıfı CPagerCtrl sınıfından türetirMyPagerCtrl, ardından PGN_CALCSIZE bildirimini bildirim işleyicisiyle ilişkilendirmek için bir ileti eşlemesi OnCalcsize kullanır. Bu örnekte bildirim işleyicisi, disk belleği denetiminin genişliğini ve yüksekliğini sabit değerlere ayarlar.

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

Geçerli çağrı aracı denetiminin arka plan rengini ayarlar.

COLORREF SetBkColor(COLORREF clrBk);

Parametreler

clrBk
[in] Disk belleği denetiminin yeni arka plan rengini içeren COLORREF değeri.

Dönüş Değeri

Disk belleği denetiminin önceki arka plan rengini içeren COLORREF değeri.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan PGM_SETBKCOLOR iletisini gönderir.

Örnek

Aşağıdaki örnek, çağrıyı yapan denetimin arka plan rengini kırmızı olarak ayarlamak için CPagerCtrl::SetBkColor yöntemini ve değişikliğin yapıldığını onaylamak için CPagerCtrl::GetBkColor yöntemini kullanır.

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

Geçerli çağrı aracı denetiminin kenarlık boyutunu ayarlar.

int SetBorder(int iBorder);

Parametreler

iBorder
[in] Piksel cinsinden ölçülen yeni kenarlık boyutu. iBorder parametresi negatifse, kenarlık boyutu sıfır olarak ayarlanır.

Dönüş Değeri

Piksel cinsinden ölçülen önceki kenarlık boyutu.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan PGM_SETBORDER iletisini gönderir.

Örnek

Aşağıdaki örnek bir disk belleği denetimi oluşturur, ardından çok uzun bir düğme denetimini çağrı grubu denetimiyle ilişkilendirmek için CPagerCtrl::SetChild yöntemini kullanır. Örnek daha sonra CPagerCtrl::SetButtonSize yöntemini kullanarak disk belleği denetiminin yüksekliğini 20 piksele, CPagerCtrl::SetBorder yöntemini ise kenarlık kalınlığını 1 piksel olarak ayarlar.

// 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

Geçerli çağrı aracı denetiminin düğme boyutunu ayarlar.

int SetButtonSize(int iButtonSize);

Parametreler

iButtonSize
[in] Piksel cinsinden ölçülen yeni düğme boyutu.

Dönüş Değeri

Piksel cinsinden ölçülen önceki düğme boyutu.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan PGM_SETBUTTONSIZE iletisini gönderir.

Çağrı aracı denetimi PGS_HORZ stiline sahipse, düğme boyutu çağrı aracı düğmelerinin genişliğini belirler ve disk belleği denetimi PGS_VERT stiline sahipse, düğme boyutu çağrı aracı düğmelerinin yüksekliğini belirler. Varsayılan düğme boyutu kaydırma çubuğunun genişliğinin dörtte üçüdür ve en küçük düğme boyutu 12 pikseldir. Daha fazla bilgi için bkz . Pager Denetim Stilleri.

Örnek

Aşağıdaki örnek bir disk belleği denetimi oluşturur, ardından çok uzun bir düğme denetimini çağrı grubu denetimiyle ilişkilendirmek için CPagerCtrl::SetChild yöntemini kullanır. Örnek daha sonra CPagerCtrl::SetButtonSize yöntemini kullanarak disk belleği denetiminin yüksekliğini 20 piksele, CPagerCtrl::SetBorder yöntemini ise kenarlık kalınlığını 1 piksel olarak ayarlar.

// 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

Geçerli çağrı aracı denetimi için kapsanan pencereyi ayarlar.

void SetChild(HWND hwndChild);

Parametreler

hwndChild
[in] İçerilecek pencere tutamacı.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan PGM_SETCHILD iletisini gönderir.

Bu yöntem, kapsanan pencerenin üst öğesini değiştirmez; yalnızca kaydırma için disk belleği denetimine bir pencere tutamacı atar. Çoğu durumda, kapsanan pencere, çağrı kutusu denetiminin alt penceresi olur.

Örnek

Aşağıdaki örnek bir disk belleği denetimi oluşturur, ardından çok uzun bir düğme denetimini çağrı grubu denetimiyle ilişkilendirmek için CPagerCtrl::SetChild yöntemini kullanır. Örnek daha sonra CPagerCtrl::SetButtonSize yöntemini kullanarak disk belleği denetiminin yüksekliğini 20 piksele, CPagerCtrl::SetBorder yöntemini ise kenarlık kalınlığını 1 piksel olarak ayarlar.

// 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

Geçerli çağrı aracı denetiminin kaydırma konumunu ayarlar.

void SetScrollPos(int iPos);

Parametreler

iPos
[in] Piksel cinsinden ölçülen yeni kaydırma konumu.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan PGM_SETPOS iletisini gönderir.

Ayrıca bkz.

CPagerCtrl Sınıfı
Hiyerarşi Grafiği
Çağrı Oluşturucu Denetimleri