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

Статья
03/05/2024

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

Синтаксис

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

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