ITextServices：：OnTxSetCursor 方法 (textserv.h)

發行項
03/13/2024

通知文字服務物件設定游標。

語法

HRESULT OnTxSetCursor(
  [in] DWORD          dwDrawAspect,
       LONG           lindex,
  [in] void           *pvAspect,
  [in] DVTARGETDEVICE *ptd,
  [in] HDC            hdcDraw,
  [in] HDC            hicTargetDev,
  [in] LPCRECT        lprcClient,
  [in] INT            x,
  [in] INT            y
);

參數

[in] dwDrawAspect

類型： DWORD

繪製層面可以是下列其中一個值。

值	意義
DVASPECT_CONTENT	將文字內容的螢幕影像轉譯為 hdcDraw 裝置內容。 hicTargetDev 和 ptd 參數會提供目標裝置內容的相關信息，如果任何 (通常是印表機) 。
DVASPECT_DOCPRINT	將物件轉譯為 hdcDraw 裝置內容，就像列印到印表機一樣。因此，如果白色) ，文字服務對象可以針對印表機優化 (，而不是繪製背景色彩。此外，不應該轉譯特定螢幕元素 (，例如選取範圍) 。 ITextServices：：OnTxSetCursor 應該轉譯 lprcClient 矩形，從目前的捲動位置開始。

lindex

類型： LONG

不支援。

[in] pvAspect

類型： void*

繪圖優化的資訊。

[in] ptd

類型： DVTARGETDEVICE*

目標裝置。

[in] hdcDraw

類型： HDC

轉譯裝置內容。

[in] hicTargetDev

類型： HDC

目標信息內容。

[in] lprcClient

類型： LPCRECT

控制件的用戶端矩形。矩形的座標位於包含視窗的用戶端座標中。 NULL 是合法的值。

[in] x

類型： INT

游標的 x 位置，位於包含視窗的用戶端座標中。

[in] y

類型： INT

游標的 y 位置，位於包含視窗的用戶端座標中。

傳回值

類型： HRESULT

如果方法成功，傳回值 會S_OK。

如果方法失敗，傳回值會是下列 HRESULT 程序代碼。如需 COM 錯誤碼的詳細資訊，請參閱 COM 中的錯誤處理。

傳回碼	Description
E_INVALIDARG	一或多個不合法的參數。

備註

文字服務物件可能會因為這個呼叫而重新測量，以判斷正確的游標。正確的游標是透過 TxSetCursor 設定。

lprcClient 參數是滑鼠游標所在控件檢視的用戶端矩形。 lprcClient 參數位於包含視窗的裝置座標中，與WM_SIZE訊息相同。這可能不是上次轉譯的檢視。此外，如果控件處於就地作用中狀態，這可能不是目前的使用中檢視。因此，文字服務對象應該根據目前快取的值檢查此矩形，並判斷是否需要重新計算行。此計算中應包含縮放因數。如需縮放因數的討論，請參閱 TxGetExtent。

這個方法應該只針對控件的屏幕檢視呼叫。因此，裝置內容 (DC) 不會傳入，但應該假設為螢幕 DC。

如需詳細資訊，請參閱 ITextServices：：TxDraw 中的。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	textserv.h
Dll	Msftedit.dll