ContactManager.ShowContactCard Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
| ShowContactCard(Contact, Rect) |
Mengkueri sistem operasi untuk kontak pengguna dan memperlihatkan data kontak dalam kartu kontak. |
| ShowContactCard(Contact, Rect, Placement) |
Mengkueri sistem operasi untuk kontak pengguna dan memperlihatkan data kontak dalam kartu kontak. |
| ShowContactCard(Contact, Rect, Placement, ContactCardOptions) |
Menampilkan kartu kontak dengan parameter yang ditentukan. |
ShowContactCard(Contact, Rect)
Mengkueri sistem operasi untuk kontak pengguna dan memperlihatkan data kontak dalam kartu kontak.
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
Objek yang mewakili kontak tempat aplikasi ingin menampilkan kartu kontak. kontak harus berisi setidaknya Id, Email, atau nomor telepon dari daftar Telepon untuk mengkueri database kontak pengguna untuk mengambil kontak yang cocok untuk ditampilkan. Id memiliki prioritas yang lebih tinggi untuk kueri. Jika Id cocok, parameter kueri lainnya akan diabaikan untuk tujuan pencocokan. Jika Id tidak menemukan kecocokan, kueri menggunakan parameter kueri lainnya. Email dan Telepon memiliki prioritas yang sama untuk pencocokan. Jika beberapa alamat email, atau nomor telepon, atau keduanya disediakan, kueri terlebih dahulu melakukan kecocokan yang tepat, mengharuskan semua parameter kueri untuk mencocokkan rekaman kontak sistem. Jika ini tidak menghasilkan kecocokan, kueri menggunakan kecocokan "upaya terbaik", di mana kecocokan parameter kueri apa pun sudah cukup.
Jika tidak ada kecocokan yang terjadi, data dalam kontak input akan ditampilkan di kartu kontak. Jika kecocokan terjadi, hanya data kontak sistem yang ditampilkan, dan data dalam kontak input akan dibuang.
- selection
- Rect
Rect adalah area persegi panjang pilihan pengguna (misalnya, menekan tombol), di mana sistem operasi menampilkan kartu kontak, bukan di dalam area persegi panjang tersebut. Misalnya, jika aplikasi menggunakan tombol untuk menampilkan kartu kontak, berikan Tanda Terima tombol sehingga kartu kontak ditampilkan di sekitar tombol, tidak tumpang tindih.
- Atribut
Persyaratan Windows
| Kemampuan aplikasi |
contactsSystem
|
Keterangan
Catatan
Aplikasi sumber harus berjalan di latar depan untuk memanggil metode ini. Aplikasi yang berjalan di latar belakang akan mendapatkan pengecualian "Akses Ditolak" jika memanggil metode ini.
Sebagian besar operasi umum akan menghasilkan menampilkan UI.
- Jika ada satu kecocokan yang tepat untuk kontak yang diminta: Memperlihatkan UI kartu kontak dengan informasi dari penyimpanan kontak dalam sistem operasi.
- Jika ada beberapa kecocokan: Memperlihatkan UI kartu kontak untuk kontak pertama yang cocok ditemukan.
- Jika tidak ada kecocokan: Memperlihatkan UI kartu kontak, di mana info kontak berasal dari objek kontak input.
Jika ada kesalahan, seperti input yang tidak valid untuk parameter kontak , tidak ada UI yang ditampilkan.
Untuk tujuan kueri, nomor telepon mendukung karakter 0-9 dan a-z/A-Z. Jika Anda memasukkan karakter lain ke dalam nomor telepon, karakter tersebut akan diabaikan saat Anda mengkueri kontak.
Untuk informasi tentang cara mengelola kontak, lihat Kontak dan kalender.
Untuk tujuan kueri, nomor telepon mendukung karakter 0-9 dan a-z/A-Z. Jika Anda memasukkan karakter lain ke dalam nomor telepon, karakter tersebut akan diabaikan saat Anda mengkueri kontak.
Lihat juga
Berlaku untuk
ShowContactCard(Contact, Rect, Placement)
Mengkueri sistem operasi untuk kontak pengguna dan memperlihatkan data kontak dalam kartu kontak.
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
Objek yang mewakili kontak tempat aplikasi ingin menampilkan kartu kontak. kontak harus berisi setidaknya Id, Email, atau nomor telepon dari daftar Telepon untuk mengkueri database kontak pengguna untuk mengambil kontak yang cocok untuk ditampilkan. Id memiliki prioritas yang lebih tinggi untuk kueri. Jika Id cocok, parameter kueri lainnya akan diabaikan untuk tujuan pencocokan. Jika Id tidak menemukan kecocokan, kueri menggunakan parameter kueri lainnya. Email dan Telepon memiliki prioritas yang sama untuk pencocokan. Jika beberapa alamat email, atau nomor telepon, atau keduanya disediakan, kueri terlebih dahulu melakukan kecocokan yang tepat, mengharuskan semua parameter kueri untuk mencocokkan rekaman kontak sistem. Jika ini tidak menghasilkan kecocokan, kueri menggunakan kecocokan "upaya terbaik", di mana kecocokan parameter kueri apa pun sudah cukup.
Jika tidak ada kecocokan yang terjadi, data dalam kontak input akan ditampilkan di kartu kontak. Jika kecocokan terjadi, hanya data kontak sistem yang ditampilkan, dan data dalam kontak input akan dibuang.
- selection
- Rect
Rect adalah area persegi panjang pilihan pengguna (misalnya, menekan tombol), di mana sistem operasi menampilkan kartu kontak, bukan di dalam area persegi panjang tersebut. Misalnya, jika aplikasi menggunakan tombol untuk menampilkan kartu kontak, berikan Tanda Terima tombol sehingga kartu kontak ditampilkan di sekitar tombol, tidak tumpang tindih.
- preferredPlacement
- Placement
Penempatan yang menjelaskan penempatan kartu kontak yang disukai.
- Atribut
Persyaratan Windows
| Kemampuan aplikasi |
contactsSystem
|
Keterangan
Lihat bagian keterangan dari kelebihan beban ini: ShowContactCard.
Lihat juga
- ShowContactCard(Contact, Rect)
- Sampel API manajer kontak
- IContactManagerInterop.ShowContactCardForWindow
Berlaku untuk
ShowContactCard(Contact, Rect, Placement, ContactCardOptions)
Menampilkan kartu kontak dengan parameter yang ditentukan.
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
Objek yang mewakili kontak tempat aplikasi ingin menampilkan kartu kontak. kontak harus berisi setidaknya Id, Email, atau nomor telepon dari daftar Telepon untuk mengkueri database kontak pengguna untuk mengambil kontak yang cocok untuk ditampilkan. Id memiliki prioritas yang lebih tinggi untuk kueri. Jika Id cocok, parameter kueri lainnya akan diabaikan untuk tujuan pencocokan. Jika Id tidak menemukan kecocokan, kueri menggunakan parameter kueri lainnya. Email dan Telepon memiliki prioritas yang sama untuk pencocokan. Jika beberapa alamat email, atau nomor telepon, atau keduanya disediakan, kueri terlebih dahulu melakukan kecocokan yang tepat, mengharuskan semua parameter kueri untuk mencocokkan rekaman kontak sistem. Jika ini tidak menghasilkan kecocokan, kueri menggunakan kecocokan "upaya terbaik", di mana kecocokan parameter kueri apa pun sudah cukup.
Jika tidak ada kecocokan yang terjadi, data dalam kontak input akan ditampilkan di kartu kontak. Jika kecocokan terjadi, hanya data kontak sistem yang ditampilkan, dan data dalam kontak input akan dibuang.
- selection
- Rect
Rect adalah area persegi panjang pilihan pengguna (misalnya, menekan tombol), di mana sistem operasi menampilkan kartu kontak, bukan di dalam area persegi panjang tersebut. Misalnya, jika aplikasi menggunakan tombol untuk menampilkan kartu kontak, berikan Tanda Terima tombol sehingga kartu kontak ditampilkan di sekitar tombol, tidak tumpang tindih.
- preferredPlacement
- Placement
Penempatan yang menjelaskan penempatan kartu kontak yang disukai.
- contactCardOptions
- ContactCardOptions
Menentukan cara menampilkan kartu kontak, seperti tab mana yang akan dimulai saat menampilkan kartu kontak mini.
- Atribut
Persyaratan Windows
| Kemampuan aplikasi |
contactsSystem
|
Keterangan
Lihat bagian keterangan dari kelebihan beban ini: ShowContactCard.