ContactManager.ShowContactCard(Contact, Rect, Placement) | showContactCard(Contact, Rect, Placement) Method

Consulta el sistema operativo para obtener el contacto de un usuario y muestra los datos de contacto en una tarjeta de contacto.

Sintaxis


Windows.ApplicationModel.Contacts.ContactManager.showContactCard(contact, selection, preferredPlacement);

Parámetros

contact

Tipo: Contact

El objeto que representa el contacto cuya tarjeta de contacto pretende mostrar la aplicación.

contact debe contener por lo menos una propiedad Id, Emails o un número de teléfono de una lista de Phones para consultar la base de datos de contactos del usuario y recuperar un contacto para mostrarlo. Id tiene mayor prioridad para consultas. Si un Id coincide, se omitirá el resto de los parámetros de consulta para los fines que coincidan. Si un Id no encuentra una coincidencia, la consulta utiliza el resto de parámetros de la consulta. Las propiedades Emails y Phones tienen la misma prioridad de coincidencia. Si se proporcionan varios mensajes de correo electrónico, o números de teléfono, o ambos, la consulta realiza primero una coincidencia exacta, requiriendo todos los parámetros de consulta para que coincidan con un registro de contacto de sistema. Si esto da lugar a ninguna coincidencia, la consulta utiliza la coincidencia de “mejor esfuerzo”, donde una coincidencia de cualquier parámetro de consulta es suficiente.

Si no aparece ninguna coincidencia, los datos del contacto de entrada se muestra en la tarjeta de contacto. Si hay una coincidencia, solo aparecen los datos de contacto y se descartan los datos del contacto de entrada.

selection

Tipo: Rect

Rect es el área rectangular de la selección del usuario (por ejemplo, la presión de un botón), alrededor de la cual el sistema operativo muestra la tarjeta de contacto, no dentro de dicha área. Por ejemplo, si una aplicación usa un botón para mostrar la tarjeta de contacto, pase el objeto Rect del botón de modo que la tarjeta de contacto se muestre alrededor del botón, no de forma que se superponga en él.

preferredPlacement

Tipo: Placement

Placement que describe la ubicación preferida de la tarjeta de contacto.

Comentarios

Para consultas, los números de teléfono admiten los caracteres 0-9 y a-z/A-Z. Si incluye cualquier otro carácter en un número de teléfono, se omite cuando se consulta el contacto.

Requisitos

Cliente mínimo admitido

Windows 8.1

Servidor mínimo admitido

Windows Server 2012 R2

Espacio de nombres

Windows.ApplicationModel.Contacts
Windows::ApplicationModel::Contacts [C++]

Metadatos

Windows.winmd

Vea también

ContactManager
IContactManagerInterop::ShowContactCardForWindow
ShowContactCard(Contact, Rect)

 

 

Mostrar:
© 2015 Microsoft