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

  • Artigo

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