ITPhone::get_ButtonMode-Methode (tapi3if.h)
Die get_ButtonMode-Methode ruft den Schaltflächenmodus ab, der einer bestimmten Schaltfläche zugeordnet ist.
Die Anwendung muss ITPhone::Open aufrufen, bevor diese Methode aufgerufen wird. andernfalls schlägt der Aufruf fehl.
Syntax
HRESULT get_ButtonMode(
[in] long lButtonID,
[out] PHONE_BUTTON_MODE *pButtonMode
);
Parameter
[in] lButtonID
Schaltflächenbezeichner. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
[out] pButtonMode
Die PHONE_BUTTON_MODE Deskriptor für den Modus der Schaltfläche.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Sehen Sie sich die Beschreibung der PHONE_BUTTON_MODE-Enumeration und der TAPI 2 an. x-Dokumentation für weitere Informationen zu Schaltflächenmodi.
Von besonderem Interesse sind die beiden folgenden PHONE_BUTTON_MODE Werte:
- Wenn der PHONE_BUTTON_MODE Wert PBM_FEATURE ist, sollte die Anwendung den get_ButtonFunction aufrufen, um die spezifische Bedeutung der Schaltfläche abzurufen.
- Wenn der wert PHONE_BUTTON_MODE PBM_KEYPAD ist, handelt es sich bei der Schaltfläche um eine Tastenfeldschaltfläche, deren Wert durch den Wert des lButtonID-Parameters angegeben wird. Wenn beispielsweise lButtonID == 10 ist, ist die Schaltfläche die Taste * (star) auf der Tastatur.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (einschließlich Tapi3.h) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |