ShellAboutW, fonction (shellapi.h)

Article
11/20/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 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 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 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 de longueur. Le contenu de szApp ne s’affiche plus après « Microsoft », sauf s’il existe un séparateur #, auquel cas la partie après le # 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 les informations de version et de copyright. Ce paramètre peut être NULL.

[in, optional] hIcon

Type : HICON

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

Valeur de retour

Type : int

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

Remarques

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

Pour afficher un exemple de boîte de dialogue ShellAbout, choisissez À propos de Windows dans la liste déroulante Aide dans l’Explorateur Windows.

Note

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

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’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