FileOpenPickerUI 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.
Digunakan untuk berinteraksi dengan pemilih file jika aplikasi Anda menyediakan file dengan kontrak Pemilih Buka File.
public ref class FileOpenPickerUI sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FileOpenPickerUI final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FileOpenPickerUI
Public NotInheritable Class FileOpenPickerUI
- 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
Sampel penyedia Pemilih file menunjukkan cara merespons peristiwa yang diaktifkan FileOpenPicker.
// File open picker activated event handler
protected override void OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs args)
{
var FileOpenPickerPage = new SDKTemplate.FileOpenPickerPage();
FileOpenPickerPage.Activate(args);
}
// Overloaded method to respond to fileOpenPicker events
public void Activate(FileOpenPickerActivatedEventArgs args)
{
// Perform tasks to prepare your app to display its file picker page
// Get file picker UI
fileOpenPickerUI = args.FileOpenPickerUI;
Window.Current.Content = this;
this.OnNavigatedTo(null);
Window.Current.Activate();
}
Untuk C#, args
berisi objek FileOpenPickerActivatedEventArgs . Selain itu, OnFileOpenPickerActivated
ada di file App.xaml.cs dan Activate
metodenya ada di file FileOpenPickerPage.xaml.cs dari sampel penyedia Pemilih file.
Keterangan
Jika aplikasi Anda berpartisipasi dalam kontrak File Open Picker, Anda dapat mengambil objek ini menggunakan properti FileOpenPickerUI saat Anda menangani peristiwa yang diaktifkan FileOpenPicker .
Gunakan properti Windows.ApplicationModel.Activation.FileOpenPickerActivatedEventArgs.FileOpenPickerUI untuk mengakses FileOpenPickerUI.
Pelajari tentang menciptakan pengalaman yang baik bagi pengguna saat mereka mengakses file Anda melalui pemilih file dengan membaca panduan UX untuk menyediakan file di Buka file dan folder dengan pemilih.
Properti
AllowedFileTypes |
Mendapatkan daftar jenis file (ekstensi) yang dapat dipilih pengguna. |
SelectionMode |
Mendapatkan nilai enumerasi yang menunjukkan apakah pemilih file saat ini membatasi pilihan ke satu file, atau jika beberapa file dapat dipilih. |
SettingsIdentifier |
Mendapatkan pengidentifikasi untuk konteks pemilih file saat ini. |
Title |
Mendapatkan atau mengatur judul untuk ditampilkan di UI pemilih file yang mengidentifikasi lokasi yang ditampilkan pemilih file kepada pengguna. |
Metode
AddFile(String, IStorageFile) |
Menambahkan file yang ditentukan ke daftar file yang telah dipilih pengguna. |
CanAddFile(IStorageFile) |
Menunjukkan apakah file yang ditentukan dapat ditambahkan ke daftar file yang dipilih pengguna. |
ContainsFile(String) |
Menentukan apakah file yang ditentukan ada dalam daftar file yang telah dipilih pengguna. |
RemoveFile(String) |
Menghapus file yang ditentukan dari daftar file yang dipilih pengguna. |
Acara
Closing |
Diaktifkan saat pengguna menutup pemilih file. |
FileRemoved |
Catatan Peristiwa FileRemoved tidak digunakan lagi dan tidak boleh digunakan. Diaktifkan saat pengguna menghapus file dari daftar file yang telah dipilih pengguna jika file tersebut ditambahkan oleh aplikasi yang menyediakan file. |