Freigeben über


PGM_GETBUTTONSTATE-Nachricht

Ruft den Status der angegebenen Schaltfläche in einem Pager-Steuerelement ab. Sie können diese Nachricht explizit senden oder das Makro Pager_GetButtonState verwenden.

Parameter

wParam

Muss Null sein.

lParam

Gibt an, für welche Schaltfläche der Zustand abgerufen werden soll. Mögliche Werte:

Wert Bedeutung
PGB_TOPORLEFT
Gibt die obere Schaltfläche im Pager-Steuerelement PGS_VERT oder der linken Schaltfläche im Pager-Steuerelement PGS_HORZ an.
PGB_BOTTOMORRIGHT
Gibt die untere Schaltfläche im Pager-Steuerelement PGS_VERT oder der rechten Schaltfläche im Pager-Steuerelement PGS_HORZ an.

Rückgabewert

Gibt den Zustand der in lParamangegebenen Schaltfläche zurück. Hierbei handelt es sich um einen oder mehrere der folgenden Werte (wenn mehrere Werte zurückgegeben werden, werden sie mit einem bitweisen „OR“ kombiniert):

Rückgabecode Beschreibung
PGF_INVISIBLE
Die Schaltfläche ist nicht sichtbar.
PGF_NORMAL
Die Schaltfläche befindet sich im normalen Zustand.
PGF_GRAYED
Die Schaltfläche befindet sich im grauen Zustand.
PGF_DEPRESSED
Die Schaltfläche befindet sich im gedrückten Zustand.
PGF_HOT
Die Schaltfläche befindet sich im heißen Zustand.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2003 [nur Desktop-Apps]
Header
Commctrl.h