ContactManager.ShowContactCard 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| ShowContactCard(Contact, Rect) |
운영 체제에서 사용자의 연락처를 쿼리하고 연락처 카드 연락처 데이터를 표시합니다. |
| ShowContactCard(Contact, Rect, Placement) |
운영 체제에서 사용자의 연락처를 쿼리하고 연락처 카드 연락처 데이터를 표시합니다. |
| ShowContactCard(Contact, Rect, Placement, ContactCardOptions) |
지정된 매개 변수가 있는 연락처 카드 표시합니다. |
ShowContactCard(Contact, Rect)
운영 체제에서 사용자의 연락처를 쿼리하고 연락처 카드 연락처 데이터를 표시합니다.
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)매개 변수
- contact
- Contact
앱에서 연락처 카드 표시하려는 연락처를 나타내는 개체입니다.연락처는 사용자의 연락처 데이터베이스를 쿼리하여 표시할 연락처를 검색하려면 전화 목록의 ID, 전자 메일 또는 전화 번호 이상을 포함해야 합니다. ID 는 쿼리 우선 순위가 높습니다. ID가 일치하면 일치하는 목적으로 나머지 쿼리 매개 변수가 무시됩니다. ID가 일치하는 항목을 찾지 못하면 쿼리는 나머지 쿼리 매개 변수를 사용합니다. 전자 메일과전화 는 일치에 대해 동일한 우선 순위를 갖습니다. 여러 전자 메일 주소 또는 전화 번호 또는 둘 다 제공된 경우 쿼리는 먼저 정확한 일치를 수행하여 모든 쿼리 매개 변수가 시스템 연락처 레코드와 일치하도록 요구합니다. 이렇게 하면 일치하는 항목이 없으면 쿼리는 쿼리 매개 변수의 일치가 충분한 "최선의 노력" 일치를 사용합니다.
일치하는 항목이 없으면 입력 연락처의 데이터가 연락처 카드 표시됩니다. 일치가 발생하면 시스템 연락처 데이터만 표시되고 입력 연락처의 데이터는 삭제됩니다.
- selection
- Rect
Rect는 사용자 선택 영역(예: 단추 누르기)의 사각형 영역으로, 운영 체제에서 해당 사각형 영역이 아닌 카드 연락처를 표시합니다. 예를 들어 앱이 단추를 사용하여 연락처 카드 표시하는 경우 단추의 Rect를 전달하여 겹치지 않고 단추 주위에 연락처 카드 표시됩니다.
- 특성
Windows 요구 사항
| 앱 기능 |
contactsSystem
|
설명
참고
이 메서드를 호출하려면 원본 앱이 포그라운드에서 실행 중이어야 합니다. 백그라운드에서 실행되는 앱은 이 메서드를 호출하는 경우 "액세스 거부됨" 예외가 발생합니다.
대부분의 일반적인 작업으로 인해 UI가 표시됩니다.
- 요청된 연락처와 정확히 일치하는 항목이 하나 있는 경우: 운영 체제의 연락처 저장소 정보가 포함된 연락처 카드 UI를 표시합니다.
- 여러 일치 항목이 있는 경우: 찾은 첫 번째 일치하는 연락처의 연락처 카드 UI를 표시합니다.
- 일치하는 항목이 없는 경우: 연락처 정보가 입력 연락처 개체에서 제공되는 연락처 카드 UI를 표시합니다.
연락처 매개 변수에 대한 잘못된 입력과 같은 오류가 있으면 UI가 표시되지 않습니다.
쿼리를 위해 전화 번호는 문자 0-9 및 a-z/A-Z를 지원합니다. 다른 문자를 전화 번호에 넣으면 연락처를 쿼리할 때 무시됩니다.
연락처를 관리하는 방법에 대한 자세한 내용은 연락처 및 일정을 참조하세요.
쿼리를 위해 전화 번호는 문자 0-9 및 a-z/A-Z를 지원합니다. 다른 문자를 전화 번호에 넣으면 연락처를 쿼리할 때 무시됩니다.
추가 정보
적용 대상
ShowContactCard(Contact, Rect, Placement)
운영 체제에서 사용자의 연락처를 쿼리하고 연락처 카드 연락처 데이터를 표시합니다.
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)매개 변수
- contact
- Contact
앱에서 연락처 카드 표시하려는 연락처를 나타내는 개체입니다.연락처는 사용자의 연락처 데이터베이스를 쿼리하여 표시할 연락처를 검색하려면 전화 목록의 ID, 전자 메일 또는 전화 번호 이상을 포함해야 합니다. ID 는 쿼리 우선 순위가 높습니다. ID가 일치하면 일치하는 목적으로 나머지 쿼리 매개 변수가 무시됩니다. ID가 일치하는 항목을 찾지 못하면 쿼리는 나머지 쿼리 매개 변수를 사용합니다. 전자 메일과전화 는 일치에 대해 동일한 우선 순위를 갖습니다. 여러 전자 메일 주소 또는 전화 번호 또는 둘 다 제공된 경우 쿼리는 먼저 정확한 일치를 수행하여 모든 쿼리 매개 변수가 시스템 연락처 레코드와 일치하도록 요구합니다. 이렇게 하면 일치하는 항목이 없으면 쿼리는 쿼리 매개 변수의 일치가 충분한 "최선의 노력" 일치를 사용합니다.
일치하는 항목이 없으면 입력 연락처의 데이터가 연락처 카드 표시됩니다. 일치가 발생하면 시스템 연락처 데이터만 표시되고 입력 연락처의 데이터는 삭제됩니다.
- selection
- Rect
Rect는 사용자 선택 영역(예: 단추 누르기)의 사각형 영역으로, 운영 체제에서 해당 사각형 영역이 아닌 카드 연락처를 표시합니다. 예를 들어 앱이 단추를 사용하여 연락처 카드 표시하는 경우 단추의 Rect를 전달하여 겹치지 않고 단추 주위에 연락처 카드 표시됩니다.
- 특성
Windows 요구 사항
| 앱 기능 |
contactsSystem
|
설명
이 오버로드의 설명 섹션 인 ShowContactCard를 참조하세요.
추가 정보
적용 대상
ShowContactCard(Contact, Rect, Placement, ContactCardOptions)
지정된 매개 변수가 있는 연락처 카드 표시합니다.
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)매개 변수
- contact
- Contact
앱에서 연락처 카드 표시하려는 연락처를 나타내는 개체입니다.연락처는 사용자의 연락처 데이터베이스를 쿼리하여 표시할 연락처를 검색하려면 전화 목록의 ID, 전자 메일 또는 전화 번호 이상을 포함해야 합니다. ID 는 쿼리 우선 순위가 높습니다. ID가 일치하면 일치하는 목적으로 나머지 쿼리 매개 변수가 무시됩니다. ID가 일치하는 항목을 찾지 못하면 쿼리는 나머지 쿼리 매개 변수를 사용합니다. 전자 메일과전화 는 일치에 대해 동일한 우선 순위를 갖습니다. 여러 전자 메일 주소 또는 전화 번호 또는 둘 다 제공된 경우 쿼리는 먼저 정확한 일치를 수행하여 모든 쿼리 매개 변수가 시스템 연락처 레코드와 일치하도록 요구합니다. 이렇게 하면 일치하는 항목이 없으면 쿼리는 쿼리 매개 변수의 일치가 충분한 "최선의 노력" 일치를 사용합니다.
일치하는 항목이 없으면 입력 연락처의 데이터가 연락처 카드 표시됩니다. 일치가 발생하면 시스템 연락처 데이터만 표시되고 입력 연락처의 데이터는 삭제됩니다.
- selection
- Rect
Rect는 사용자 선택 영역(예: 단추 누르기)의 사각형 영역으로, 운영 체제에서 해당 사각형 영역이 아닌 카드 연락처를 표시합니다. 예를 들어 앱이 단추를 사용하여 연락처 카드 표시하는 경우 단추의 Rect를 전달하여 겹치지 않고 단추 주위에 연락처 카드 표시됩니다.
- contactCardOptions
- ContactCardOptions
미니 연락처 카드 표시할 때 시작할 탭과 같이 연락처 카드 표시하는 방법을 지정합니다.
- 특성
Windows 요구 사항
| 앱 기능 |
contactsSystem
|
설명
이 오버로드의 설명 섹션 인 ShowContactCard를 참조하세요.