Collapse All Expand All

L_ILM_ENABLEKEYBOARD

Send this message to enable or disable the ImageList control's automatic processing of the keyboard.

Parameter	Description
wParam	Boolean flag that specifies the keyboard status. Possible values are:
	Value	Meaning
	TRUE	ImageList Control will process the keyboard
	FALSE	ImageList Control will not process the keyboard
lParam	Ignored, use 0.

Returns

The previous setting for keyboard processing.

Comments

When automatic keyboard processing is enabled, the ImageList Control will process the following keys:

Key	Event
PageUp Up Arrow Left Arrow	scroll up/left one item (depends on scroll style)
PageDown Down Arrow Right Arrow	scroll down/right one item (depends on scroll style)
Ctrl + PageUp Ctrl + Up Ctlr + Left Home	scroll up/left to beginning of list (depends on scroll style)
Ctrl + PageDown Ctrl + Down Ctlr + Right End	scroll up/left to end of list (depends on scroll style)

 

Note: If the setting for AllowSelection is not ALLOWSELECTION_SINGLE, then the selected item will move up, down, left, or right, depending on the key(s) being processed. If AllowSelection is set to ALLOWSELECTION_MULTI, multiple items can be selected using the CTRL and/or SHIFT keys in conjunction with the keys listed above.

The associated macro is:

L_ImgListEnableKeyboard(hWnd, bFlag)

For a complete list of available macros, refer to the Ltlst.h file.

See Also

Elements:	L_ILM_SETSCROLLSTYLE, L_ILM_GETSCROLLSTYLE, L_ILM_SETSELOPTIONS, L_ILM_GETSELOPTIONS
Topics:	Using the ImageList Control
	Image List Control Messages

Example

 L_INT ILM_ENABLEKEYBOARDExample(HWND hCtrl)
{
   if(IsWindow(hCtrl))
   {
      /* enable automatic keyboard processing */
      return (L_INT)SendMessage(hCtrl, L_ILM_ENABLEKEYBOARD, (WPARAM)TRUE, 0L);
   }
   else
      return ERROR_INVALID_PARAMETER;
}