CPagerCtrl::IsButtonInvisible
更新 : 2007 年 11 月
現在のページャ コントロール内の指定されたスクロール ボタンが非表示の状態になっているかどうかを示します。
BOOL IsButtonInvisible(
int iButton
) const;
必要条件
ヘッダー : afxcmn.h
パラメータ
パラメータ |
説明 |
|---|---|
[入力] iButton |
状態を取得するボタンを指定します。ページャ コントロールのスタイルが PGS_HORZ の場合は、左のボタンに PGB_TOPORLEFT を指定し、右のボタンに PGB_BOTTOMORRIGHT を指定します。ページャ コントロールのスタイルが PGS_VERT の場合は、上のボタンに PGB_TOPORLEFT を指定し、下のボタンに PGB_BOTTOMORRIGHT を指定します。詳細については、「Pager Control Styles」を参照してください。 |
戻り値
指定したボタンが非表示の状態の場合は true。それ以外の場合は false。
解説
ウィンドウのスクロールが端まで達すると、特定方向のスクロール ボタンが非表示になります。そのボタンをクリックしても、ウィンドウの表示にそれ以上の変化はないからです。
このメソッドは、PGM_GETBUTTONSTATE メッセージを送信します。このメッセージについては、Windows SDK を参照してください。その後、このメソッドは、返された状態が PGF_INVISIBLE かどうかを確認します。詳細については、PGM_GETBUTTONSTATE メッセージの「戻り値」のセクションを参照してください。
使用例
CPagerCtrl::IsButtonInvisible メソッドを使用して、ページャ コントロールの左と右のスクロール ボタンが表示されているかどうかを確認する例を次に示します。
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);
}