# CONTROLINFO

The CONTROLINFO structure contains parameters that describe a control’s keyboard mnemonics and keyboard behavior. The structure is filled during the IOleControl::GetControlInfo method.

    typedef struct tagCONTROLINFO
        {
        ULONG  cb;
        HACCEL hAccel;
        USHORT cAccel;
        DWORD  dwFlags;
        } CONTROLINFO;

Members

cb
  Size of the CONTROLINFO structure.
hAccel
  Handle to an array of Windows ACCEL structures, each structure describing a keyboard mnemonic. The array is allocated with the GlobalAlloc function. The control always maintains the memory for this array; the caller of IOleControl::GetControlInfo should not attempt to free the memory.
cAccel
  Number of mnemonics described in the hAccel field. This value can be zero to indicate no mnemonics.
dwFlags
  Flags that indicate the keyboard behavior of the control. The possible values are:
  CTRLINFO_EATS_RETURN
    When the control has the focus, it will process the Return key.
  CTRLINFO_EATS_ESCAPE
    When the control has the focus, it will process the Escape key.
  When the control has the focus, the dialog box containing the control cannot use the Return or Escape keys as mnemonics for the default and cancel buttons.

See Also

IOleControl::GetControlInfo