CreateIconIndirect_I

  • 项目

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

HICON WINAPI CreateIconIndirect_I(
  PICONINFO pii
);

Parameters

  • pii
    [in] Pointer to an ICONINFO structure that 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 operating system (OS) copies the bitmaps in the ICONINFO structure before creating the icon. Because the OS can temporarily select the bitmaps in a device context, you should not have already selected the hbmMask and hbmColor members of the ICONINFO structure 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 the CreateIconIndirect_I function to create icons or monochrome cursors. Microsoft® Windows® CE .NET does not support color cursors.

When you create hotspots, you should use positive location values. If you create a hotspot with negative location values, the location where the hotspot appears cannot be determined.

When you finish using the icon, destroy the icon by calling the DestroyIcon_I function.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Gwebypasscoredllthunk.hpp.

See Also

CreateIconIndirect | DestroyIcon_I | DrawIconEx_I | ICONINFO | LoadIconW_I

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.