Freigeben über


ContactManager.ShowContactCard Methode

Definition

Überlädt

ShowContactCard(Contact, Rect)

Fragt das Betriebssystem nach dem Kontakt eines Benutzers ab und zeigt die Kontaktdaten in einem Kontakt Karte an.

ShowContactCard(Contact, Rect, Placement)

Fragt das Betriebssystem nach dem Kontakt eines Benutzers ab und zeigt die Kontaktdaten in einem Kontakt Karte an.

ShowContactCard(Contact, Rect, Placement, ContactCardOptions)

Zeigt einen Kontakt Karte mit den angegebenen Parametern an.

ShowContactCard(Contact, Rect)

Fragt das Betriebssystem nach dem Kontakt eines Benutzers ab und zeigt die Kontaktdaten in einem Kontakt Karte an.

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)

Parameter

contact
Contact

Das -Objekt, das den Kontakt darstellt, für den die App den Kontakt Karte.Der Kontakt muss mindestens eine ID, E-Mails oder eine Telefonnummer aus einer Telefonliste enthalten, um die Kontaktdatenbank des Benutzers abzufragen, um einen übereinstimmenden Kontakt abzurufen, der angezeigt werden soll. Die ID hat eine höhere Priorität für Abfragen. Wenn eine ID übereinstimmt, werden die restlichen Abfrageparameter zu Abgleichszwecken ignoriert. Wenn eine ID keine Übereinstimmung findet, verwendet die Abfrage die restlichen Abfrageparameter. E-Mails und Telefone haben die gleiche Priorität für den Abgleich. Wenn mehrere E-Mail-Adressen, Telefonnummern oder beides angegeben werden, führt die Abfrage zunächst eine genaue Übereinstimmung durch, sodass alle Abfrageparameter mit einem Systemkontaktdatensatz übereinstimmen müssen. Wenn dies keine Übereinstimmungen zur Folge hat, verwendet die Abfrage eine Übereinstimmung mit "best effort", bei der eine Übereinstimmung aller Abfrageparameter ausreichend ist.

Wenn keine Übereinstimmungen auftreten, werden die Daten im Eingabekontakt im Kontakt Karte angezeigt. Wenn eine Übereinstimmung auftritt, werden nur Systemkontaktdaten angezeigt, und die Daten im Eingabekontakt werden verworfen.

selection
Rect

Das Rect ist der rechteckige Bereich der Benutzerauswahl (z. B. drücken einer Schaltfläche), um den das Betriebssystem den Kontakt Karte anzeigt, nicht innerhalb dieses rechteckigen Bereichs. Wenn eine App beispielsweise eine Schaltfläche verwendet, um den Kontakt Karte anzuzeigen, übergeben Sie das Rect der Schaltfläche, damit der Kontakt Karte um die Schaltfläche herum angezeigt wird, ohne sie zu überlappen.

Attribute

Windows-Anforderungen

App-Funktionen
contactsSystem

Hinweise

Hinweis

Quell-Apps müssen im Vordergrund ausgeführt werden, um diese Methode aufrufen zu können. Eine App, die im Hintergrund ausgeführt wird, erhält die Ausnahme "Zugriff verweigert", wenn sie diese Methode aufruft.

Die meisten typischen Vorgänge führen dazu, dass eine Benutzeroberfläche angezeigt wird.

  • Wenn eine genaue Übereinstimmung für den angeforderten Kontakt vorhanden ist: Zeigt die Benutzeroberfläche des Kontakts Karte mit Informationen aus dem Kontaktspeicher im Betriebssystem an.
  • Wenn mehrere Übereinstimmungen vorhanden sind: Zeigt die Benutzeroberfläche des Kontakts Karte für den ersten übereinstimmenden Kontakt an.
  • Wenn keine Übereinstimmung vorhanden ist: Zeigt die Benutzeroberfläche des Kontakts Karte, in der die Kontaktinformationen aus dem Eingabekontaktobjekt stammen.

Wenn ein Fehler auftritt, z. B. eine ungültige Eingabe für den Kontaktparameter , wird keine Benutzeroberfläche angezeigt.

Zu Abfragezwecken unterstützen Telefonnummern die Zeichen 0-9 und a-z/A-Z. Wenn Sie andere Zeichen in eine Telefonnummer einfügen, werden diese ignoriert, wenn Sie den Kontakt abfragen.

Informationen zum Verwalten von Kontakten finden Sie unter Kontakte und Kalender.

Zu Abfragezwecken unterstützen Telefonnummern die Zeichen 0-9 und a-z/A-Z. Wenn Sie andere Zeichen in eine Telefonnummer einfügen, werden diese ignoriert, wenn Sie den Kontakt abfragen.

Weitere Informationen

Gilt für:

ShowContactCard(Contact, Rect, Placement)

Fragt das Betriebssystem nach dem Kontakt eines Benutzers ab und zeigt die Kontaktdaten in einem Kontakt Karte an.

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)

Parameter

contact
Contact

