ContactManager.ShowContactCard メソッド

定義

名前空間:

Windows.ApplicationModel.Contacts

オーバーロード

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 を渡して、連絡先カードがボタンの周囲に表示されるようにします。

属性

OverloadAttribute

Windows の要件

アプリの機能

contactsSystem

注釈

Note

このメソッドを呼び出すには、ソース アプリがフォアグラウンドで実行されている必要があります。 バックグラウンドで実行されるアプリは、このメソッドを呼び出すと "アクセス拒否" 例外を受け取ります。

ほとんどの一般的な操作では、UI が表示されます。

• 要求された連絡先に完全に一致するものが 1 つある場合:オペレーティング システムの連絡先ストアからの情報を含む連絡先カード UI を表示します。
• 複数の一致がある場合:最初に見つかった一致する連絡先の連絡先カード UI を表示します。
• 一致するものがない場合:連絡先カード UI を表示します。ここで、連絡先情報は入力連絡先オブジェクトから取得されます。

連絡先パラメーターに無効な入力など、エラーが発生した場合、UI は表示されません。

クエリを行う目的で、電話番号は 0 から 9 の文字と a-z/A-Z をサポートします。 電話番号に他の文字を入力した場合、連絡先に対してクエリを実行すると、その文字は無視されます。

連絡先を管理する方法については、「 連絡先と予定表」を参照してください。

クエリを行う目的で、電話番号は 0 から 9 の文字と a-z/A-Z をサポートします。 電話番号に他の文字を入力した場合、連絡先に対してクエリを実行すると、その文字は無視されます。

こちらもご覧ください

• ShowContactCard(Contact, Rect, Placement)

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 を渡して、連絡先カードがボタンの周囲に表示されるようにします。

preferredPlacement

Placement

連絡先カードの推奨される配置を表す配置。

属性

OverloadAttribute

Windows の要件

アプリの機能

contactsSystem

注釈

このオーバーロードの「 ShowContactCard」の解説セクションを参照してください。

こちらもご覧ください

• ShowContactCard(Contact, Rect)
• 連絡先マネージャー API のサンプル
• IContactManagerInterop.ShowContactCardForWindow

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 を渡して、連絡先カードがボタンの周囲に表示されるようにします。

preferredPlacement

Placement

連絡先カードの推奨される配置を表す配置。

contactCardOptions

ContactCardOptions

ミニ連絡先カードを表示するときに開始するタブなど、連絡先カードを表示する方法を指定します。

属性

OverloadAttribute

Windows の要件

アプリの機能

contactsSystem

注釈

このオーバーロードの「 ShowContactCard」の解説セクションを参照してください。

こちらもご覧ください

• ShowContactCard(Contact, Rect)
• ShowContactCard(Contact, Rect, Placement)