共用方式為

IContactManagerInterop：：ShowContactCardForWindow 方法 (shobjidl_core.h)

  • 發行項

顯示指定視窗上聯繫人的UI。

語法

HRESULT ShowContactCardForWindow(
  [in] HWND             appWindow,
  [in] IUnknown         *contact,
  [in] const RECT       *selection,
  [in] FLYOUT_PLACEMENT preferredPlacement
);

參數

[in] appWindow

類型： HWND

啟動連絡人卡片的應用程式前景視窗 HWND ，以及在關閉連絡人卡片時傳回焦點的位置。

[in] contact

類型： IUnknown*

聯繫人物件的指標。 使用 Windows.ApplicationModel.Contacts.Contact 物件，但在這裡轉換成 IUnknown，因為傳統 COM IDL 無法使用 Windows 執行階段 類型。

[in] selection

類型： RECT const*

Rect 是使用者選取範圍的矩形區域 (例如，按下按鈕) ，操作系統會在其周圍顯示聯繫人卡片，而不是在該矩形區域內。 例如，如果應用程式使用按鈕來顯示聯繫人卡片，請傳遞按鈕的 Rect ，讓連絡人卡片在按鈕周圍顯示，而不會重疊。

[in] preferredPlacement

類型： FLYOUT_PLACEMENT

描述聯繫人卡片慣用位置 的FLYOUT_PLACEMENT型別值。

值 意義
FP_DEFAULT
0
 使用預設值。
FP_ABOVE
1
 偏好將聯繫人卡片放在 選取 參數所指定用戶選取範圍的矩形區域上方。
FP_BELOW
2
 偏好將聯繫人卡片放在選取參數所指定用戶 選取 範圍的矩形區域下方。
FP_LEFT
3
 偏好將聯繫人卡片放在選取範圍參數所指定用戶 選取 範圍的矩形區域左邊。
FP_RIGHT
4
 偏好將聯繫人卡片放在選取範圍參數所指定用戶 選取 範圍的矩形區域右邊。

傳回值

類型： HRESULT

ShowContactCardForWindow 會傳回：

  • 如果已成功顯示聯繫人卡片，S_OK
  • 如果 appWindow 為 NULL 或 連絡人 為 NULL 或 選取範圍 為 NULL，則E_POINTER
  • E_INVALIDARG如果 聯繫人 不是 Windows.ApplicationModel.Contacts.Contact 物件或 preferredPlacement 是無效的列舉值
其他 HRESULT 值可能。

規格需求

需求 值
最低支援的用戶端 Windows 8.1 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h

另請參閱

IContactManagerInterop

ShowContactCardForWindow