Das -Objekt, das den Kontakt darstellt, für den die App den Kontakt Karte.Der Kontakt muss mindestens eine ID, E-Mails oder eine Telefonnummer aus einer Telefonliste enthalten, um die Kontaktdatenbank des Benutzers abzufragen, um einen übereinstimmenden Kontakt abzurufen, der angezeigt werden soll. Die ID hat eine höhere Priorität für Abfragen. Wenn eine ID übereinstimmt, werden die restlichen Abfrageparameter zu Abgleichszwecken ignoriert. Wenn eine ID keine Übereinstimmung findet, verwendet die Abfrage die restlichen Abfrageparameter. E-Mails und Telefone haben die gleiche Priorität für den Abgleich. Wenn mehrere E-Mail-Adressen, Telefonnummern oder beides angegeben werden, führt die Abfrage zunächst eine genaue Übereinstimmung durch, sodass alle Abfrageparameter mit einem Systemkontaktdatensatz übereinstimmen müssen. Wenn dies keine Übereinstimmungen zur Folge hat, verwendet die Abfrage eine Übereinstimmung mit "best effort", bei der eine Übereinstimmung aller Abfrageparameter ausreichend ist.

Wenn keine Übereinstimmungen auftreten, werden die Daten im Eingabekontakt im Kontakt Karte angezeigt. Wenn eine Übereinstimmung auftritt, werden nur Systemkontaktdaten angezeigt, und die Daten im Eingabekontakt werden verworfen.

selection
Rect

Das Rect ist der rechteckige Bereich der Benutzerauswahl (z. B. drücken einer Schaltfläche), um den das Betriebssystem den Kontakt Karte anzeigt, nicht innerhalb dieses rechteckigen Bereichs. Wenn eine App beispielsweise eine Schaltfläche verwendet, um den Kontakt Karte anzuzeigen, übergeben Sie das Rect der Schaltfläche, damit der Kontakt Karte um die Schaltfläche herum angezeigt wird, ohne sie zu überlappen.

preferredPlacement
Placement

Die Platzierung, die die bevorzugte Platzierung des Kontakts Karte beschreibt.

Attribute

Windows-Anforderungen

App-Funktionen
contactsSystem

Hinweise

Weitere Informationen finden Sie im Abschnitt "Hinweise" dieser Überladung: ShowContactCard.

Weitere Informationen

Gilt für:

ShowContactCard(Contact, Rect, Placement, ContactCardOptions)

Zeigt einen Kontakt Karte mit den angegebenen Parametern an.

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)

Parameter

contact
Contact

Das -Objekt, das den Kontakt darstellt, für den die App den Kontakt Karte.Der Kontakt muss mindestens eine ID, E-Mails oder eine Telefonnummer aus einer Telefonliste enthalten, um die Kontaktdatenbank des Benutzers abzufragen, um einen übereinstimmenden Kontakt abzurufen, der angezeigt werden soll. Die ID hat eine höhere Priorität für Abfragen. Wenn eine ID übereinstimmt, werden die restlichen Abfrageparameter zu Abgleichszwecken ignoriert. Wenn eine ID keine Übereinstimmung findet, verwendet die Abfrage die restlichen Abfrageparameter. E-Mails und Telefone haben die gleiche Priorität für den Abgleich. Wenn mehrere E-Mail-Adressen, Telefonnummern oder beides angegeben werden, führt die Abfrage zunächst eine genaue Übereinstimmung durch, sodass alle Abfrageparameter mit einem Systemkontaktdatensatz übereinstimmen müssen. Wenn dies keine Übereinstimmungen zur Folge hat, verwendet die Abfrage eine Übereinstimmung mit "best effort", bei der eine Übereinstimmung aller Abfrageparameter ausreichend ist.

Wenn keine Übereinstimmungen auftreten, werden die Daten im Eingabekontakt im Kontakt Karte angezeigt. Wenn eine Übereinstimmung auftritt, werden nur Systemkontaktdaten angezeigt, und die Daten im Eingabekontakt werden verworfen.

selection
Rect

Das Rect ist der rechteckige Bereich der Benutzerauswahl (z. B. drücken einer Schaltfläche), um den das Betriebssystem den Kontakt Karte anzeigt, nicht innerhalb dieses rechteckigen Bereichs. Wenn eine App beispielsweise eine Schaltfläche verwendet, um den Kontakt Karte anzuzeigen, übergeben Sie das Rect der Schaltfläche, damit der Kontakt Karte um die Schaltfläche herum angezeigt wird, ohne sie zu überlappen.

preferredPlacement
Placement

Die Platzierung, die die bevorzugte Platzierung des Kontakts Karte beschreibt.

contactCardOptions
ContactCardOptions

Gibt an, wie der Kontakt Karte angezeigt wird, z. B. welche Registerkarte beim Anzeigen eines Minikontakts Karte gestartet werden soll.

Attribute

Windows-Anforderungen

App-Funktionen
contactsSystem

Hinweise

Weitere Informationen finden Sie im Abschnitt "Hinweise" dieser Überladung: ShowContactCard.

Weitere Informationen

Gilt für: