FileOpenPickerUI Kelas

Referensi

Definisi

Ruang nama:: Windows.Storage.Pickers.Provider

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

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: Object Platform::Object IInspectable FileOpenPickerUI

Atribut: ContractVersionAttribute

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.

Berlaku untuk

Bagikan melalui