ContactManager.ShowContactCard Метод

Определение

Пространство имен:

Windows.ApplicationModel.Contacts

Перегрузки

ShowContactCard(Contact, Rect)	Запрашивает контакт пользователя в операционной системе и отображает данные контакта в карта контакта.
ShowContactCard(Contact, Rect, Placement)	Запрашивает контакт пользователя в операционной системе и отображает данные контакта в карта контакта.
ShowContactCard(Contact, Rect, Placement, ContactCardOptions)	Отображает контактную карта с указанными параметрами.

ShowContactCard(Contact, Rect)

Запрашивает контакт пользователя в операционной системе и отображает данные контакта в карта контакта.

public:
 static void ShowContactCard(Contact ^ contact, Rect selection);

/// [Windows.Foundation.Metadata.Overload("ShowContactCard")]
 static void ShowContactCard(Contact const& contact, Rect const& selection);

[Windows.Foundation.Metadata.Overload("ShowContactCard")]
public static void ShowContactCard(Contact contact, Rect selection);

function showContactCard(contact, selection)

Public Shared Sub ShowContactCard (contact As Contact, selection As Rect)

Параметры

contact

Contact

Объект , представляющий контакт, для карта приложение.Контакт должен содержать по крайней мере идентификатор, сообщения электронной почты или номер телефона из списка телефонов, чтобы запросить базу данных контактов пользователя для получения соответствующего контакта для отображения. Идентификатор имеет более высокий приоритет для запросов. Если идентификатор совпадает, остальные параметры запроса будут игнорироваться в целях сопоставления. Если идентификатор не находит совпадение, запрос использует остальные параметры запроса. Сообщения электронной почты и телефоны имеют одинаковый приоритет для сопоставления. Если указано несколько адресов электронной почты, номеров телефонов или и то, и другое, запрос сначала выполняет точное совпадение, требуя, чтобы все параметры запроса соответствовали системной записи контакта. Если это не приводит к совпадениям, запрос использует совпадение с "наилучшими усилиями", в котором достаточно совпадения любых параметров запроса.

Если совпадений не происходит, данные во входном контакте отображаются в карта контакта. В случае совпадения отображаются только системные контактные данные, а данные во входном контакте удаляются.

selection

Rect

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

Атрибуты

OverloadAttribute

Требования к Windows

Возможности приложения

contactsSystem

Комментарии

Примечание

Для вызова этого метода исходные приложения должны выполняться на переднем плане. Приложение, работающее в фоновом режиме, получит исключение "Доступ запрещен" при вызове этого метода.

Большинство типичных операций приводят к отображению пользовательского интерфейса.

• Если для запрошенного контакта имеется одно точное совпадение: Отображает пользовательский интерфейс карта контакта со сведениями из хранилища контактов в операционной системе.
• Если совпадений несколько: Отображает пользовательский интерфейс карта контакта для первого найденного соответствующего контакта.
• Если совпадений нет: Отображает контактную карта пользовательского интерфейса, где контактные данные поступают из входного объекта контакта.

Если есть ошибка, например недопустимые входные данные для параметра contact , пользовательский интерфейс не отображается.

В целях запроса номера телефонов поддерживают символы от 0 до 9 и a-z/A-Z. Если в номер телефона введены другие символы, они игнорируются при запросе контакта.

Сведения об управлении контактами см. в разделе Контакты и календарь.

В целях запроса номера телефонов поддерживают символы от 0 до 9 и a-z/A-Z. Если в номер телефона введены другие символы, они игнорируются при запросе контакта.

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

• ShowContactCard(Contact, Rect, Placement)

ShowContactCard(Contact, Rect, Placement)

Запрашивает контакт пользователя в операционной системе и отображает данные контакта в карта контакта.

public:
 static void ShowContactCard(Contact ^ contact, Rect selection, Placement preferredPlacement);

/// [Windows.Foundation.Metadata.Overload("ShowContactCardWithPlacement")]
 static void ShowContactCard(Contact const& contact, Rect const& selection, Placement const& preferredPlacement);

[Windows.Foundation.Metadata.Overload("ShowContactCardWithPlacement")]
public static void ShowContactCard(Contact contact, Rect selection, Placement preferredPlacement);

function showContactCard(contact, selection, preferredPlacement)

