ShareWindowCommandSource Kelas

Referensi

Definisi

Ruang nama:: Windows.UI.Shell

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.

Edit

Mewakili objek yang dapat digunakan aplikasi komunikasi Anda untuk menyiapkan komunikasi dengan Window Shell untuk menyajikan UI untuk memulai dan menghentikan berbagi jendela.

Dapatkan instans ShareWindowCommandSource, dan daftar untuk menangani peristiwa ShareWindowCommandSource.CommandRequested dan ShareWindowCommandSource.CommandInvoked instans. Peristiwa tersebut dibesarkan oleh Windows Shell.

Penting

WINDOWS.UI.Shell.ShareWindowCommandSource API adalah bagian dari Fitur Akses Terbatas (lihat kelas LimitedAccessFeatures). Untuk informasi lebih lanjut atau untuk meminta token pembuka kunci, silakan gunakan Formulir Permintaan Token Akses LAF.

public ref class ShareWindowCommandSource sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 851968)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ShareWindowCommandSource final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 851968)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ShareWindowCommandSource

Public NotInheritable Class ShareWindowCommandSource

Warisan: Object Platform::Object IInspectable ShareWindowCommandSource

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 11 (diperkenalkan dalam 10.0.22000.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v14.0)

Keterangan

Fungsionalitas ini menambah fitur berbagi jendela yang sudah diterapkan aplikasi Anda, menyediakan metode alternatif untuk memilih jendela. Desain ini memungkinkan aplikasi Anda menyajikan mulai berbagi dan berhenti berbagi perintah; dan untuk menerapkannya dengan cara yang sesuai dengan kemampuan aplikasi Anda untuk berbagi satu atau beberapa jendela.

Aplikasi komunikasi Anda mengidentifikasi jendela yang sesuai dengan kemampuan untuk berbagi jendela—jendela aplikasi tunggal, atau jendela yang menghosting sesi komunikasi (panggilan). Windows Shell menggunakan ini untuk:

Dapatkan informasi identifikasi aplikasi, seperti ikon dan namanya, yang akan disajikan dengan perintah berbagi.
Pilih di antara beberapa sumber perintah berbagi. Aplikasi berbagi yang terakhir digunakan akan dipilih.

Peristiwa digunakan untuk meminta perintah dan memanggilnya, ini termasuk WindowId jendela yang akan dibagikan.

IShareWindowCommandSourceInterop adalah antarmuka interoperabilitas asli yang memungkinkan mendapatkan objek ShareWindowCommandSource .

Metode

GetForCurrentView()	Metode statis yang dapat Anda gunakan untuk mendapatkan instans ShareWindowCommandSource. Penting Api ShareWindowCommandSource.GetForCurrentView adalah bagian dari Fitur Akses Terbatas (lihat kelas LimitedAccessFeatures). Untuk informasi lebih lanjut atau untuk meminta token pembuka kunci, silakan gunakan Formulir Permintaan Token Akses LAF.
ReportCommandChanged()	Menunjukkan kepada Windows Shell bahwa status berbagi aplikasi komunikasi Anda telah berubah. Panggil metode ini setiap kali status berbagi aplikasi komunikasi Anda berubah. Jika Anda berhasil berbagi jendela baru dalam panggilan atau rapat, atau Anda menghapus jendela yang sudah dibagikan (baik itu melalui UI Anda sendiri, atau dipicu oleh tindakan Taskbar Windows), Anda harus memberi tahu instans ShareWindowCommandSource Anda tentang perubahan tersebut dengan memanggil ReportCommandChanged. Shell kemudian akan menghapus informasi apa pun yang telah diterimanya sebagai bagian dari peristiwa ShareWindowCommandSource.CommandRequested apa pun, dan akan memperbarui perintah berbagi yang terlihat agar sesuai dengan status aplikasi Anda saat ini.
Start()	Menunjukkan bahwa aplikasi panggilan saat ini adalah sumber perintah berbagi jendela. Panggil metode ini selama panggilan atau rapat untuk mengaktifkan aplikasi komunikasi Anda sebagai sumber perintah berbagi jendela.
Stop()	Menunjukkan bahwa aplikasi panggilan bukan sumber perintah berbagi jendela. Panggil metode ini saat panggilan atau rapat berakhir untuk menonaktifkan aplikasi komunikasi Anda sebagai sumber perintah berbagi jendela.

Acara

CommandInvoked	Peristiwa yang diangkat oleh Windows Shell untuk memberi aplikasi komunikasi Anda kesempatan untuk benar-benar memulai atau berhenti berbagi jendela tertentu.
CommandRequested	Peristiwa yang diangkat oleh Windows Shell untuk memberi aplikasi komunikasi Anda kesempatan untuk mendukung memulai atau berhenti berbagi jendela tertentu.

Berlaku untuk

Bagikan melalui