RadialControllerConfiguration Kelas

Referensi

Definisi

Ruang nama:: Windows.UI.Input

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

Menyediakan detail konfigurasi untuk menu RadialController .

public ref class RadialControllerConfiguration sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class RadialControllerConfiguration final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class RadialControllerConfiguration

Public NotInheritable Class RadialControllerConfiguration

Warisan: Object Platform::Object IInspectable RadialControllerConfiguration

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 Anniversary Edition (diperkenalkan dalam 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v3.0)

Contoh

Dalam contoh ini, kami menentukan alat bawaan mana yang ditampilkan pada menu, dan mengatur alat default.

Pertama, dalam ModifySystemDefaults fungsi , kita mendapatkan referensi ke objek RadialControllerConfiguration untuk Surface Dial (config) dengan memanggil GetForCurrentView.
Kemudian, kami memanggil SetDefaultMenuItems untuk menentukan koleksi default item menu bawaan (Volume dan Gulir).
Select_Volume Dalam fungsi , kami mencoba mengatur item menu default ke Volume dengan memanggil TrySelectDefaultMenuItem.

public sealed partial class MainPage : Page
{
  RadialControllerConfiguration config;

  private void ModifySystemDefaults(object sender, RoutedEventArgs e) 
  {
    config = RadialControllerConfiguration.GetForCurrentView();
    config.SetDefaultMenuItems(
      new[] { RadialControllerSystemMenuItemKind.Volume, 
        RadialControllerSystemMenuItemKind.Scroll });
  }

  private void Select_Volume(object sender, RoutedEventArgs e)
  {
    config = RadialControllerConfiguration.GetForCurrentView();
    config.TrySelectDefaultMenuItem(RadialControllerSystemMenuItemKind.Volume); 
  }
}

Dalam contoh ini, kami menghapus semua alat bawaan dengan memanggil SetDefaultMenuItems dan meneruskan koleksi kosong.

Penting

Saat hadir, InkToolbar menambahkan dua alat kustom ke menu RadialController (ukuran pena dan goresan). Alat-alat ini tidak dapat diakses melalui API RadialController seperti Item atau SetDefaultMenuItems.

private void ClearSystemDefaults(object sender, RoutedEventArgs e) 
{
  config = RadialControllerConfiguration.GetForCurrentView();
  config.SetDefaultMenuItems(
    new[] { });
}

Keterangan

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1703	15063	ActiveControllerWhenMenuIsSuppressed
1703	15063	IsMenuSuppressed
1709	16299	PengontrolAplikasi
1709	16299	IsAppControllerEnabled

Properti

ActiveControllerWhenMenuIsSuppressed	Mendapatkan atau mengatur RadialController untuk diaktifkan saat menu RadialController ditekan.
AppController	Mendapatkan atau mengatur apakah objek RadialController terikat ke proses aplikasi utama daripada tampilan aplikasi tertentu (atau jendela tingkat atas). Jika AppController diatur, pengontrol radial (dan menu) tersebut digunakan untuk jendela tingkat atas dan semua tampilan dalam proses aplikasi (menimpa setiap pengontrol tampilan individual yang telah Anda tentukan). Catatan Anda juga harus mengatur IsAppControllerEnabled ke true.
IsAppControllerEnabled	Mendapatkan atau mengatur apakah objek RadialController diaktifkan sebagai peristiwa AppController dan pengontrol dapat ditangani oleh aplikasi Anda.
IsMenuSuppressed	Mendapatkan atau mengatur apakah menu RadialController dapat ditampilkan.

Metode

GetForCurrentView()	Mengambil objek RadialControllerConfiguration yang terikat ke aplikasi aktif.
ResetToDefaultMenuItems()	Memulihkan menu RadialController ke konfigurasi default.
SetDefaultMenuItems(IIterable<RadialControllerSystemMenuItemKind>)	Menentukan alat bawaan mana yang ditampilkan pada menu RadialController . Penting Saat hadir, InkToolbar menambahkan dua alat kustom ke menu RadialController (ukuran pena dan goresan). Alat-alat ini tidak dapat diakses melalui API RadialController seperti Item atau SetDefaultMenuItems.
TrySelectDefaultMenuItem(RadialControllerSystemMenuItemKind)	Mencoba memilih dan mengaktifkan alat dari kumpulan alat RadialController bawaan yang didukung untuk konteks aplikasi saat ini.

Berlaku untuk

Bagikan melalui