SHSetNavBarText

  • Article

This function sets the title text in the taskbar.

BOOL SHSetNavBarText(
  HWND hwndRequester, 
  LPCTSTR pszText
);

Parameters

  • hwndRequester
    [in] Handle to the top-level window requesting the new taskbar title.
  • pszText
    [in] Pointer to a null-terminated string for the new title. May also be NULL, which will reset the taskbar title to the title of hwndRequester.

Return Values

This function returns TRUE if it is successful and FALSE if it fails.

Remarks

Typically, the text that appears in the taskbar is the title of the currently active application. In some rare cases, an application may want to override this title and set the title explicitly.

Requirements

OS Versions: Windows CE .NET 4.2 and later.
Header: Aygshell.h.
Link Library: Aygshell.lib.

See Also

AYGShell Functions

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.