ContactManager.ShowContactCard Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| ShowContactCard(Contact, Rect) |
Consulta o sistema operacional para o contato de um usuário e mostra os dados de contato em um contato cartão. |
| ShowContactCard(Contact, Rect, Placement) |
Consulta o sistema operacional para o contato de um usuário e mostra os dados de contato em um contato cartão. |
| ShowContactCard(Contact, Rect, Placement, ContactCardOptions) |
Mostra um cartão de contato com os parâmetros especificados. |
ShowContactCard(Contact, Rect)
Consulta o sistema operacional para o contato de um usuário e mostra os dados de contato em um contato cartão.
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
O objeto que representa o contato para o qual o aplicativo deseja exibir a cartão de contato.O contato deve conter pelo menos uma ID, emails ou um número de telefone de uma lista Telefones para consultar o banco de dados de contatos do usuário para recuperar um contato correspondente a ser exibido. A ID tem prioridade mais alta para consulta. Se uma ID corresponder, o restante dos parâmetros de consulta será ignorado para fins de correspondência. Se uma ID não encontrar uma correspondência, a consulta usará o restante dos parâmetros de consulta. Emails e Telefones têm prioridade igual para correspondência. Se vários endereços de email, números de telefone ou ambos forem fornecidos, a consulta primeiro executará uma correspondência exata, exigindo que todos os parâmetros de consulta correspondam a um registro de contato do sistema. Se isso não resultar em correspondências, a consulta usará a correspondência de "melhor esforço", na qual uma correspondência de qualquer parâmetro de consulta é suficiente.
Se nenhuma correspondência ocorrer, os dados no contato de entrada serão exibidos na cartão de contato. Se ocorrer uma correspondência, somente os dados de contato do sistema serão exibidos e os dados no contato de entrada serão descartados.
- selection
- Rect
O Rect é a área retangular da seleção do usuário (por exemplo, pressionando um botão), em torno da qual o sistema operacional exibe o contato cartão, não dentro dessa área retangular. Por exemplo, se um aplicativo usar um botão para mostrar a cartão de contato, passe o Rect do botão para que o contato cartão seja exibido ao redor do botão, não sobrepondo-o.
- Atributos
Requisitos do Windows
| Funcionalidades do aplicativo |
contactsSystem
|
Comentários
Observação
Os aplicativos de origem devem estar em execução em primeiro plano para chamar esse método. Um aplicativo executado em segundo plano receberá uma exceção "Acesso Negado" se chamar esse método.
A maioria das operações típicas resultará na exibição de uma interface do usuário.
- Se houver uma correspondência exata para o contato solicitado: Mostra o contato cartão interface do usuário com informações do repositório de contatos no sistema operacional.
- Se houver várias correspondências: Mostra o contato cartão interface do usuário para o primeiro contato correspondente encontrado.
- Se não houver correspondência: Mostra o contato cartão interface do usuário, em que as informações de contato vêm do objeto de contato de entrada.
Se houver um erro, como uma entrada inválida para o parâmetro de contato , nenhuma interface do usuário será exibida.
Para fins de consulta, os números de telefone dão suporte aos caracteres 0-9 e a-z/A-Z. Se você colocar outros caracteres em um número de telefone, eles serão ignorados quando você consultar o contato.
Para obter informações sobre como gerenciar contatos, consulte Contatos e calendário.
Para fins de consulta, os números de telefone dão suporte aos caracteres 0-9 e a-z/A-Z. Se você colocar outros caracteres em um número de telefone, eles serão ignorados quando você consultar o contato.
Confira também
Aplica-se a
ShowContactCard(Contact, Rect, Placement)
Consulta o sistema operacional para o contato de um usuário e mostra os dados de contato em um contato cartão.
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
O objeto que representa o contato para o qual o aplicativo deseja exibir a cartão de contato.O contato deve conter pelo menos uma ID, emails ou um número de telefone de uma lista Telefones para consultar o banco de dados de contatos do usuário para recuperar um contato correspondente a ser exibido. A ID tem prioridade mais alta para consulta. Se uma ID corresponder, o restante dos parâmetros de consulta será ignorado para fins de correspondência. Se uma ID não encontrar uma correspondência, a consulta usará o restante dos parâmetros de consulta. Emails e Telefones têm prioridade igual para correspondência. Se vários endereços de email, números de telefone ou ambos forem fornecidos, a consulta primeiro executará uma correspondência exata, exigindo que todos os parâmetros de consulta correspondam a um registro de contato do sistema. Se isso não resultar em correspondências, a consulta usará a correspondência de "melhor esforço", na qual uma correspondência de qualquer parâmetro de consulta é suficiente.
Se nenhuma correspondência ocorrer, os dados no contato de entrada serão exibidos na cartão de contato. Se ocorrer uma correspondência, somente os dados de contato do sistema serão exibidos e os dados no contato de entrada serão descartados.
- selection
- Rect
O Rect é a área retangular da seleção do usuário (por exemplo, pressionando um botão), em torno da qual o sistema operacional exibe o contato cartão, não dentro dessa área retangular. Por exemplo, se um aplicativo usar um botão para mostrar a cartão de contato, passe o Rect do botão para que o contato cartão seja exibido ao redor do botão, não sobrepondo-o.
- preferredPlacement
- Placement
O Posicionamento que descreve o posicionamento preferencial do cartão de contato.
- Atributos
Requisitos do Windows
| Funcionalidades do aplicativo |
contactsSystem
|
Comentários
Consulte a seção de comentários desta sobrecarga: ShowContactCard.
Confira também
- ShowContactCard(Contact, Rect)
- Amostra da API do Gerenciador de Contatos
- IContactManagerInterop.ShowContactCardForWindow
Aplica-se a
ShowContactCard(Contact, Rect, Placement, ContactCardOptions)
Mostra um cartão de contato com os 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
O objeto que representa o contato para o qual o aplicativo deseja exibir a cartão de contato.O contato deve conter pelo menos uma ID, emails ou um número de telefone de uma lista Telefones para consultar o banco de dados de contatos do usuário para recuperar um contato correspondente a ser exibido. A ID tem prioridade mais alta para consulta. Se uma ID corresponder, o restante dos parâmetros de consulta será ignorado para fins de correspondência. Se uma ID não encontrar uma correspondência, a consulta usará o restante dos parâmetros de consulta. Emails e Telefones têm prioridade igual para correspondência. Se vários endereços de email, números de telefone ou ambos forem fornecidos, a consulta primeiro executará uma correspondência exata, exigindo que todos os parâmetros de consulta correspondam a um registro de contato do sistema. Se isso não resultar em correspondências, a consulta usará a correspondência de "melhor esforço", na qual uma correspondência de qualquer parâmetro de consulta é suficiente.
Se nenhuma correspondência ocorrer, os dados no contato de entrada serão exibidos na cartão de contato. Se ocorrer uma correspondência, somente os dados de contato do sistema serão exibidos e os dados no contato de entrada serão descartados.
- selection
- Rect
O Rect é a área retangular da seleção do usuário (por exemplo, pressionando um botão), em torno da qual o sistema operacional exibe o contato cartão, não dentro dessa área retangular. Por exemplo, se um aplicativo usar um botão para mostrar a cartão de contato, passe o Rect do botão para que o contato cartão seja exibido ao redor do botão, não sobrepondo-o.
- preferredPlacement
- Placement
O Posicionamento que descreve o posicionamento preferencial do cartão de contato.
- contactCardOptions
- ContactCardOptions
Especifica como exibir a cartão de contato, como em qual guia iniciar ao exibir um mini contato cartão.
- Atributos
Requisitos do Windows
| Funcionalidades do aplicativo |
contactsSystem
|
Comentários
Consulte a seção de comentários desta sobrecarga: ShowContactCard.