CommandBar_AddAdornments (Windows Embedded CE 6.0)

1/6/2010

This function adds the Close button (X) to the command bar. You can also use it to add the Help button (?) and the OK button.

Syntax

BOOL CommandBar_AddAdornments(
  HWND hwndCB, 
  DWORD dwFlags, 
  DWORD dwReserved
); 

Parameters

• hwndCB
  Handle to the command bar's window. This handle is returned when the command bar is created by the CommandBar_Create function.

• dwFlags
  Specifies the optional buttons to be added to the command bar. This parameter can be a combination of the following values, or zero if neither of the optional buttons are needed.

  Value	Description	Message
  CMDBAR_HELP	Help button	WM_HELP
  CMDBAR_OK	OK button	WM_COMMAND (with IDOK as the message identifier)

• dwReserved
  Reserved; set to zero.

Return Value

TRUE indicates success. FALSE indicates failure.

Remarks

When a user selects the Close, OK, or Help button, the message associated with that button is placed in the application's message queue.

Do not call the CommandBar_AddAdornments member function until after you have added all the other elements (menus, buttons, combo boxes) to the command bar.

This API is not intended to have a cumulative effect. Calling this function more than one time will cause unexpected behavior.

Requirements

See Also

Reference

Command Bars Functions
CommandBar_AddButtons
CommandBar_Create
CommandBar_InsertButton