共用方式為


WM_POINTERENTER訊息

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

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

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

包含指標的點位置。

注意

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

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

傳回值

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

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

言論

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

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

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

![重要]
當視窗失去指標的擷取並收到 WM_POINTERCAPTURECHANGED 通知時,通常不會收到任何進一步的通知。 因此,請務必不要根據平均配對的 WM_POINTERDOWN/WM_POINTERUPWM_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