ShellAboutW 函式 (shellapi.h)

顯示 ShellAbout 對話方塊。

語法

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

參數

[in, optional] hWnd

類型： HWND

父視窗的視窗句柄。 此參數可以是 Null。

[in] szApp

類型： LPCTSTR

Null 終止字串的指標，其中包含要顯示在 ShellAbout 對話框標題列中的文字，以及在 “Microsoft” 文字後面的對話框第一行上。 如果文字包含分隔符 (#) ，將它分成兩個部分，則函式會在標題欄中顯示第一個部分，並在文字 “Microsoft” 之後的第一行顯示第二個部分。

Windows 2000、Windows XP、Windows Server 2003：如果此參數指向的字串包含分隔符 (#) ，則必須可寫入字符串。

Windows Vista、Windows Server 2008：此字串長度不能超過 200 個字元。 除非有 # 分隔符，否則 szApp 的內容將不再顯示在 “Microsoft” 之後，在此情況下，# 後面的部分將會完全取代第一行。

[in, optional] szOtherStuff

類型： LPCTSTR

Null 終止字串的指標，其中包含版本和著作權信息之後要顯示在對話框中的文字。 此參數可以是 Null。

[in, optional] hIcon

類型： HICON

函式顯示在對話框中的圖示句柄。 此參數可以是 NULL，在此情況下，函式會顯示 Windows 圖示。

傳回值

類型： int

如果成功，則為TRUE;否則為 FALSE。

備註

請注意 ，ShellAbout 函式對話方塊會使用 Windows 特有的文字和預設圖示。

若要查看 ShellAbout 對話框的範例，請從 Windows 檔案總管的 [說明] 功能表下拉功能表中選擇 [關於 Windows]。

規格需求