ScrollViewer.HorizontalSnapPointsType Properti

Referensi

Definisi

Ruang nama:: Windows.UI.Xaml.Controls

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

Mendapatkan atau menetapkan nilai yang menyatakan bagaimana perilaku manipulasi bereaksi terhadap titik snap di sepanjang sumbu horizontal.

public:
 property SnapPointsType HorizontalSnapPointsType { SnapPointsType get(); void set(SnapPointsType value); };

SnapPointsType HorizontalSnapPointsType();

void HorizontalSnapPointsType(SnapPointsType value);

public SnapPointsType HorizontalSnapPointsType { get; set; }

var snapPointsType = scrollViewer.horizontalSnapPointsType;
scrollViewer.horizontalSnapPointsType = snapPointsType;

Public Property HorizontalSnapPointsType As SnapPointsType

<ScrollViewer HorizontalSnapPointsType="snapPointsTypeMemberName" />

Nilai Properti

SnapPointsType

Nilai enumerasi. Defaultnya adalah Tidak Ada tetapi mungkin diatur melalui templat kontrol.

Contoh

XAML ini berasal dari templat default untuk kontrol Hub . Hub memiliki bagian ScrollViewer yang mengelilingi ItemsStackPanel untuk kontennya. Hub menggunakan nilai Opsional untuk perilaku snapping-nya di kedua dimensi (meskipun VerticalScrollMode dinonaktifkan dalam status visual awal) dan menonaktifkan ZoomMode. Perhatikan bagaimana properti SnapPointsAlignment juga diatur sebagai atribut di sini.

<ControlTemplate TargetType="Hub">
...
<ScrollViewer x:Name="ScrollViewer"
    Grid.RowSpan="2"
    HorizontalScrollMode="Auto"
    HorizontalScrollBarVisibility="Auto"
    VerticalScrollMode="Disabled"
    VerticalScrollBarVisibility="Disabled"
    HorizontalSnapPointsAlignment="Near"
    HorizontalSnapPointsType="Optional"
    VerticalSnapPointsAlignment="Near"
    VerticalSnapPointsType="Optional"
    ZoomMode="Disabled">
  <ItemsStackPanel x:Name="Panel" 
       Orientation="{TemplateBinding Orientation}"
       CacheLength="20" />
</ScrollViewer>
...
</ControlTemplate>

Keterangan

Untuk tindakan panning, sering kali ada tempat penghentian alami. Titik snap menyediakan cara untuk menunjukkan di mana tempat-tempat ini berada. Kemudian, ketika pengguna menggesek, hasil manipulasi mendukung titik alami tersebut menggunakan perilaku seperti yang dinyatakan oleh nilai SnapPointsType .

**Titik kedekatan (Opsional dan OpsionalSingle): ** Ketika pengguna akan secara alami menghentikan manipulasi di kedekatan titik snap, titik kedekatan membantu pengguna mendarat di tempat penghentian alami. Karena pengguna harus mendarat di dekat titik jepret untuk menyebabkannya berhenti di sana, pengguna terkadang harus melakukan geser lain untuk mencapai titik jepret.

**Poin snap wajib (Mandatory and MandatorySingle): ** Berbeda dengan kedekatan, titik snap wajib memastikan bahwa konten disesuaikan untuk selalu mendarat di titik penyangga. Bahkan jika pengguna merilis manipulasi di tengah antara dua snap-point, pengguna akan selalu berpindah ke salah satu titik snap.

Untuk melihat efek snap point pada perilaku ScrollViewer sendiri, dapatkan sampel pengguliran, pengalihan, dan pembesaran tampilan XAML. Jalankan sampel pada perangkat sentuh (bukan simulator). Cobalah nilai SnapPointsType saat Anda melihat halaman contoh "Panning with snap-points" dari sampel.

Untuk mempelajari selengkapnya tentang gerakan gesek dan panning, lihat bagian "Perilaku panning" di Panduan untuk panning.

Nilai default None adalah default enumerasi. Jika diatur, properti ini sering diatur sebagai atribut dalam bagian templat XAML, atau sebagai Setter gaya. Setiap kontrol berpotensi mengatur ini secara berbeda. Mendapatkan nilai pada durasi akan memberikan nilai yang berasal dari gaya dan templat yang diterapkan.

Berlaku untuk

Share via