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
앱에서 연락처 카드를 표시하려는 연락처를 나타내는 개체입니다. 연락처 는 사용자의 연락처 데이터베이스를 IdEmails쿼리하여 표시할 일치하는 연락처를 Phones 검색하려면 목록에서 적어도 하나 이상의 전화 번호를 포함해야 합니다. Id 에는 쿼리 우선 순위가 더 높습니다. Id 일치하는 경우 일치 목적으로 나머지 쿼리 매개 변수는 무시됩니다. Id 일치하는 항목을 찾을 수 없는 경우 쿼리는 나머지 쿼리 매개 변수를 사용합니다. Emails 일치 Phones 에 대해 동일한 우선 순위를 갖습니다. 여러 전자 메일 주소 또는 전화 번호 또는 둘 다 제공된 경우 쿼리는 먼저 정확한 일치를 수행하여 모든 쿼리 매개 변수가 시스템 연락처 레코드와 일치하도록 요구합니다. 일치 항목이 없으면 쿼리는 쿼리 매개 변수의 일치가 충분한 "최상의 노력" 일치를 사용합니다.
일치하는 항목이 없으면 입력 연락처의 데이터가 대화 상대 카드에 표시됩니다. 일치가 발생하면 시스템 연락처 데이터만 표시되고 입력 연락처의 데이터는 삭제됩니다.
- 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
앱에서 연락처 카드를 표시하려는 연락처를 나타내는 개체입니다. 연락처 는 사용자의 연락처 데이터베이스를 IdEmails쿼리하여 표시할 일치하는 연락처를 Phones 검색하려면 목록에서 적어도 하나 이상의 전화 번호를 포함해야 합니다. Id 에는 쿼리 우선 순위가 더 높습니다. Id 일치하는 경우 일치 목적으로 나머지 쿼리 매개 변수는 무시됩니다. Id 일치하는 항목을 찾을 수 없는 경우 쿼리는 나머지 쿼리 매개 변수를 사용합니다. Emails 일치 Phones 에 대해 동일한 우선 순위를 갖습니다. 여러 전자 메일 주소 또는 전화 번호 또는 둘 다 제공된 경우 쿼리는 먼저 정확한 일치를 수행하여 모든 쿼리 매개 변수가 시스템 연락처 레코드와 일치하도록 요구합니다. 일치 항목이 없으면 쿼리는 쿼리 매개 변수의 일치가 충분한 "최상의 노력" 일치를 사용합니다.
일치하는 항목이 없으면 입력 연락처의 데이터가 대화 상대 카드에 표시됩니다. 일치가 발생하면 시스템 연락처 데이터만 표시되고 입력 연락처의 데이터는 삭제됩니다.
- 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
앱에서 연락처 카드를 표시하려는 연락처를 나타내는 개체입니다. 연락처 는 사용자의 연락처 데이터베이스를 IdEmails쿼리하여 표시할 일치하는 연락처를 Phones 검색하려면 목록에서 적어도 하나 이상의 전화 번호를 포함해야 합니다. Id 에는 쿼리 우선 순위가 더 높습니다. Id 일치하는 경우 일치 목적으로 나머지 쿼리 매개 변수는 무시됩니다. Id 일치하는 항목을 찾을 수 없는 경우 쿼리는 나머지 쿼리 매개 변수를 사용합니다. Emails 일치 Phones 에 대해 동일한 우선 순위를 갖습니다. 여러 전자 메일 주소 또는 전화 번호 또는 둘 다 제공된 경우 쿼리는 먼저 정확한 일치를 수행하여 모든 쿼리 매개 변수가 시스템 연락처 레코드와 일치하도록 요구합니다. 이렇게 하면 일치하는 항목이 없으면 쿼리는 쿼리 매개 변수의 일치가 충분한 "최상의 노력" 일치를 사용합니다.
일치하는 항목이 없으면 입력 연락처의 데이터가 연락처 카드에 표시됩니다. 일치가 발생하면 시스템 연락처 데이터만 표시되고 입력 연락처의 데이터는 삭제됩니다.
- selection
- Rect
사용자 Rect 선택 영역(예: 단추 누르기)의 사각형 영역으로, 운영 체제에서 해당 사각형 영역이 아닌 연락처 카드를 표시합니다. 예를 들어 앱이 단추를 사용하여 대화 상대 카드를 표시하는 경우 단추를 전달 Rect 하여 대화 상대 카드가 겹치지 않고 단추 주위에 표시되도록 합니다.
- contactCardOptions
- ContactCardOptions
미니 대화 상대 카드를 표시할 때 시작할 탭과 같이 연락처 카드를 표시하는 방법을 지정합니다.
- 특성
Windows 요구 사항
| 앱 기능 |
contactsSystem
|
설명
이 오버로드 ShowContactCard의 설명 섹션을 참조하세요.
추가 정보
적용 대상
피드백
다음에 대한 사용자 의견 제출 및 보기