Método IContactManagerInterop::ShowContactCardForWindow (shobjidl_core.h)

Artigo
08/26/2023

Exibe a interface do usuário de um contato na janela especificada.

Sintaxe

HRESULT ShowContactCardForWindow(
  [in] HWND             appWindow,
  [in] IUnknown         *contact,
  [in] const RECT       *selection,
  [in] FLYOUT_PLACEMENT preferredPlacement
);

Parâmetros

[in] appWindow

Digite: HWND

O HWND da janela em primeiro plano do aplicativo do qual o cartão de contato é iniciado e onde o foco é retornado quando o contato cartão é ignorado.

[in] contact

Tipo: IUnknown*

Um ponteiro para o objeto de contato. Use um objeto Windows.ApplicationModel.Contacts.Contact, mas converta para IUnknown aqui porque a IDL COM clássica não pode usar Windows Runtime tipos.

[in] selection

Tipo: RECT const*

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.

[in] preferredPlacement

Tipo: FLYOUT_PLACEMENT

Um valor de tipo FLYOUT_PLACEMENT que descreve o posicionamento preferencial do cartão de contato.

Valor	Significado
FP_DEFAULT 0	Use o padrão.
FP_ABOVE 1	Prefira colocar o contato cartão acima da área retangular da seleção de usuário especificada pelo parâmetro de seleção.
FP_BELOW 2	Prefira colocar o contato cartão abaixo da área retangular da seleção de usuário especificada pelo parâmetro de seleção.
FP_LEFT 3	Prefira colocar a cartão de contato à esquerda da área retangular da seleção de usuário especificada pelo parâmetro de seleção.
FP_RIGHT 4	Prefira colocar o contato cartão à direita da área retangular da seleção de usuário especificada pelo parâmetro de seleção.

Retornar valor

Tipo: HRESULT

ShowContactCardForWindow retorna:

S_OK se o cartão de contato for exibido com êxito
E_POINTER se appWindow for NULL ou o contato for NULL ou se a seleção for NULL
E_INVALIDARG se o contato não for um objeto Windows.ApplicationModel.Contacts.Contact ou preferredPlacement for um valor de enumeração inválido

Outros valores HRESULT são possíveis.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8.1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h

Confira também

IContactManagerInterop

ShowContactCardForWindow

Compartilhar via