共用方式為


WM_POINTERDOWN訊息

當指標在視窗的工作區上連絡時張貼。 此輸入訊息是以指標接觸的視窗為目標,而指標會隱含地擷取至視窗,讓視窗繼續接收指標的輸入,直到中斷接觸為止。

視窗會透過其 WindowProc 函式接收此訊息。

![重要]
傳統型應用程式應能感知 DPI。 如果您的應用程式沒有 DPI 感知,指標訊息和相關結構中包含的螢幕座標可能會因為 DPI 虛擬化而顯示不正確。 DPI 虛擬化可為非 DPI 感知且預設為作用中的應用程式提供自動縮放支援(使用者可以將其關閉)。 如需詳細資訊,請參閱 撰寫高 DPI Win32 應用程式

#define WM_POINTERDOWN                   0x0246

參數

wParam

包含指標的相關信息。 使用下列宏從 wParam 參數擷取資訊。

  • GET_POINTERID_WPARAM(wParam):指標標識符。

  • IS_POINTER_NEW_WPARAM(wParam):指出此訊息是否代表新指標所產生的第一個輸入的旗標。

  • IS_POINTER_INRANGE_WPARAM(wParam):旗標,指出此訊息是否由指標在其存留期間產生。 未在訊息上設定此旗標,指出指標已離開偵測範圍

  • IS_POINTER_INCONTACT_WPARAM(wParam):指出此訊息是否由與視窗表面接觸的指標所產生。 此旗標不會在指出暫留指標的訊息上設定。

  • IS_POINTER_PRIMARY_WPARAM(wParam):表示此指標已指定為主要指標。

  • IS_POINTER_FIRSTBUTTON_WPARAM(wParam):指出是否有主要動作的旗標。

    • 這類似於滑鼠左鍵向下。
    • 觸控指標會在與數位板表面接觸時設定此設定。
    • 當手寫筆指標與數位板表面接觸且未按下任何按鈕時,就會有此設定。
  • IS_POINTER_SECONDBUTTON_WPARAM(wParam):指出是否有次要動作的旗標。

    • 這類似於滑鼠右鍵向下。
    • 當手寫筆指標與數位板表面接觸並按下手寫筆桶按鈕時,就會有這個設定。
  • IS_POINTER_THIRDBUTTON_WPARAM(wParam):指出指標類型是否有一或多個第三個動作的旗標;想要回應第三個動作的應用程式必須擷取指標類型特定的資訊,以判斷按下哪一個第三個按鈕。 例如,應用程式可以呼叫 GetPointerPenInfo 並檢查指定按鈕狀態的旗標,以判斷手寫筆的按鈕狀態。

  • IS_POINTER_FOURTHBUTTON_WPARAM(wParam):指出指定指標是否採取第四個動作的旗標。 想要回應第四個動作的應用程式必須擷取指標類型特定的資訊,以判斷是否按下第一個擴充滑鼠 (XButton1) 按鈕。

  • IS_POINTER_FIFTHBUTTON_WPARAM(wParam):指出指定指標是否採取第五個動作的旗標。 想要回應第五個動作的應用程式必須擷取指標類型特定的資訊,以判斷是否按下第二個擴充滑鼠 (XButton2) 按鈕。

    如需詳細資訊,請參閱指標旗標

    注意

    暫留指標沒有設定任何按鈕旗標。 這類似於滑鼠移動,沒有滑鼠按鈕向下移動。 例如,應用程式可以呼叫 GetPointerPenInfo 並檢查指定按鈕狀態的旗標,來判斷暫留畫筆的按鈕狀態。

lParam

包含指標的點位置。

注意

由於指標可能會透過非簡單區域與裝置接觸,因此這個點位置可能會簡化更複雜的指標區域。 盡可能使用完整的指標區域資訊,而不是點位置。

使用下列宏來擷取點的實體螢幕座標。

  • GET_X_LPARAM(lParam):x(水平點)座標。
  • GET_Y_LPARAM(lParam): y (垂直點) 座標。

傳回值

如果應用程式處理此訊息,它應該會傳回零。

如果應用程式未處理此訊息,它應該呼叫DefWindowProc

備註

![重要]
當視窗失去指標的擷取並收到 WM_POINTERCAPTURECHANGED 通知時,通常不會收到任何進一步的通知。 因此,請務必不要根據平均配對WM_POINTERDOWN WM_POINTERUP/WM_POINTERENTER WM_POINTERLEAVE/通知做出任何假設。

每個指標在其存留期間都有唯一的指標標識碼。 指標的存留期會在第一次偵測到指標時開始。

如果偵測到暫留指標,就會產生WM_POINTERENTER訊息。 如果偵測到非暫留指標,就會產生WM_POINTERDOWN訊息,後面接著WM_POINTERENTER訊息。

在其存留期間,指標可能會在暫留或連絡時產生一系列 WM_POINTERUPDATE 訊息。

指標的存留期會在不再偵測到指標時結束。 這會產生 WM_POINTERLEAVE 訊息。

