WM_GESTURE訊息
傳遞手勢的相關資訊。
-
wParam
-
提供識別手勢命令和筆勢特定引數值的資訊。 這項資訊與在 GESTUREINFO結構的ullArguments成員中傳遞的資訊相同。
-
lParam
-
提供識別手勢命令和筆勢特定引數值之資訊的控制碼。 呼叫 GetGestureInfo即可擷取這項資訊。
如果應用程式處理此訊息,它應該會傳回 0。
如果應用程式未處理訊息,則必須呼叫 DefWindowProc。 不這麼做會導致應用程式流失記憶體,因為不會關閉觸控輸入控制碼,而且不會釋放相關聯的進程記憶體。
下表列出支援的手勢命令。
筆勢識別碼 | 值 (dwID) | 描述 |
---|---|---|
GID_BEGIN | 1 | 表示泛型手勢正在開始。 |
GID_END | 2 | 表示泛型手勢結束。 |
GID_ZOOM | 3 | 表示縮放開始、縮放移動或縮放停止。 第一 個GID_ZOOM 命令訊息會開始縮放,但不會造成任何縮放。 第二 個GID_ZOOM 命令會觸發相對於第一個 GID_ZOOM中包含的狀態的縮放。 |
GID_PAN | 4 | 表示移動流覽或移動流覽開始。 第一個 GID_PAN 命令表示移動流覽開始,但不會執行任何移動流覽。 使用第二 個GID_PAN 命令訊息時,應用程式會開始移動流覽。 |
GID_ROTATE | 5 | 表示旋轉移動或旋轉開始。 第一 個GID_ROTATE 命令訊息表示旋轉移動或旋轉開始,但不會旋轉。 第二個 GID_ROTATE 命令訊息會觸發相對於第一個GID_ROTATE中包含的狀態的輪 替作業。 |
GID_TWOFINGERTAP | 6 | 表示雙指點選手勢。 |
GID_PRESSANDTAP | 7 | 表示按下和點選手勢。 |
注意
若要啟用舊版支援,必須使用DefWindowProc轉送具有GID_BEGIN和GID_END手勢命令的訊息。
下表指出 lParam 和 wParam 參數中傳遞的筆勢引數。
筆勢識別碼 | 手勢 | ullArgument | GestureInfo結構中的ptsLocation |
---|---|---|---|
GID_ZOOM | 放大/縮小 | 表示兩點之間的距離。 | 表示縮放的中心。 |
GID_PAN | 移動瀏覽 | 表示兩點之間的距離。 | 表示移動流覽的目前位置。 |
GID_ROTATE | 旋轉 (樞紐) | 指出設定GF_BEGIN旗標時 旋轉 的角度。 否則,這是自旋轉開始後的角度變更。 這是帶正負號的,表示旋轉的方向。 使用 GID_ROTATE_ANGLE_FROM_ARGUMENT 和 GID_ROTATE_ANGLE_TO_ARGUMENT 宏來取得和設定角度值。 | 這表示旋轉的中心,這是目標物件繞著旋轉的固定點。 |
GID_TWOFINGERTAP | 雙指點選 | 表示兩指之間的距離。 | 表示兩指的中心。 |
GID_PRESSANDTAP | 按下並點選 | 表示第一個手指與第二指之間的差異。 此值會儲存在POINT結構中ullArgument的較低 32 位中。 | 表示第一個手指下拉的位置。 |
注意
所有距離和位置都會以實體螢幕座標提供。
注意
dwID和ullArgument參數應該只被視為隨附GID_* 命令,且不應由應用程式改變。
下列程式碼說明如何取得與此訊息相關聯的手勢特定資訊。
注意
您應該一律將未處理的訊息轉送至 DefWindowProc ,而且應該關閉對 CloseGestureInfoHandle呼叫所處理之訊息的手勢輸入控制碼。 在此範例中,預設的手勢處理常式行為將會隱藏,因為 TOUCHINPUT 控制碼會在每一個手勢案例中關閉。 如果您針對未處理的訊息移除上述程式碼中的案例,預設手勢處理常式會在預設案例中轉寄至 DefWindowProc 來處理訊息。
LRESULT DecodeGesture(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam){
// Create a structure to populate and retrieve the extra message info.
GESTUREINFO gi;
ZeroMemory(&gi, sizeof(GESTUREINFO));
gi.cbSize = sizeof(GESTUREINFO);
BOOL bResult = GetGestureInfo((HGESTUREINFO)lParam, &gi);
BOOL bHandled = FALSE;
if (bResult){
// now interpret the gesture
switch (gi.dwID){
case GID_ZOOM:
// Code for zooming goes here
bHandled = TRUE;
break;
case GID_PAN:
// Code for panning goes here
bHandled = TRUE;
break;
case GID_ROTATE:
// Code for rotation goes here
bHandled = TRUE;
break;
case GID_TWOFINGERTAP:
// Code for two-finger tap goes here
bHandled = TRUE;
break;
case GID_PRESSANDTAP:
// Code for roll over goes here
bHandled = TRUE;
break;
default:
// A gesture was not recognized
break;
}
}else{
DWORD dwErr = GetLastError();
if (dwErr > 0){
//MessageBoxW(hWnd, L"Error!", L"Could not retrieve a GESTUREINFO structure.", MB_OK);
}
}
if (bHandled){
return 0;
}else{
return DefWindowProc(hWnd, message, wParam, lParam);
}
}
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows 7 [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2008 R2 [僅限桌面應用程式] |
標頭 |
|