ContactManager.ShowDelayLoadedContactCard Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
| ShowDelayLoadedContactCard(Contact, Rect, Placement) |
Shows a contact card that can be updated later if the contact does not exist in the user’s contact database. |
| ShowDelayLoadedContactCard(Contact, Rect, Placement, ContactCardOptions) |
Shows a contact card that can be updated later if the contact does not exist in the user’s contact database. |
Shows a contact card that can be updated later if the contact does not exist in the user’s contact database.
public:
static ContactCardDelayedDataLoader ^ ShowDelayLoadedContactCard(Contact ^ contact, Rect selection, Placement preferredPlacement);/// [Windows.Foundation.Metadata.Overload("ShowDelayLoadedContactCard")]
static ContactCardDelayedDataLoader ShowDelayLoadedContactCard(Contact const& contact, Rect const& selection, Placement const& preferredPlacement);[Windows.Foundation.Metadata.Overload("ShowDelayLoadedContactCard")]
public static ContactCardDelayedDataLoader ShowDelayLoadedContactCard(Contact contact, Rect selection, Placement preferredPlacement);function showDelayLoadedContactCard(contact, selection, preferredPlacement)Public Shared Function ShowDelayLoadedContactCard (contact As Contact, selection As Rect, preferredPlacement As Placement) As ContactCardDelayedDataLoaderParameters
- contact
- Contact
The object that represents the contact that the app wants to display the contact card for.contact must contain at least an Id, Emails, or a phone number from a Phones list to query the user’s contact database to retrieve a matching contact to display. Id has higher priority for querying. If an Id matches, the rest of query parameters will be ignored for matching purposes. If an Id does not find a match, the query uses the rest of query parameters. Emails and Phones have equal priority for matching. If multiple email addresses, or phone numbers, or both are provided, the query first performs an exact match, requiring all query parameters to match a system contact record. If this results in no matches, the query uses "best effort" match, in which a match of any query parameters is sufficient.
If no matches occur, the data in the input contact displays in the contact card. If a match occurs, only system contact data displays, and the data in the input contact is discarded.
- selection
- Rect
The Rect is the rectangular area of user selection (for example, pressing a button), around which the operating system displays the contact card, not within that rectangular area. For example, if an app uses a button to show the contact card, pass the Rect of the button so the contact card displays around the button, not overlapping it.
- preferredPlacement
- Placement
The Placement that describes the preferred placement of the contact card.
Returns
Returns the ContactCardDelayedDataLoader object that can be used to update the contact card.
- Attributes
Windows requirements
| App capabilities |
contactsSystem
|
See also
Applies to
WinRT Build 26100 and other versions
| Product | Versions |
|---|---|
| WinRT | Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100 |
Shows a contact card that can be updated later if the contact does not exist in the user’s contact database.
public:
static ContactCardDelayedDataLoader ^ ShowDelayLoadedContactCard(Contact ^ contact, Rect selection, Placement preferredPlacement, ContactCardOptions ^ contactCardOptions);/// [Windows.Foundation.Metadata.Overload("ShowDelayLoadedContactCardWithOptions")]
static ContactCardDelayedDataLoader ShowDelayLoadedContactCard(Contact const& contact, Rect const& selection, Placement const& preferredPlacement, ContactCardOptions const& contactCardOptions);[Windows.Foundation.Metadata.Overload("ShowDelayLoadedContactCardWithOptions")]
public static ContactCardDelayedDataLoader ShowDelayLoadedContactCard(Contact contact, Rect selection, Placement preferredPlacement, ContactCardOptions contactCardOptions);function showDelayLoadedContactCard(contact, selection, preferredPlacement, contactCardOptions)Public Shared Function ShowDelayLoadedContactCard (contact As Contact, selection As Rect, preferredPlacement As Placement, contactCardOptions As ContactCardOptions) As ContactCardDelayedDataLoaderParameters
- contact
- Contact
The object that represents the contact that the app wants to display the contact card for.contact must contain at least an Id, Emails, or a phone number from a Phones list to query the user’s contact database to retrieve a matching contact to display. Id has higher priority for querying. If an Id matches, the rest of query parameters will be ignored for matching purposes. If an Id does not find a match, the query uses the rest of query parameters. Emails and Phones have equal priority for matching. If multiple email addresses, or phone numbers, or both are provided, the query first performs an exact match, requiring all query parameters to match a system contact record. If this results in no matches, the query uses "best effort" match, in which a match of any query parameters is sufficient.
If no matches occur, the data in the input contact displays in the contact card. If a match occurs, only system contact data displays, and the data in the input contact is discarded.
- selection
- Rect
The Rect is the rectangular area of user selection (for example, pressing a button), around which the operating system displays the contact card, not within that rectangular area. For example, if an app uses a button to show the contact card, pass the Rect of the button so the contact card displays around the button, not overlapping it.
- preferredPlacement
- Placement
The Placement that describes the preferred placement of the contact card.
- contactCardOptions
- ContactCardOptions
Specifies how to display the contact card, such as which tab to start on if you are displaying a mini contact card, or what header type to use if you are showing a full contact card.
Returns
Returns the ContactCardDelayedDataLoader object that can be used to update the contact card.
- Attributes
Windows requirements
| App capabilities |
contactsSystem
|
See also
Applies to
WinRT Build 26100 and other versions
| Product | Versions |
|---|---|
| WinRT | Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100 |