Public Shared Sub ShowContactCard (contact As Contact, selection As Rect, preferredPlacement As Placement)

Параметры

contact

Contact

Объект , представляющий контакт, для карта приложение.Контакт должен содержать по крайней мере идентификатор, сообщения электронной почты или номер телефона из списка телефонов, чтобы запросить базу данных контактов пользователя для получения соответствующего контакта для отображения. Идентификатор имеет более высокий приоритет для запросов. Если идентификатор совпадает, остальные параметры запроса будут игнорироваться в целях сопоставления. Если идентификатор не находит совпадение, запрос использует остальные параметры запроса. Сообщения электронной почты и телефоны имеют одинаковый приоритет для сопоставления. Если указано несколько адресов электронной почты, номеров телефонов или и то, и другое, запрос сначала выполняет точное совпадение, требуя, чтобы все параметры запроса соответствовали системной записи контакта. Если это не приводит к совпадениям, запрос использует совпадение с "наилучшими усилиями", в котором достаточно совпадения любых параметров запроса.

Если совпадений не происходит, данные во входном контакте отображаются в карта контакта. В случае совпадения отображаются только системные контактные данные, а данные во входном контакте удаляются.

selection

Rect

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

preferredPlacement

Placement

Размещение, описывающее предпочтительное размещение контакта, карта.

Атрибуты

OverloadAttribute

Требования к Windows

Возможности приложения

contactsSystem

Комментарии

См. раздел примечаний этой перегрузки: ShowContactCard.

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

• ShowContactCard(Contact, Rect)
• Пример API диспетчера контактов
• IContactManagerInterop.ShowContactCardForWindow

ShowContactCard(Contact, Rect, Placement, ContactCardOptions)

Отображает контактную карта с указанными параметрами.

public:
 static void ShowContactCard(Contact ^ contact, Rect selection, Placement preferredPlacement, ContactCardOptions ^ contactCardOptions);

/// [Windows.Foundation.Metadata.Overload("ShowContactCardWithOptions")]
 static void ShowContactCard(Contact const& contact, Rect const& selection, Placement const& preferredPlacement, ContactCardOptions const& contactCardOptions);

[Windows.Foundation.Metadata.Overload("ShowContactCardWithOptions")]
public static void ShowContactCard(Contact contact, Rect selection, Placement preferredPlacement, ContactCardOptions contactCardOptions);

function showContactCard(contact, selection, preferredPlacement, contactCardOptions)

Public Shared Sub ShowContactCard (contact As Contact, selection As Rect, preferredPlacement As Placement, contactCardOptions As ContactCardOptions)

Параметры

contact

Contact

Объект , представляющий контакт, для карта приложение.Контакт должен содержать по крайней мере идентификатор, сообщения электронной почты или номер телефона из списка телефонов, чтобы запросить базу данных контактов пользователя для получения соответствующего контакта для отображения. Идентификатор имеет более высокий приоритет для запросов. Если идентификатор совпадает, остальные параметры запроса будут игнорироваться в целях сопоставления. Если идентификатор не находит совпадение, запрос использует остальные параметры запроса. Сообщения электронной почты и телефоны имеют одинаковый приоритет для сопоставления. Если указано несколько адресов электронной почты, номеров телефонов или и то, и другое, запрос сначала выполняет точное совпадение, требуя, чтобы все параметры запроса соответствовали системной записи контакта. Если это не приводит к совпадениям, запрос использует совпадение с "наилучшими усилиями", в котором достаточно совпадения любых параметров запроса.

Если совпадений не происходит, данные во входном контакте отображаются в карта контакта. В случае совпадения отображаются только системные контактные данные, а данные во входном контакте удаляются.

selection

Rect

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

preferredPlacement

Placement

Размещение, описывающее предпочтительное размещение контакта, карта.

contactCardOptions

ContactCardOptions

Указывает способ отображения карта контакта, например, на какой вкладке начинаться при отображении мини-контакта карта.

Атрибуты

OverloadAttribute

Требования к Windows

Возможности приложения

contactsSystem

Комментарии

См. раздел примечаний этой перегрузки: ShowContactCard.

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

• ShowContactCard(Contact, Rect)
• ShowContactCard(Contact, Rect, Placement)