ShellAboutW, fonction (shellapi.h)

Article
02/01/2024

Affiche une boîte de dialogue ShellAbout .

Syntaxe

INT ShellAboutW(
  [in, optional] HWND    hWnd,
  [in]           LPCWSTR szApp,
  [in, optional] LPCWSTR szOtherStuff,
  [in, optional] HICON   hIcon
);

Paramètres

[in, optional] hWnd

Type : HWND

Handle de fenêtre dans une fenêtre parente. Ce paramètre peut être NULL.

[in] szApp

Type : LPCTSTR

Pointeur vers une chaîne terminée par null qui contient du texte à afficher dans la barre de titre de la boîte de dialogue ShellAbout et sur la première ligne de la boîte de dialogue après le texte « Microsoft ». Si le texte contient un séparateur (#) qui le divise en deux parties, la fonction affiche la première partie dans la barre de titre et la deuxième partie sur la première ligne après le texte « Microsoft ».

Windows 2000, Windows XP, Windows Server 2003 : si la chaîne pointée vers ce paramètre contient un séparateur (#), la chaîne doit être accessible en écriture.

Windows Vista, Windows Server 2008 : cette chaîne ne peut pas dépasser 200 caractères. Le contenu de szApp ne s’affiche plus après « Microsoft », sauf s’il existe un séparateur #, auquel cas la partie après # remplacera complètement la première ligne.

[in, optional] szOtherStuff

Type : LPCTSTR

Pointeur vers une chaîne terminée par null qui contient du texte à afficher dans la boîte de dialogue après la version et les informations de copyright. Ce paramètre peut être NULL.

[in, optional] hIcon

Type : HICON

Handle d’une icône que la fonction affiche dans la boîte de dialogue. Ce paramètre peut être NULL, auquel cas la fonction affiche l’icône Windows.

Valeur retournée

Type : int

TRUE en cas de réussite ; sinon, FALSE.

Remarques

Notez que la boîte de dialogue De la fonction ShellAbout utilise du texte et une icône par défaut qui sont spécifiques à Windows.

Pour afficher un exemple de boîte de dialogue ShellAbout, choisissez À propos de Windows dans la liste déroulante du menu Aide dans Windows Explorer.

Notes

L’en-tête shellapi.h définit ShellAbout 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


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	shellapi.h
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 3.51 ou ultérieure)
Ensemble d’API	ext-ms-win-shell-shell32-l1-2-2 (introduit dans Windows 10, version 10.0.14393)

Partager via