template<class character>
bool set_window_text(handle window,
                     const character* text)

This function sets the text of a window.


handle window

The handle of the window whose text is being set.

const character* text

A pointer to a string containing the new text of the window.



true The function succeeded.
false The call failed.


If the window is a main window, the text contained in the title bar is changed. If the window is a control window (such as a static display window), the text associated with that control is updated. This function cannot be used to change the text of a window from another application.

To perform this request and set the text, the message message::set_text is sent to the window.