ITextServices：：OnTxInPlaceActivate 方法 (textserv.h)

發行項
08/26/2023

通知文字服務物件此控制項就地作用中。

語法

HRESULT OnTxInPlaceActivate(
  [in] LPCRECT prcClient
);

參數

[in] prcClient

類型：const RECT*

控制項的用戶端矩形。

傳回值

類型： HRESULT

如果成功啟用物件，傳回值 會S_OK。

如果因為錯誤而無法啟始物件，傳回值會E_FAIL。如需 COM 錯誤碼的詳細資訊，請參閱 COM 中的錯誤處理。

備註

就地使用中表示内嵌物件正在就地執行 (例如，如果是一般控制項和內嵌，則會有一個視窗可繪製) 。相反地，UI 作用中表示物件目前具有 編輯焦點。例如，容器上的功能表和工具列等專案也可能包含 UI 主動控制項/內嵌中的元素。在任何指定時間只有一個 UI-Active 控制項，而有許多就地作用中的控制項。

請注意，UI 啟用與取得焦點不同。若要向文字服務物件發出控制項取得或失去焦點的訊號，主機會傳送 WM_SETFOCUS 和 WM_KILLFOCUS 訊息。此外，請注意，無視窗主機會以wParam (視窗的形式傳遞Null，而該視窗會遺失這些訊息的焦點) 。

從非作用中狀態直接轉換為 UI-Active 狀態時，主機應該先呼叫 ITextServices：：OnTxInPlaceActivate ，然後再呼叫 ITextServices：：OnTxUIActivate。

ITextServices：：OnTxInPlaceActivate 會採用要啟動之檢視的用戶端矩形參數。這個矩形是在包含視窗的用戶端座標中提供。它與在主機上呼叫 TxGetClientRect 來取得相同。

需求


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