Поделиться через


Метод IContactManagerInterop::ShowContactCardForWindow (shobjidl_core.h)

Отображает пользовательский интерфейс для контакта в указанном окне.

Синтаксис

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

Параметры

[in] appWindow

Тип: HWND

HWND окна переднего плана приложения, из которого запускается карта контакта и куда возвращается фокус при закрытии карта контакта.

[in] contact

Тип: IUnknown*

Указатель на объект contact. Используйте объект Windows.ApplicationModel.Contacts.Contact, но приведите его к IUnknown, так как классический КОД COM не может использовать среда выполнения Windows типы.

[in] selection

Тип: RECT const*

Прямоугольник — это прямоугольная область выбора пользователем (например, нажатие кнопки), вокруг которой операционная система отображает контактную карта, а не в этой прямоугольной области. Например, если приложение использует кнопку для отображения карта контакта, передайте прямоугольник кнопки, чтобы карта контакта отображались вокруг кнопки, а не перекрывая ее.

[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, успешно ли отображается карта контакта
  • E_POINTER, если appWindow имеет значение NULL, контакт имеет значение NULL или выбор имеет значение NULL
  • E_INVALIDARG, если contact не является объектом Windows.ApplicationModel.Contacts.Contact или preferredPlacement является недопустимым значением перечисления
Возможны и другие значения HRESULT .

Требования

Требование Значение
Минимальная версия клиента Windows 8.1 [только классические приложения]
Минимальная версия сервера Windows Server 2012 R2 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h

См. также раздел

IContactManagerInterop

ShowContactCardForWindow