Share via


CommandBands_GetCommandBar (Windows CE 5.0)

Send Feedback

This function retrieves the handle to a command bar child control in a band of the command bands control.

HWND CommandBands_GetCommandBar(HWNDhwndCmdBands,UINT uBand);

Parameters

  • hwndCmdBands
    Handle to the command bands control's window. This handle is returned when the command bands control is created by the CommandBands_Create function.
  • uBand
    Unsigned integer that contains the zero-based index of the band containing the command bar. If the user has had an opportunity to reposition the bands, use the RB_IDTOINDEX message to get the index of the band before passing the index to this function.

Return Values

The window handle to the command bar identified by the index in the wBandID parameter indicates success. NULL indicates failure.

Remarks

The index you pass in the wBandID parameter**is the current position of the command bar band in the command bands control. This index may have a different value than the order in which you added the band to the control, because the user may have repositioned the band.

Requirements

OS Versions: Windows CE 2.0 and later.
Header: Commctrl.h.
Link Library: Commctrl.lib.

See Also

CommandBands_Create | RB_IDTOINDEX

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.