다음을 통해 공유

IContactManagerInterop::ShowContactCardForWindow 메서드(shobjidl_core.h)

  • 아티클

지정된 창에 연락처의 UI를 표시합니다.

구문

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

매개 변수

[in] appWindow

형식: HWND

연락처 카드 시작되고 연락처 카드 해제될 때 포커스가 반환되는 앱의 포그라운드 창의 HWND입니다.

[in] contact

형식: IUnknown*

연락처 개체에 대한 포인터입니다. 클래식 COM IDL은 Windows 런타임 형식을 사용할 수 없으므로 Windows.ApplicationModel.Contacts.Contact 개체를 사용하지만 여기서는 IUnknown으로 캐스팅됩니다.

[in] selection

형식: RECT const*

사각형은 사용자 선택 영역(예: 단추 누르기)의 사각형 영역으로, 운영 체제에서 해당 사각형 영역이 아닌 연락처 카드 표시합니다. 예를 들어 앱에서 단추를 사용하여 연락처 카드 표시하는 경우 단추의 Rect를 전달하여 겹치지 않고 단추 주위에 연락처 카드 표시되도록 합니다.

[in] preferredPlacement

형식: FLYOUT_PLACEMENT

연락처 카드 기본 배치를 설명하는 FLYOUT_PLACEMENT 형식의 값입니다.

값 의미
FP_DEFAULT
0
 기본값을 사용하세요.
FP_ABOVE
1
 선택 매개 변수로 지정된 사용자 선택의 사각형 영역 위에 연락처 카드 배치하는 것이 좋습니다.
FP_BELOW
2
 선택 매개 변수로 지정된 사용자 선택의 사각형 영역 아래에 연락처 카드 배치하는 것이 좋습니다.
FP_LEFT
3
 선택 매개 변수로 지정된 사용자 선택 영역의 사각형 영역 왼쪽에 연락처 카드 배치하는 것이 좋습니다.
FP_RIGHT
4
 선택 매개 변수로 지정된 사용자 선택의 사각형 영역 오른쪽에 연락처 카드 배치하는 것이 좋습니다.

반환 값

형식: HRESULT

ShowContactCardForWindow는 다음을 반환합니다.

  • 연락처 카드 성공적으로 표시되는지 S_OK
  • appWindow가 NULL이거나 연락처가 NULL이거나 선택 항목이 NULL인 경우 E_POINTER
  • E_INVALIDARG 연락처 가 Windows.ApplicationModel.Contacts.Contact 개체가 아니거나 preferredPlacement 가 잘못된 열거형 값인 경우
다른 HRESULT 값이 가능합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8.1 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 shobjidl_core.h

추가 정보

IContactManagerInterop

ShowContactCardForWindow