message::set_text

This message is used to set the text of a window.

Parameters

parameter1

This parameter is unused and should be zero.

parameter2

A pointer to a null-terminated string holding the new window text.

Return

result

Zero is returned if the text was successfuly set. Typically, control classes return a negative value if the setting of text failed.

Notes

The default window procedure sets the text and displays it in the window.

For a standard window, the text is displayed in the title bar. button controls use the text as the button name, and edit controls use the text as the contents of the control. Other classes place their own interpretation on the window text.