共用方式為


ITextServices::OnTxInPlaceActivate 方法 (textserv.h)

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

語法

HRESULT OnTxInPlaceActivate(
  [in] LPCRECT prcClient
);

參數

[in] prcClient

類型:const RECT*

控制項的用戶端矩形。

傳回值

類型: HRESULT

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

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

備註

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

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

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

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

需求

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

另請參閱

概念

ITextServices

OnTxUIActivate

其他資源

矩形

參考

TxGetClientRect

WM_KILLFOCUS

WM_SETFOCUS

無視窗豐富編輯控制項