LImageListControl::EnableKeyboard

#include "ltwrappr.h"

L_BOOL LImageListControl::EnableKeyboard(bEnable=TRUE)

L_BOOL bEnable;

/* flag that indicates whether or not to enable the keyboard */

Enables or disables the ImageList control's automatic processing of the keyboard.

Parameter

Description

bEnable

Flag that indicates whether or not to enable automatic processing of the keyboard. Possible values are:

 

Value

Meaning

 

TRUE

ImageList Control will process the keyboard.

 

FALSE

ImageList Control will not process the keyboard.

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.

Required DLLs and Libraries

LTDIS
LTFIL
LTIMG

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

Class Members

Topics:

Using the ImageList Control

Example

L_INT LImageListControl__EnableKeyboardExample()
{
   LImageListControl m_ImgList;
   // disable auto keyboard processing
   m_ImgList.EnableKeyboard(FALSE);
   return SUCCESS;
}