SHSetNavBarText

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function sets the title text in the taskbar.

Syntax

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 Value

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

Header aygshell.h
Library aygshell.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2000 and later