ContactManager.ShowContactCard Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| ShowContactCard(Contact, Rect) |
Consulta el sistema operativo para el contacto de un usuario y muestra los datos de contacto en una tarjeta de contacto. |
| ShowContactCard(Contact, Rect, Placement) |
Consulta el sistema operativo para el contacto de un usuario y muestra los datos de contacto en una tarjeta de contacto. |
| ShowContactCard(Contact, Rect, Placement, ContactCardOptions) |
Muestra una tarjeta de contacto con los parámetros especificados. |
ShowContactCard(Contact, Rect)
Consulta el sistema operativo para el contacto de un usuario y muestra los datos de contacto en una tarjeta de contacto.
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)Parámetros
- contact
- Contact
Objeto que representa el contacto para el que la aplicación quiere mostrar la tarjeta de contacto. contact debe contener al menos un identificador, correos electrónicos o un número de teléfono de una lista de teléfonos para consultar la base de datos de contactos del usuario para recuperar un contacto coincidente para mostrarlo. El identificador tiene una prioridad más alta para la consulta. Si un identificador coincide, el resto de parámetros de consulta se omitirá con fines coincidentes. Si un identificador no encuentra una coincidencia, la consulta usa el resto de parámetros de consulta. Los correos electrónicos y teléfonos tienen la misma prioridad para buscar coincidencias. Si se proporcionan varias direcciones de correo electrónico, números de teléfono o ambos, la consulta realiza primero una coincidencia exacta, lo que requiere que todos los parámetros de consulta coincidan con un registro de contacto del sistema. Si esto no da lugar a coincidencias, la consulta usa la coincidencia "mejor esfuerzo", en la que basta con una coincidencia de cualquier parámetro de consulta.
Si no se producen coincidencias, los datos del contacto de entrada se muestran en la tarjeta de contacto. Si se produce una coincidencia, solo se muestran los datos de contacto del sistema y se descartan los datos del contacto de entrada.
- selection
- Rect
El rect es el área rectangular de la selección del usuario (por ejemplo, presionar un botón), alrededor del cual el sistema operativo muestra la tarjeta de contacto, no dentro de ese área rectangular. Por ejemplo, si una aplicación usa un botón para mostrar la tarjeta de contacto, pase la corrección del botón para que la tarjeta de contacto se muestre alrededor del botón, no superpuesta.
- Atributos
Requisitos de Windows
| Características de aplicaciones |
contactsSystem
|
Comentarios
Nota
Las aplicaciones de origen deben ejecutarse en primer plano para llamar a este método. Una aplicación que se ejecuta en segundo plano obtendrá una excepción de "Acceso denegado" si llama a este método.
La mayoría de las operaciones típicas darán lugar a la visualización de una interfaz de usuario.
- Si hay una coincidencia exacta para el contacto solicitado: Muestra la interfaz de usuario de la tarjeta de contacto con información del almacén de contactos en el sistema operativo.
- Si hay varias coincidencias: Muestra la interfaz de usuario de la tarjeta de contacto para el primer contacto coincidente encontrado.
- Si no hay ninguna coincidencia: Muestra la interfaz de usuario de la tarjeta de contacto, donde procede la información de contacto del objeto de contacto de entrada.
Si se produce un error, como una entrada no válida para el parámetro contact , no se muestra ninguna interfaz de usuario.
Con fines de consulta, los números de teléfono admiten caracteres 0-9 y a-z/A-Z. Si coloca algún otro carácter en un número de teléfono, se omiten al consultar el contacto.
Para obtener información sobre cómo administrar contactos, consulta Contactos y calendario.
Con fines de consulta, los números de teléfono admiten caracteres 0-9 y a-z/A-Z. Si coloca algún otro carácter en un número de teléfono, se omiten al consultar el contacto.
Consulte también
Se aplica a
ShowContactCard(Contact, Rect, Placement)
Consulta el sistema operativo para el contacto de un usuario y muestra los datos de contacto en una tarjeta de contacto.
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)Parámetros
- contact
- Contact
Objeto que representa el contacto para el que la aplicación quiere mostrar la tarjeta de contacto. contact debe contener al menos un identificador, correos electrónicos o un número de teléfono de una lista de teléfonos para consultar la base de datos de contactos del usuario para recuperar un contacto coincidente para mostrarlo. El identificador tiene una prioridad más alta para la consulta. Si un identificador coincide, el resto de parámetros de consulta se omitirá con fines coincidentes. Si un identificador no encuentra una coincidencia, la consulta usa el resto de parámetros de consulta. Los correos electrónicos y teléfonos tienen la misma prioridad para buscar coincidencias. Si se proporcionan varias direcciones de correo electrónico, números de teléfono o ambos, la consulta realiza primero una coincidencia exacta, lo que requiere que todos los parámetros de consulta coincidan con un registro de contacto del sistema. Si esto no da lugar a coincidencias, la consulta usa la coincidencia "mejor esfuerzo", en la que basta con una coincidencia de cualquier parámetro de consulta.
Si no se producen coincidencias, los datos del contacto de entrada se muestran en la tarjeta de contacto. Si se produce una coincidencia, solo se muestran los datos de contacto del sistema y se descartan los datos del contacto de entrada.
- selection
- Rect
El rect es el área rectangular de la selección del usuario (por ejemplo, presionar un botón), alrededor del cual el sistema operativo muestra la tarjeta de contacto, no dentro de ese área rectangular. Por ejemplo, si una aplicación usa un botón para mostrar la tarjeta de contacto, pase la corrección del botón para que la tarjeta de contacto se muestre alrededor del botón, no superpuesta.
- preferredPlacement
- Placement
Ubicación que describe la ubicación preferida de la tarjeta de contacto.
- Atributos
Requisitos de Windows
| Características de aplicaciones |
contactsSystem
|
Comentarios
Consulte la sección de comentarios de esta sobrecarga: ShowContactCard.
Consulte también
- ShowContactCard(Contact, Rect)
- Ejemplo de API del administrador de contactos
- IContactManagerInterop.ShowContactCardForWindow
Se aplica a
ShowContactCard(Contact, Rect, Placement, ContactCardOptions)
Muestra una tarjeta de contacto con los parámetros especificados.
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)Parámetros
- contact
- Contact
Objeto que representa el contacto para el que la aplicación quiere mostrar la tarjeta de contacto. contact debe contener al menos un identificador, correos electrónicos o un número de teléfono de una lista de teléfonos para consultar la base de datos de contactos del usuario para recuperar un contacto coincidente para mostrarlo. El identificador tiene una prioridad más alta para la consulta. Si un identificador coincide, el resto de parámetros de consulta se omitirá con fines coincidentes. Si un identificador no encuentra una coincidencia, la consulta usa el resto de parámetros de consulta. Los correos electrónicos y teléfonos tienen la misma prioridad para buscar coincidencias. Si se proporcionan varias direcciones de correo electrónico, números de teléfono o ambos, la consulta realiza primero una coincidencia exacta, lo que requiere que todos los parámetros de consulta coincidan con un registro de contacto del sistema. Si esto no da lugar a coincidencias, la consulta usa la coincidencia "mejor esfuerzo", en la que basta con una coincidencia de cualquier parámetro de consulta.
Si no se producen coincidencias, los datos del contacto de entrada se muestran en la tarjeta de contacto. Si se produce una coincidencia, solo se muestran los datos de contacto del sistema y se descartan los datos del contacto de entrada.
- selection
- Rect
El rect es el área rectangular de la selección del usuario (por ejemplo, presionar un botón), alrededor del cual el sistema operativo muestra la tarjeta de contacto, no dentro de ese área rectangular. Por ejemplo, si una aplicación usa un botón para mostrar la tarjeta de contacto, pase la corrección del botón para que la tarjeta de contacto se muestre alrededor del botón, no superpuesta.
- preferredPlacement
- Placement
Ubicación que describe la ubicación preferida de la tarjeta de contacto.
- contactCardOptions
- ContactCardOptions
Especifica cómo mostrar la tarjeta de contacto, como la pestaña en la que se va a iniciar al mostrar una tarjeta de contacto mini.
- Atributos
Requisitos de Windows
| Características de aplicaciones |
contactsSystem
|
Comentarios
Consulte la sección de comentarios de esta sobrecarga: ShowContactCard.