WM_POINTERENTER訊息

當新的指標在視窗上進入偵測範圍時傳送至視窗， (暫留) 或現有指標在視窗界限內移動時。

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

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

#define WM_POINTERENTER                 0x0249

參數

wParam

包含指標識別碼和附加資訊。 使用下列宏來擷取 wParam 參數中的特定資訊。

• GET_POINTERID_WPARAM (wParam) ：指標識別碼。
• IS_POINTER_NEW_WPARAM (wParam) ：指出此訊息是否為新指標所產生的第一個訊息， (暫留) 。
• IS_POINTER_INRANGE_WPARAM (wParam) ：指出此訊息是否由未離開偵測範圍的指標產生。 此旗標一律會針對 WM_POINTERENTER 訊息設定。
• IS_POINTER_INCONTACT_WPARAM (wParam) ：旗標，指出此訊息是否由連絡人中的指標產生。 此旗標不會針對偵測範圍中的指標設定， (暫留) 。

lParam

包含指標的點位置。

注意

因為指標可能會透過非簡單區域與裝置接觸，所以這個點位置可能是更複雜的指標區域簡化。 可能的話，應用程式應該使用完整的指標區域資訊，而不是點位置。

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

• GET_X_LPARAM lParam () ：x (水準點) 座標。
• GET_Y_LPARAM (lParam) ：y (垂直點) 座標。

傳回值

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

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

備註

視窗可以使用 WM_POINTERENTER 通知來提供意見反應給使用者，而指標位於其表面上方，或回應其介面上的指標是否存在。

此通知只會傳送至接收指標輸入的視窗。 下表列出傳送此通知的一些情況。

動作	旗標集	傳送至的通知
新的指標會在暫留) (進入偵測範圍。	IS_POINTER_NEW_WPARAM IS_POINTER_INRANGE_WPARAM	指標進入偵測範圍的視窗。
暫留指標在視窗界限內交叉。	IS_POINTER_INRANGE_WPARAM	指標已交叉的視窗。

![重要]
當視窗失去指標的擷取，而且收到 WM_POINTERCAPTURECHANGED 通知時，通常不會收到任何進一步的通知。 基於這個理由，請務必不要根據平均配對的WM_POINTERDOWN WM_POINTERUP/ 或WM_POINTERENTER/WM_POINTERLEAVE通知進行任何假設。

當輸入來自滑鼠時，由於滑鼠和指標訊息整合， 不會傳送WM_POINTERENTER 。

規格需求

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

另請參閱

訊息

參考

GET_POINTERID_WPARAM

IS_POINTER_NEW_WPARAM

IS_POINTER_INRANGE_WPARAM

IS_POINTER_INCONTACT_WPARAM