GetGestureConfig, fonction (winuser.h)
Récupère la configuration pour laquelle les messages de mouvement Tactile Windows sont envoyés à partir d’une fenêtre.
Syntaxe
BOOL GetGestureConfig(
[in] HWND hwnd,
[in] DWORD dwReserved,
[in] DWORD dwFlags,
[in] PUINT pcIDs,
[in, out] PGESTURECONFIG pGestureConfig,
[in] UINT cbSize
);
Paramètres
[in] hwnd
Handle vers la fenêtre à partir de laquelle obtenir la configuration de mouvement.
[in] dwReserved
Cette valeur est réservée et doit être définie sur 0.
[in] dwFlags
Valeur d’indicateur de commande de mouvement indiquant les options de récupération de la configuration de mouvement. Pour plus d’informations et des valeurs prises en charge, consultez Notes.
[in] pcIDs
Taille, en nombre de structures de configuration de mouvement, qui se trouve dans la mémoire tampon pGestureConfig .
[in, out] pGestureConfig
Tableau de structures de configuration des mouvements qui spécifient la configuration de mouvement.
[in] cbSize
Taille de la structure de configuration de mouvement (GESTURECONFIG).
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, utilisez la fonction GetLastError .
Remarques
La transmission d’une valeur autre que sizeof(GESTURECONFIG) pour le paramètre cbSize entraîne l’échec des appels à cette fonction et GetLastError retourne ERROR_INVALID_PARAMETER (87 en décimal).
Le tableau suivant répertorie les valeurs de configuration des mouvements :
| Nom | Valeur | Description |
|---|---|---|
| GCF_INCLUDE_ANCESTORS | 0x00000001 | S’il est spécifié, GetGestureConfig retourne la configuration consolidée pour la fenêtre spécifiée et sa chaîne de fenêtre parente. |
Exemples
GESTURECONFIG gc[3];
UINT uiGcs = 3;
ZeroMemory(&gc, sizeof(gc));
gc[0].dwID = GID_ZOOM;
gc[1].dwID = GID_ROTATE;
gc[2].dwID = GID_PAN;
BOOL bResult = GetGestureConfig(hWnd, 0, 0, &uiGcs, gc, sizeof(GESTURECONFIG));
if (!bResult){
DWORD err = GetLastError();
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winuser.h (inclure Windows.h) |
| Bibliothèque | User32.lib |
| DLL | User32.dll |
| Ensemble d’API | ext-ms-win-ntuser-misc-l1-2-0 (introduit dans Windows 8.1) |