指標旗標

可以出現在 POINTER_INFO 結構的 pointerFlags 欄位中的值。

POINTER_FLAG_NONE

0x00000000

違約

POINTER_FLAG_NEW

0x00000001

表示新指標的抵達。

POINTER_FLAG_INRANGE

0x00000002

表示此指標會繼續存在。 未設定此旗標時，表示指標已離開偵測範圍。

當暫留指標離開偵測範圍（POINTER_FLAG_UPDATE 已設定）或當與視窗表面接觸的指標離開偵測範圍時，通常不會設定此旗標（POINTER_FLAG_UP 設定）。

POINTER_FLAG_INCONTACT

0x00000004

表示此指標與數位板介面接觸。 未設定此旗標時，表示暫留指標。

POINTER_FLAG_FIRSTBUTTON

0x00000010

表示主要動作，類似於滑鼠左鍵向下。

觸控指標會在與數位板表面接觸時設定此旗標。

當手寫筆指標與數位板表面接觸且未按下按鈕時，就會設定此旗標。

滑鼠指標會在滑鼠左鍵關閉時設定此旗標。

POINTER_FLAG_SECONDBUTTON

0x00000020

表示次要動作，類似於滑鼠右鍵向下。

觸控指標不會使用此旗標。

手寫筆指標會在與數位板表面接觸時設定此旗標，並按下手寫筆桶按鈕。

當滑鼠右鍵關閉時，滑鼠指標會設定此旗標。

POINTER_FLAG_THIRDBUTTON

0x00000040

類似於滑鼠滾輪按鈕向下。

觸控指標不會使用此旗標。

畫筆指標不會使用此旗標。

當滑鼠滾輪按鈕關閉時，滑鼠指標會設定此旗標。

POINTER_FLAG_FOURTHBUTTON

0x00000080

類似於第一個擴充滑鼠 （XButton1） 按鈕向下。

觸控指標不會使用此旗標。

畫筆指標不會使用此旗標。

當第一個擴充滑鼠 （XBUTTON1） 按鈕關閉時，滑鼠指標會設定此旗標。

POINTER_FLAG_FIFTHBUTTON

0x00000100

類似於第二個延長滑鼠 （XButton2） 按鈕向下。

觸控指標不會使用此旗標。

畫筆指標不會使用此旗標。

當第二個擴充滑鼠 （XBUTTON2） 按鈕關閉時，滑鼠指標會設定此旗標。

POINTER_FLAG_PRIMARY

0x00002000

表示此指標已指定為主要指標。 主指標是單一指標，可以執行非主要指標以外的動作。 例如，當主指標與視窗表面接觸時，它可能會提供視窗透過傳送 WM_POINTERACTIVATE 訊息來啟用的機會。

主要指標是從系統上的所有目前用戶互動識別（滑鼠、觸控、手寫筆等等）。 因此，主要指標可能不會與您的應用程式產生關聯。 多點觸控互動中的第一個聯繫人會設定為主要指標。 識別主要指標之後，必須先解除所有聯繫人，才能將新的聯繫人識別為主要指標。 對於未處理指標輸入的應用程式，只會將主指標的事件升階為滑鼠事件。

POINTER_FLAG_CONFIDENCE

0x000004000

信賴度是來源裝置關於指標是否代表預定或意外互動的建議，這與意外互動（例如手掌）可以觸發輸入的PT_TOUCH指標特別相關。 此旗標的存在表示來源裝置對此輸入是預定互動的一部分具有很高的信賴度。

POINTER_FLAG_CANCELED

0x000008000

表示指標會以異常方式離開，例如當系統收到無效的指標輸入，或當具有作用中指標的裝置突然離開時。 如果接收輸入的應用程式處於該動作的位置，它應該會將互動視為未完成，並反轉相關指標的任何影響。

POINTER_FLAG_DOWN

0x00010000

表示此指標已轉換為向下狀態;也就是說，它與數位板表面接觸。

POINTER_FLAG_UPDATE

0x00020000

表示這是不包含指標狀態變更的簡單更新。

POINTER_FLAG_UP

0x00040000

表示此指標已轉換至向上狀態;也就是說，與數位板表面接觸已結束。

POINTER_FLAG_WHEEL

0x00080000

表示與指標方向盤相關聯的輸入。 對於滑鼠指標，這相當於滑鼠滾輪的動作（WM_MOUSEHWHEEL）。

POINTER_FLAG_HWHEEL

0x00100000

表示與指標 h-wheel 相關聯的輸入。 對於滑鼠指標，這相當於滑鼠水準滾動輪的動作（WM_MOUSEHWHEEL）。

POINTER_FLAG_CAPTURECHANGED

0x00200000

表示此指標是由另一個元素所擷取，而原始元素已遺失擷取（請參閱 WM_POINTERCAPTURECHANGED）。

POINTER_FLAG_HASTRANSFORM

0x00400000

表示此指標具有相關聯的轉換。

言論

XBUTTON1和XBUTTON2是許多滑鼠裝置上使用的其他按鈕。 它們會傳回與標準滑鼠按鈕相同的數據。

要求

另請參閱

常數

POINTER_INFO

POINTER_BUTTON_CHANGE_TYPE