In This Topic ▼

L_ILM_ENABLEKEYBOARD

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

Parameters

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 Ctrl + Left Home	scroll up/left to beginning of list (depends on scroll style)
Ctrl + PageDown Ctrl + Down Ctrl + 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.

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; 
}