ShareOperation Kelas
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.
Menangani sebagian besar pekerjaan selama operasi berbagi. Ini termasuk data yang ingin dibagikan pengguna, mengatur, atau menghapus QuickLinks, dan memberi tahu sistem tentang status operasi.
public ref class ShareOperation sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class ShareOperation final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class ShareOperation
Public NotInheritable Class ShareOperation
- Warisan
- Atribut
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Contoh
Contoh berikut menunjukkan cara bekerja dengan objek ShareOperation.
var shareOperation = eventObject.detail.shareOperation;
if (shareOperation.data.contains(Windows.ApplicationModel.DataTransfer.StandardDataFormats.text)) {
shareOperation.data.getTextAsync().done(function (text) {
// To output the text using this example,
// you need a div tag with an id of "output" in your HTML file.
document.getElementById("output").innerText = text;
}, function (e) {
displayError("Error retrieving Text format: " + e);
}
});
}
Keterangan
Saat pengguna memilih aplikasi Anda sebagai target tindakan berbagi, peristiwa yang diaktifkan akan diaktifkan. Objek yang dikirim peristiwa ini ke aplikasi Anda berisi instans kelas ShareOperation .
Aplikasi yang saat ini terbuka sebagai target Berbagi tidak dapat memulai ShareOperation tambahan, atau meluncurkan FileOpenPicker atau FileSavePicker.
Semua API ShareOperation hanya boleh dipanggil setelah CoreWindow untuk target Berbagi diaktifkan. Platform Berbagi membuat entri untuk operasi berbagi hanya setelah jendela diaktifkan.
Catatan
Kelas ini tidak lincah, yang berarti Anda perlu mempertimbangkan model utas dan perilaku marshalingnya. Untuk informasi selengkapnya, lihat Threading dan Marshaling (C++/CX) dan Menggunakan objek Windows Runtime di lingkungan multithreaded (.NET).
Riwayat versi
Versi Windows | Versi SDK | Nilai ditambahkan |
---|---|---|
1709 | 16299 | Kontak |
Properti
Contacts |
Mendapatkan kontak untuk operasi berbagi. |
Data |
Berisi objek DataPackage dengan data yang ingin dibagikan pengguna. |
QuickLinkId |
String yang berisi ID QuickLink. |
Metode
DismissUI() |
Menutup panel berbagi. |
RemoveThisQuickLink() |
Menghapus QuickLink dari daftar QuickLink yang tersedia untuk pengguna. |
ReportCompleted() |
Menentukan bahwa operasi berbagi selesai. |
ReportCompleted(QuickLink) |
Menentukan bahwa operasi berbagi selesai. QuickLink yang dapat disimpan sistem sebagai pintasan untuk operasi berbagi di masa mendatang disertakan. |
ReportDataRetrieved() |
Menentukan bahwa aplikasi telah memperoleh konten yang ingin dibagikan pengguna. |
ReportError(String) |
Menentukan bahwa terjadi kesalahan selama operasi berbagi. |
ReportStarted() |
Menentukan bahwa aplikasi telah mulai memperoleh konten yang ingin dibagikan pengguna. |
ReportSubmittedBackgroundTask() |
Menentukan bahwa aplikasi telah meminta agar sistem mengizinkan operasi berbagi berjalan sebagai tugas latar belakang. |