Share via

setSystemCursor 函式 (winuser.h)

  • 發行項

可讓應用程式自定義系統數據指標。 它會以 hcur參數所指定的數據指標內容取代 id 參數所指定的系統數據指標內容，然後終結 hcur。

語法

BOOL SetSystemCursor(
  [in] HCURSOR hcur,
  [in] DWORD   id
);

參數

[in] hcur

類型： HCURSOR

數據指標的句柄。 函式 會將id所 指定的系統數據指標內容取代為 由 hcur 處理的數據指標內容。

系統會藉由呼叫 DestroyCursor 函式來終結 hcur。 因此， hcur 不能是使用 LoadCursor函 式載入的數據指標。 若要指定從資源載入的數據指標，請使用 CopyCursor 函 式複製數據指標，然後將復本傳遞至 SetSystemCursor。

[in] id

類型： DWORD

要取代為 hcur 內容的系統數據指標。 此參數可以是下列其中一個值。

值 意義
OCR_NORMAL
32512		 一般選取
OCR_IBEAM
32513		 文字選取
OCR_WAIT
32514		 忙碌
OCR_CROSS
32515		 有效位數選取
OCR_UP
32516		 替代選取
OCR_SIZENWSE
32642		 對角線重設大小 1
OCR_SIZENESW
32643		 對角線重設大小 2
OCR_SIZEWE
32644		 水平重設大小
OCR_SIZENS
32645		 垂直重設大小
OCR_SIZEALL
32646		 移動
OCR_NO
32648		 [無法使用]
OCR_HAND
32649		 連結選取
OCR_APPSTARTING
32650		 在背景中工作

傳回值

類型： BOOL

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

若要讓應用程式使用任何OCR_常數，必須先定義常數 OEMRESOURCE ，才能包含 Windows.h 頭檔。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 winuser.h (包含 Windows.h)
程式庫 User32.lib
Dll User32.dll

另請參閱

概念

資料指標

DestroyCursor

LoadCursor

LoadCursorFromFile

參考

SetCursor