WinHelpA, fonction (winuser.h)
Lance l’aide de Windows (Winhelp.exe) et transmet des données supplémentaires qui indiquent la nature de l’aide demandée par l’application.
Syntaxe
BOOL WinHelpA(
HWND hWndMain,
LPCSTR lpszHelp,
UINT uCommand,
ULONG_PTR dwData
);
Paramètres
hWndMain
Type : HWND
Handle de la fenêtre demandant de l’aide. La fonction WinHelp utilise ce handle pour suivre les applications qui ont demandé de l’aide. Si le paramètre uCommand spécifie HELP_CONTEXTMENU ou HELP_WM_HELP, hWndMain identifie le contrôle qui demande de l’aide.
lpszHelp
Type : LPCTSTR
Adresse d’une chaîne terminée par null contenant le chemin d’accès, si nécessaire, et le nom du fichier d’aide que WinHelp doit afficher.
Le nom de fichier peut être suivi d’un crochet (>) et du nom d’une fenêtre secondaire si la rubrique doit être affichée dans une fenêtre secondaire plutôt que dans la fenêtre principale. Vous devez définir le nom de la fenêtre secondaire dans la section [WINDOWS] du fichier de projet d’aide (.hpj).
uCommand
Type : UINT
Type d’aide demandé. Pour obtenir la liste des valeurs possibles et la façon dont elles affectent la valeur à placer dans le paramètre dwData , consultez la section Remarques.
dwData
Type : ULONG_PTR
Données supplémentaires. La valeur utilisée dépend de la valeur du paramètre uCommand . Pour obtenir la liste des valeurs dwData possibles, consultez la section Remarques.
Valeur retournée
Type : BOOL
Retourne une valeur différente de zéro en cas de réussite, ou de zéro dans le cas contraire. Pour récupérer des informations d’erreur étendues, appelez GetLastError.
Remarques
Avant de fermer la fenêtre qui a demandé de l’aide, l’application doit appeler WinHelp avec le paramètre uCommand défini sur HELP_QUIT. Tant que toutes les applications n’auront pas effectué cette opération, l’aide de Windows ne s’arrêtera pas. Notez que l’appel de l’aide de Windows avec la commande HELP_QUIT n’est pas nécessaire si vous avez utilisé la commande HELP_CONTEXTPOPUP pour démarrer l’aide de Windows.
Cette fonction échoue si elle est appelée à partir d’un contexte autre que l’utilisateur actuel.
Le tableau suivant montre les valeurs possibles pour le paramètre uCommand et les formats correspondants du paramètre dwData .
| uCommand | Action | dwData |
|---|---|---|
| HELP_COMMAND | Exécute une macro d’aide ou une chaîne de macro. | Adresse d’une chaîne qui spécifie le nom de la ou des macros d’aide à exécuter. Si la chaîne spécifie plusieurs noms de macro, les noms doivent être séparés par des points-virgules. Vous devez utiliser la forme abrégée du nom de la macro pour certaines macros, car l’aide de Windows ne prend pas en charge le nom long. |
| HELP_CONTENTS | Affiche la rubrique spécifiée par l’option Contenu dans la section [OPTIONS] du fichier .hpj. Cette commande est destinée à la compatibilité descendante. Les nouvelles applications doivent fournir un fichier .cnt et utiliser la commande HELP_FINDER. | Ignoré; défini sur 0. |
| HELP_CONTEXT | Affiche la rubrique identifiée par l’identificateur de contexte spécifié défini dans la section [MAP] du fichier .hpj. | Contient l’identificateur de contexte de la rubrique. |
| HELP_CONTEXTMENU | Affiche le menu Aide de la fenêtre sélectionnée, puis affiche la rubrique du contrôle sélectionné dans une fenêtre contextuelle. | Adresse d’un tableau de paires DWORD . Le premier DWORD de chaque paire est l’identificateur de contrôle et le second est l’identificateur de contexte pour la rubrique. Le tableau doit être terminé par une paire de zéros {0,0}. Si vous ne souhaitez pas ajouter d’aide à un contrôle particulier, définissez son identificateur de contexte sur -1. |
| HELP_CONTEXTPOPUP | Affiche la rubrique identifiée par l’identificateur de contexte spécifié défini dans la section [MAP] du fichier .hpj dans une fenêtre contextuelle. | Contient l’identificateur de contexte d’une rubrique. |
| HELP_FINDER | Affiche la boîte de dialogue Rubriques d’aide. | Ignoré; défini sur 0. |
| HELP_FORCEFILE | Vérifie que l’aide de Windows affiche le fichier d’aide correct. Si le fichier d’aide incorrect s’affiche, l’aide de Windows ouvre le fichier correct ; sinon, il n’y a aucune action. | Ignoré; défini sur 0. |
| HELP_HELPONHELP | Affiche de l’aide sur l’utilisation de l’aide de Windows, si le fichier Winhlp32.hlp est disponible. | Ignoré; défini sur 0. |
| HELP_INDEX | Affiche la rubrique spécifiée par l’option Contenu dans la section [OPTIONS] du fichier .hpj. Cette commande est destinée à la compatibilité descendante. Les nouvelles applications doivent utiliser la commande HELP_FINDER. | Ignoré; défini sur 0. |
| HELP_KEY | Affiche la rubrique dans la table de mot clé qui correspond au mot clé spécifié, s’il existe une correspondance exacte. S’il existe plusieurs correspondances, affiche l’index avec les rubriques répertoriées dans la zone de liste Rubriques trouvées . | Adresse d’une chaîne mot clé. Plusieurs mots clés doivent être séparés par des points-virgules. |
| HELP_MULTIKEY | Affiche la rubrique spécifiée par un mot clé dans une table mot clé alternative. | Adresse d’une structure MULTIKEYHELP qui spécifie un caractère de note de bas de page de tableau et un mot clé. |
| HELP_PARTIALKEY | Affiche la rubrique dans la table de mot clé qui correspond au mot clé spécifié, s’il existe une correspondance exacte. S’il existe plusieurs correspondances, affiche la boîte de dialogue Rubriques trouvées . Pour afficher l’index sans passer de mot clé, utilisez un pointeur vers une chaîne vide. | Adresse d’une chaîne mot clé. Plusieurs mots clés doivent être séparés par des points-virgules. |
| HELP_QUIT | Informe l’aide de Windows qu’elle n’est plus nécessaire. Si aucune autre application n’a demandé de l’aide, Windows ferme l’aide de Windows. | Ignoré; défini sur 0. |
| HELP_SETCONTENTS | Spécifie la rubrique Contenu. L’aide de Windows affiche cette rubrique lorsque l’utilisateur clique sur le bouton Contenu si le fichier d’aide n’a pas de fichier .cnt associé. | Contient l’identificateur de contexte de la rubrique Contenu. |
| HELP_SETPOPUP_POS | Définit la position de la fenêtre contextuelle suivante. | Contient les données de position. Utilisez MAKELONG pour concaténer les coordonnées horizontales et verticales en une seule valeur. La fenêtre contextuelle est positionnée comme si le curseur de la souris se trouvait au point spécifié lorsque la fenêtre contextuelle a été appelée. |
| HELP_SETWINPOS | Affiche la fenêtre Aide de Windows, si elle est réduite ou en mémoire, et définit sa taille et sa position comme spécifié. | Adresse d’une structure HELPWININFO qui spécifie la taille et la position d’une fenêtre d’aide primaire ou secondaire. |
| HELP_TCARD | Indique qu’une commande est destinée à un carte instance d’entraînement de l’aide de Windows. Combinez cette commande avec d’autres commandes à l’aide de l’opérateur OR au niveau du bit. | Dépend de la commande avec laquelle cette commande est combinée. |
| HELP_WM_HELP | Affiche la rubrique du contrôle identifié par le paramètre hWndMain dans une fenêtre contextuelle. | Adresse d’un tableau de paires DWORD . Le premier DWORD de chaque paire est un identificateur de contrôle et le second est un identificateur de contexte pour une rubrique. Le tableau doit être terminé par une paire de zéros {0,0}. Si vous ne souhaitez pas ajouter d’aide à un contrôle particulier, définissez son identificateur de contexte sur -1. |
Notes
L’en-tête winuser.h définit WinHelp comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winuser.h |
| Bibliothèque | User32.lib |
| DLL | User32.dll |
| Ensemble d’API | ext-ms-win-ntuser-misc-l1-5-1 (introduit dans Windows 10, version 10.0.14393) |