ShellAboutA, fonction (shellapi.h)

Affiche une boîte de dialogue ShellÀ propos de .

Syntaxe

INT ShellAboutA(
  [in, optional] HWND   hWnd,
  [in]           LPCSTR szApp,
  [in, optional] LPCSTR szOtherStuff,
  [in, optional] HICON  hIcon
);

Paramètres

[in, optional] hWnd

Type : HWND

Handle de fenêtre vers 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 ShellÀ propos de 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 par 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 un caractère 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 ShellÀ propos de Windows, choisissez À propos de Windows dans la liste déroulante du menu Aide de Windows Explorer.

Configuration requise