CURSORS.C

/* 
 * CURSORS.C 
 * Buttons & Cursors 
 * 
 * Public functions to retrieve cursors. 
 * 
 * Copyright (c)1992-1995 Microsoft Corporation, All Rights Reserved 
 * 
 * Kraig Brockschmidt, Microsoft 
 * Internet  :  kraigb@microsoft.com 
 * Compuserve:  >INTERNET:kraigb@microsoft.com 
 */ 
 
 
#include "inoledll.h" 
 
 
/* 
 * The +1 is because MAX is the highest allowable number and MIN is 
 * not necessarily zero. 
 */ 
HCURSOR rgHCursors[IDC_NEWUICURSORMAX-IDC_NEWUICURSORMIN+1]; 
 
 
 
/* 
 * CursorsCache 
 * Internal 
 * 
 * Purpose: 
 *  Loads all the cursors available through NewUICursorLoad into 
 *  a global array.  This way we can clean up all the cursors without 
 *  placing the burden on the application. 
 * 
 * Parameters: 
 *  hInst           HANDLE of the DLL instance. 
 * 
 * Return Value: 
 *  None. If any of the LoadCursor calls fail, then the corresponding 
 *  array entry is NULL and NewUICursorLoad will fail. Better to fail 
 *  an app getting a cursor than failing to load the app just for 
 *  that reason; and app can attempt to load the cursor on startup if 
 *  it's that important, and fail itself. 
 */ 
 
void CursorsCache(HINSTANCE hInst) 
    { 
    UINT            i; 
 
    for (i=IDC_NEWUICURSORMIN; i<=IDC_NEWUICURSORMAX; i++) 
        { 
        rgHCursors[i-IDC_NEWUICURSORMIN]=LoadCursor(hInst 
            , MAKEINTRESOURCE(i)); 
        } 
    return; 
    } 
 
 
 
 
/* 
 * CursorsFree 
 * Internal 
 * 
 * Purpose: 
 *  Frees all the cursors previously loaded through CursorsCache. 
 * 
 * Parameters: 
 *  None 
 * 
 * Return Value: 
 *  None 
 */ 
 
void CursorsFree(void) 
    { 
    /* 
     * Note that since cursors are discardable resources and should 
     * not be used with DestroyCursor, there's nothing to do here. 
     * We still provide this API for compatibility and to maintain 
     * symmetry. 
     */ 
    return; 
    } 
 
 
 
 
 
/* 
 * UICursorLoad 
 * Public API 
 * 
 * Purpose: 
 *  Loads and returns a handle to one of the new standard UI cursors 
 *  contained in UITOOLS.DLL.  The application must not call 
 *  DestroyCursor on this cursor as it is managed by the DLL. 
 * 
 * Parameters: 
 *  iCursor         UINT index to the cursor to load which must be one 
 *                  of the following values: 
 * 
 *      IDC_RIGHTARROW    Right pointing standard arrow 
 *      IDC_CONTEXTHELP   Arrow with a ? (context help) 
 *      IDC_MAGNIFY       Magnifying glass for zooming 
 *      IDC_NODROP        Circle with a slash 
 *      IDC_TABLETOP      Small arrow pointing down 
 * 
 *      IDC_SMALLARROWS   Thin four-headed arrow 
 *      IDC_LARGEARROWS   Wide four-headed arrow 
 *      IDC_HARROWS       Horizontal two-headed arrow 
 *      IDC_VARROWS       Vertical two-headed arrow 
 *      IDC_NESWARROWS    Two-headed arrow pointing NE<->SW 
 *      IDC_NWSEHARROWS   Two-headed arrow pointing NW<->SE 
 * 
 *      IDC_HSIZEBAR      Horizontal two-headed arrow with 
 *                        a single vertical bar down the 
 *                        middle 
 * 
 *      IDC_VSIZEBAR      Vertical two-headed arrow with a 
 *                        single horizontal bar down the 
 *                        middle 
 * 
 *      IDC_HSPLITBAR     Horizontal two-headed arrow with 
 *                        split double vertical bars down the 
 *                        middle 
 * 
 *      IDC_VSPLITBAR     Vertical two-headed arrow with split 
 *                        double horizontal bars down the 
 *                        middle 
 * 
 * Return Value: 
 *  HCURSOR         Handle to the loaded cursor if successful, NULL 
 *                  if iCursor is out of range or the function could 
 *                  not load the cursor. 
 */ 
 
HCURSOR WINAPI UICursorLoad(UINT iCursor) 
    { 
    HCURSOR     hCur=NULL; 
 
    if ((iCursor >= IDC_NEWUICURSORMIN) 
        && (iCursor <= IDC_NEWUICURSORMAX)) 
        hCur=rgHCursors[iCursor-IDC_NEWUICURSORMIN]; 
 
    return hCur; 
    }