Bagikan melalui


RadialControllerConfiguration Kelas

Definisi

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

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.

  1. Pertama, dalam ModifySystemDefaults fungsi , kita mendapatkan referensi ke objek RadialControllerConfiguration untuk Surface Dial (config) dengan memanggil GetForCurrentView.
  2. Kemudian, kami memanggil SetDefaultMenuItems untuk menentukan koleksi default item menu bawaan (Volume dan Gulir).
  3. 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

Lihat juga