L_CreateImageListControl
#include "ltlst.h"
HWND EXT_FUNCTION L_CreateImageListControl(dwStyle, x, y, nWidth, nHeight, hWndParent, nID, crBack)
L_UINT32 dwStyle; |
/* window style */ |
L_INT x; |
/* horizontal position of window */ |
L_INT y; |
/* vertical position of window */ |
L_INT nWidth; |
/* window width */ |
L_INT nHeight; |
/* window height */ |
HWND hWndParent; |
/* handle to parent window */ |
L_INT nID; |
/* control ID */ |
COLORREF crBack; |
/* background color of control */ |
Creates the image list control as a child of the specified parent window.
Parameter |
Description |
dwStyle |
Window styles for the ImageList Control window. This can by any normal window style, or ImageList style. For more information on ImageList styles, refer to LTIMAGELISTCLASS Registered Class: Styles. |
x |
Original horizontal position for the ImageList Control window. |
y |
Original horizontal position for the ImageList Control window. |
nWidth |
Original width for the ImageList Control window. |
nHeight |
Original height for the ImageList Control window. |
hWndParent |
Window handle of the parent window for the ImageList Control. |
nID |
ID for the ImageList Control. You can use this to identify the control when you process WM_COMMAND notification messages that the control will send to it's parent window. |
crBack |
The background color for the ImageList Control window. |
Returns
> 0 |
The function was successful, and returns the handle to the ImageList Control window. |
< 0 |
An error occurred. Refer to Return Codes. |
Comments
You can destroy the ImageListControl window using the Windows function DestroyWindow.
When the ImageList Control DLL loads, it registers a window class. The name for the ImageListControl window is:
#ifdef WIN32
#define LTIMGLISTCLASS TEXT("LEADIMGLIST32")
#else
#define LTIMGLISTCLASS TEXT("LEADIMGLIST16")
#endif
You can use this class name to create an ImageList Control in your application's resource file (.RC). If you specify an ID when creating the control, you can use the Windows function GetDlgItem to get the window handle of the ImageListControl.
Note: In WIN32 versions, the window is created with the WS_EX_CLIENTEDGE style by default. To change this, you can use the Windows function SetWindowLong.
Note: The ImageList Control Window Class allocates 8 bytes of user data. The first 4 bytes are reserved, but the second 4 bytes can be used by your application. Use SetWindowLong to set these values.
Required DLLs and Libraries
LTLST For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
Platforms
Windows 95 / 98 / Me, Windows 2000 / XP, Windows CE.
See Also
Functions: |
|
Topics: |
|
|
|
|
|
|
Example
#define IDC_LEADIMAGELIST 1200
HWND hCtl;
L_VOID CreateCtl(HWND hWnd)
{
/* create the image list control */
hCtl = L_CreateImageListControl(WS_CHILD|WS_VISIBLE|WS_BORDER,
10, /* x location */
10, /* y location */
250, /* width */
250, /* height */
hWnd, /* parent window */
IDC_LEADIMAGELIST, /* control ID */
RGB(128,128,128)); /* background color */
if(!IsWindow(hCtl))
MessageBox(hWnd, TEXT("Error creating control"), TEXT("Error"), MB_OK);
}