CreateIconIndirect

  • Article

This function creates an icon or cursor from an ICONINFO structure.

HICON CreateIconIndirect(
  PICONINFO piconinfo
);

Parameters

  • piconinfo
    [in] Pointer to an ICONINFO structure the function uses to create the icon or cursor.

Return Values

A handle to the icon or cursor that is created indicates success. NULL indicates failure. To get extended error information, call GetLastError.

Remarks

The system copies the bitmaps in the ICONINFO structure before creating the icon. Because the system may temporarily select the bitmaps in a device context, the hbmMask and hbmColor members of the ICONINFO structure should not already be selected into a device context. The application must continue to manage the original bitmaps and delete them when they are no longer necessary.

When using Iconcurs.dll, call this function to create either icons or monochrome cursors. Windows CE does not support color cursors.

Hotspots should be created with positive location values. If a hotspot is created with negative location values, there is no way to determine where it appears.

When you are finished using the icon, destroy it using the DestroyIcon function.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Winuser.h.
Link Library: Icon.lib.

See Also

DestroyIcon | DrawIcon | ICONINFO | LoadIcon

 Last updated on Wednesday, April 14, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.