當指標中止時, 會設定POINTER_FLAG_CANCELED

當非擷取的指標在視窗界限外移動時,也可能會產生WM_POINTERLEAVE訊息。

若要取得指標的水平和垂直位置,請使用下列專案:

xPos = GET_X_LPARAM(lParam); 
yPos = GET_Y_LPARAM(lParam);

若要將 lParam 參數轉換成 POINTS) 結構,請使用 MAKEPOINTS 宏。

若要擷取與訊息相關聯的進一步資訊,請使用 GetPointerInfo 函式。

若要判斷與此訊息相關聯的鍵盤輔助按鍵狀態,請使用 GetKeyState 函式。 例如,若要偵測已按下 ALT 鍵,請檢查 GetKeyState(VK_MENU) < 0。

請注意,如果應用程式未處理此訊息,如果來自這個 的輸入序列,DefWindowProc 可能會產生一或多個WM_GESTURE訊息,而且可能會將其他指標辨識為手勢。 如果無法辨識手勢, DefWindowProc 可能會產生滑鼠輸入。

如果應用程式選擇性地取用某些指標輸入,並將其餘部分傳遞至 DefWindowProc,則產生的行為是未定義的。

當視窗失去指標的擷取並接收 WM_POINTERCAPTURECHANGED 通知時,通常不會收到任何進一步的通知。 因此,不論視窗是否收到平均配對的 DOWN/UP 或 ENTER/LEAVE 通知,視窗都不會對其指標狀態進行任何假設。

範例

下列程式代碼範例示範如何使用IS_POINTER_FIRSTBUTTON_WPARAMGET_X_LPARAM、GET_Y_LPARAMIS_POINTER_SECONDBUTTON_WPARAM來擷取與WM_POINTERDOWN訊息相關聯的相關信息。

int xPos = GET_X_LPARAM(lParam);
int yPos = GET_Y_LPARAM(lParam);

if (IS_POINTER_PRIMARYBUTTON_WPARAM(wParam))
{
    // process pointer down, similar to mouse left button down
}
else if (IS_POINTER_SECONDARYBUTTON_WPARAM(wParam))
{
    // process pointer down, similar to mouse right button down
}

下列程式代碼範例示範如何使用 GET_POINTERID_WPARAM 從WM_POINTERDOWN訊息擷 指標標識碼。

POINTER_INFO pointerInfo;
UINT32       pointerId = GET_POINTERID_WPARAM(wParam);

// Retrieve common pointer information
if (!GetPointerInfo(pointerId, &pointerInfo))
{
    // failure, call GetLastError()
}
else
{
    // success, process pointerInfo
}

下列程式代碼範例示範如何處理不同的指標類型,例如觸控、手寫筆或預設指標裝置。

POINTER_TOUCH_INFO   touchInfo;
POINTER_PEN_INFO     penInfo;
POINTER_INFO         pointerInfo;
UINT32               pointerId = GET_POINTERID_WPARAM(wParam);
POINTER_TYPE         pointerType = PT_POINTER;

// default to unhandled to enable call to DefWindowProc
fHandled = FALSE;

if (!GetPointerType(pointerId, &pointerType))
{
    // failure, call GetLastError()
    // set PT_POINTER to fall to default case below
    pointerType = PT_POINTER;
}

switch (pointerType)
{
case PT_TOUCH:
    // Retrieve touch information
    if (!GetPointerTouchInfo(pointerId, &touchInfo))
    {
        // failure, call GetLastError()
    }
    else
    {
        // success, process touchInfo
        // mark as handled to skip call to DefWindowProc
        fHandled = TRUE;
    }
    break;
case PT_PEN:
    // Retrieve pen information
    if (!GetPointerPenInfo(pointerId, &penInfo))
    {
        // failure, call GetLastError()
    }
    else
    {
        // success, process penInfo
        // mark as handled to skip call to DefWindowProc
        fHandled = TRUE;
    }
    break;
default:
    if (!GetPointerInfo(pointerId, &pointerInfo)) 
    {
        // failure.
    } 
    else 
    {
        // success, proceed with pointerInfo.
        fHandled = HandleGenericPointerMessage(&pointerInfo);
    }
    break;
}

需求

需求
最低支援的用戶端
Windows 8 [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2012 [僅限傳統型應用程式]
頁首
Winuser.h (包括 Windows.h)

另請參閱

訊息

參考

指標旗標

GET_POINTERID_WPARAM

IS_POINTER_NEW_WPARAM

IS_POINTER_INRANGE_WPARAM

IS_POINTER_INCONTACT_WPARAM

IS_POINTER_PRIMARY_WPARAM

IS_POINTER_FIRSTBUTTON_WPARAM

IS_POINTER_SECONDBUTTON_WPARAM

IS_POINTER_THIRDBUTTON_WPARAM

IS_POINTER_FOURTHBUTTON_WPARAM

IS_POINTER_FIFTHBUTTON_WPARAM