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
| Ad | Tanım |
|---|---|
| CPagerCtrl::CPagerCtrl | Bir CPagerCtrl nesne oluşturur. |
Genel Yöntemler
| Ad | Tanım |
|---|---|
| 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
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.
İade 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.
İade 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;
İade 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;
İade 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;
İade 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.
İade 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;
İade 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;
İade 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.
İade 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.
İade 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.
İade 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.
İade 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.
İade 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.
İade 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.
İade 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.
İade 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
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin