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
|
注釈
Note
このメソッドを呼び出すには、ソース アプリがフォアグラウンドで実行されている必要があります。 バックグラウンドで実行されるアプリは、このメソッドを呼び出すと "アクセス拒否" 例外を受け取ります。
ほとんどの一般的な操作では、UI が表示されます。
- 要求された連絡先に完全に一致するものが 1 つある場合:オペレーティング システムの連絡先ストアからの情報を含む連絡先カード 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」の解説セクションを参照してください。