IDirectManipulationViewport：：SetContact 方法 (directmanipulation.h)

指定連絡人與檢視區之間的關聯。

語法

HRESULT SetContact(
  [in] UINT32 pointerId
);

參數

[in] pointerId

指標的識別碼。

傳回值

如果方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

收到 WM_POINTERDOWN 訊息時，請呼叫這個方法。 收到 WM_POINTERDOWN時，應用程式可以使用輸入的座標來點擊測試，並判斷連絡人相關聯的檢視區。

在 SetContact 之前，必須先呼叫 DeferContact。

初始化之後， 直接操作 不會察覺檢視區 z 順序或檢視區之間的父子系關聯性。 SetContact呼叫的順序會定義檢視區樹狀結構。 若要建立正確的檢視區階層，應該先在最子檢視區上呼叫 SetContact ，後面接著父系、父系等等。

使用 GET_POINTERID_WPARAM 從指標訊息取得指標識別碼。 收到 WM_POINTERUP 時，會自動移除連絡人。

如果使用 SetContact 方法與一或多個檢視區相關聯， 直接操作 會檢查該連絡人的進一步輸入，並嘗試根據相關聯檢視區的設定來識別適當的操作。 如果辨識操作，應用程式就會收到此連絡人 的WM_POINTERCAPTURECHANGED 訊息。 在此內容中， WM_POINTERCAPTURECHANGED 訊息指出直接操作已擷取連絡人，而應用程式將不會收到此操作所取用此連絡人的輸入。

需求

另請參閱

IDirectManipulationViewport

使用者輸入訊息和通知