CPagerCtrl::IsButtonInvisible
Gibt an, ob die angegebene Bildlaufschaltfläche des aktuellen Pager-Steuerelements im nicht sichtbaren Zustand befindet.
BOOL IsButtonInvisible(
int iButton
) const;
Anforderungen
Header: afxcmn.h
Parameter
Parameter |
Description |
|---|---|
[in] iButton |
Gibt die Schaltfläche an, für die der Zustand abgerufen wird.Wenn das Pager-Steuerelement-Format PGS_HORZ ist, geben Sie PGB_TOPORLEFT für die Schaltfläche linke und rechte PGB_BOTTOMORRIGHT für die Schaltfläche an.Wenn das Pager-Steuerelement-Format PGS_VERT ist, geben Sie PGB_TOPORLEFT für die oberste Schaltfläche und PGB_BOTTOMORRIGHT für die untere Schaltfläche an.Weitere Informationen finden Sie unter Pager-Steuerelement-Formate. |
Rückgabewert
true, wenn die angegebene Schaltfläche im nicht sichtbaren Zustand ist; andernfalls false.
Hinweise
Windows stellt die Bildlaufschaltfläche in einer bestimmten Richtung nicht sichtbar erstellt, wenn das enthaltende Fenster zu seinem Wertebereich weitesten Bildlauf ausgeführt wird, da das Klicken auf die Schaltfläche mehr des übergeordneten Fensters nicht in Ansicht weiter abrufen kann.
Diese Methode sendet die PGM_GETBUTTONSTATE Meldung, die im Windows SDK beschrieben wird. Es testet dann, ob der Zustand, der zurückgegeben wird, PGF_INVISIBLE ist.Weitere Informationen finden Sie im Abschnitt der Rückgabewert PGM_GETBUTTONSTATE Meldung.
Beispiel
Im folgenden Beispiel wird die CPagerCtrl::IsButtonInvisible-Methode, um zu bestimmen, ob die linken und rechten Bildlaufschaltflächen des Pager-Steuerelements sichtbar sind.
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);
}