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