基本介紹
- 外文名：LoadCursor
- 類別：計算機函式
- 功能：載入指定的游標資源
- 原型：HCURSOR LoadCursor
背景,函式功能,函式,原型,參數,hlnstance,LpCursorName,返回值,備註,實例,
背景
函式功能
該函式從一個與套用事例相關的執行檔（EXE檔案）中載入指定的游標資源。該函式已被Loadlmage函式替代。
函式
原型
HCURSOR LoadCursor（HINSTANCE hlnstance，LPCTSTR lpCursorName）；
參數
hlnstance
標識一個模組事例，它的執行檔包含要載入的游標。
LpCursorName
指向以NULL結束的字元串的指針，該字元串存有等待載入的游標資源名。該參數低位位元組和高位位元組0組成資源標識器也可以由低位字為資源標識符和高位字為零組成。也可以用MAKEINTRESOURCE宏命令創建該值。要使用Win32預定義的一個游標，應用程式必須把hlnstance參數設為NULL，並把IpCursorName設為如下值之一：
IDC_APPSTARTING 標準的箭頭和小沙漏
IDC_ARROW 標準的箭頭
IDC_CROSS 十字游標
IDC_HAND Windows 98/Me, Windows 2000/XP: Hand
IDC_HELP 標準的箭頭和問號
IDC_IBEAM 工字游標
IDC_ICON Obsolete for applications marked version 4.0 or later.
IDC_NO 禁止圈
IDC_SIZE Obsolete for applications marked version 4.0 or later. Use IDC_SIZEALL.
IDC_SIZEALL 四向箭頭指向東、西、南、北
IDC_SIZENESW 雙箭頭指向東北和西南
IDC_SIZENS 雙箭頭指向南北
IDC_SIZENWSE 雙箭頭指向西北和東南
IDC_SIZEWE 雙箭頭指向東西
IDC_UPARROW 垂直箭頭
IDC_WAIT 沙漏，Windows7系統下會顯示為選擇的圓圈表示等待
返回值
如果成功，返回值是新載入的游標的句柄：如果失敗，返回值是NULL。若想獲得更多錯誤信息，請調用GetLastError函式。
備註
LoadCursor函式僅載入沒有被載入過的游標資源，否則，它檢取已存在的游標資源的句柄。僅當IpCursorName參數指向一個游標資源時，該函式才返回一個有效的游標句柄。如果IpCursorName不是指向游標而是指向了其他類型的資源（如icon），則該函式返回值不是NULL，儘管它不是一個有效的游標句柄，該函式為當前顯示設備游標搜尋最貼切的游標資源。游標資源可以是彩色或單色的點陣圖。Windows CE：當目標平台不支持滑鼠游標時。使用cursor游標組件。該游標組件支持的唯一的游標是等待游標（IDC_WAIT）。使用LoadCursor函式與SetCursor函式可設值等待游標。SetCursor（LoadCursor（NULL，IDC_WAIT））當目標平台不支持滑鼠游標時，使用cursor游標組件，該組件以桌面視窗平台同樣的方式支持LoadCursor函式，唯一不同的是僅支持單色游標。Windows CE不支持彩色游標。試圖載入一個彩色游標，將產生難以預料的結果。返回值是不確定的。
實例
在VC6 MFC中改變視圖類的指針的方法如下：
1、添加WM_SETCURSOR訊息；
2、重載：
BOOLCDddView::OnSetCursor(CWnd*pWnd,UINTnHitTest,UINTmessage){::SetCursor(::LoadCursor(NULL,IDC_WAIT));//returnCView::OnSetCursor(pWnd,nHitTest,message);returnTRUE;}