共用方式為

ITfKeystrokeMgr：：KeyUp 方法 (msctf.h)

  • 發行項

將按鍵向上事件傳遞至按鍵管理員。

語法

HRESULT KeyUp(
  [in]  WPARAM wParam,
  [in]  LPARAM lParam,
  [out] BOOL   *pfEaten
);

參數

[in] wParam

指定金鑰的虛擬金鑰碼。 如需此參數的詳細資訊，請參閱 WM_KEYUP 中的 wParam 參數。

[in] lParam

指定金鑰的重複計數、掃描程式代碼、擴充索引鍵旗標、內容代碼、先前的索引鍵狀態旗標和轉換狀態旗標。 如需此參數的詳細資訊，請參閱 WM_KEYUP 中的 lParam 參數。

[out] pfEaten

在結束時，BOOL 的指標會指出是否要處理索引鍵事件。 如果此值收到 TRUE，則會處理索引鍵事件，而且不應該將事件轉送到應用程式。 如果此值為 FALSE，則不會處理索引鍵事件，而且事件應該轉送至應用程式。

傳回值

這個方法可以傳回其中一個值。

值 描述
S_OK
 此方法成功。
S_FALSE
 未安裝任何索引鍵事件接收。
E_INVALIDARG
 一或多個參數無效。

備註

如果這個方法成功且 pfKey 收到 TRUE，應用程式就不應該處理密鑰關閉事件。 如果這個方法未傳回S_OK或 pf一 收到 FALSE，應用程式應該處理密鑰關閉事件。 以下是如何實作此作業的範例。


if(msg.message == WM_KEYUP)
{
    if( pKeyboardMgr->TestKeyUp(msg.wParam, msg.lParam, &fEaten) == S_OK 
        && fEaten 
        && pKeyboardMgr->KeyUp(msg.wParam, msg.lParam, &fEaten) == S_OK 
        && fEaten)
    {
        //The key was handled by the keystroke manager or a TSF text service. Do not pass the key to the application. 
        continue;
    }
    else
    {
        //Let the application process the key. 
    }
}

如果按鍵管理員未處理按鍵事件，它會呼叫文字服務 ITfKeyEventSink：：OnKeyUp 方法，將索引鍵事件傳遞至文字服務。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 msctf.h
Dll Msctf.dll
可轉散發套件 Windows 2000 專業版上的 TSF 1.0

另請參閱