ToolTipService Kelas

  • Referensi

Definisi

Ruang nama:
Windows.UI.Xaml.Controls
Edit

Mewakili layanan yang menyediakan metode statis untuk menampilkan TipsAlat.

public ref class ToolTipService sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ToolTipService final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ToolTipService
Public NotInheritable Class ToolTipService
Warisan
Object Platform::Object IInspectable ToolTipService
Atribut
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Contoh kode berikut menunjukkan mode penempatan untuk TipsAlat.

<StackPanel Margin="120" >
    <TextBlock Text="ToolTip Control"/>
    <TextBlock Text="Hover over an item to see its ToolTip: " Margin="0,10"/>
    <ListBox Width="100" HorizontalAlignment="Left">
        <ListBoxItem Content="Left" 
            ToolTipService.ToolTip="ToolTip to the left." 
            ToolTipService.Placement="Left" />
        <ListBoxItem Content="Right" 
            ToolTipService.ToolTip="ToolTip to the right." 
            ToolTipService.Placement="Right" />
        <ListBoxItem Content="Top" 
            ToolTipService.ToolTip="ToolTip at the top." 
            ToolTipService.Placement="Top" />
        <ListBoxItem Content="Bottom" 
            ToolTipService.ToolTip="ToolTip at the bottom." 
            ToolTipService.Placement="Bottom"/>
        <ListBoxItem Content="Mouse" 
            ToolTipService.ToolTip="ToolTip based on the cursor position." 
            ToolTipService.Placement="Mouse"/>
    </ListBox>
</StackPanel>

Keterangan

TipsAlat harus ditetapkan ke elemen UI lain yang merupakan pemiliknya. Dalam Extensible Application Markup Language (XAML), gunakan properti terlampir ToolTipService.ToolTip untuk menetapkan TipsAlat kepada pemilik. Dalam kode, gunakan metode ToolTipService.SetToolTip untuk menetapkan TipsAlat kepada pemilik.

Penempatan

Secara default, TipsAlat ditampilkan di tengah di atas penunjuk. Penempatan tidak dibatasi oleh jendela aplikasi, sehingga TipsAlat mungkin ditampilkan sebagian atau sepenuhnya di luar batas jendela aplikasi.

Jika TipsAlat mengaburkan konten yang dirujuknya, Anda dapat menyesuaikan penempatannya. Gunakan properti terlampir ToolTipService.Placement untuk menempatkan TipsAlat di atas, di bawah, kiri, atau kanan penunjuk.

Jika tidak ada PlacementTarget eksplisit, target penempatan untuk tipsalat adalah elemen yang menentukan nilai untuk nilai properti terlampir TooltipService.ToolTip-nya. Nilai Penempatan apa pun (baik sebagai properti terlampir atau sebagai atribut pada elemen TipsAlat eksplisit) berlaku untuk target tersebut.

Catatan untuk versi sebelumnya

TipsAlatWindows 8.x hanya ditujukan untuk digunakan di Windows. Jenis TipsAlat tersedia di proyek Windows Phone untuk kompatibilitas dengan templat proyek universal, tetapi TipsAlat tidak ditampilkan di UI Windows Phone.

TipsAlat hanya ditampilkan dalam batas jendela aplikasi. Penempatan ini mungkin disesuaikan untuk tetap berada dalam batas-batas tersebut.

Properti terlampir XAML

ToolTipService adalah kelas layanan host untuk beberapa properti terlampir XAML.

Untuk mendukung akses prosesor XAML ke properti terlampir, dan juga untuk mengekspos operasi get dan set yang setara ke kode, setiap properti terlampir XAML memiliki sepasang metode aksesor Get and Set. Cara lain untuk mendapatkan atau mengatur nilai dalam kode adalah dengan menggunakan sistem properti dependensi, memanggil GetValue atau SetValue dan meneruskan bidang pengidentifikasi sebagai pengidentifikasi properti dependensi.

Properti terlampir Deskripsi
Penempatan Mendapatkan atau menetapkan nilai yang menunjukkan bagaimana diposisikan ToolTip dalam kaitannya dengan target penempatan.
PlacementTarget Mendapatkan atau mengatur objek relatif terhadap tempat ToolTip diposisikan.
ToolTip Mendapatkan atau mengatur konten objek atau string dari elemen ToolTip.

Properti

PlacementProperty

Mengidentifikasi properti terlampir ToolTipService.Placement XAML.
PlacementTargetProperty

Mengidentifikasi properti terlampir ToolTipService.PlacementTarget XAML.
ToolTipProperty

Mengidentifikasi properti toolTipService.ToolTip XAML terlampir.

Properti yang Terlampir

Placement

Mendapatkan atau menetapkan nilai yang menunjukkan bagaimana TipsAlat diposisikan dalam kaitannya dengan target penempatan.
PlacementTarget

Mendapatkan atau mengatur objek relatif terhadap tempat tipsalat diposisikan.
ToolTip

Mendapatkan atau mengatur konten objek atau string dari TipsAlat elemen.

Metode

GetPlacement(DependencyObject)

Mendapatkan nilai properti terlampir ToolTipService.Placement XAML untuk elemen target yang ditentukan.
GetPlacementTarget(DependencyObject)

Mendapatkan nilai properti terlampir ToolTipService.PlacementTarget XAML untuk elemen target yang ditentukan.
GetToolTip(DependencyObject)

Mendapatkan nilai properti terlampir ToolTipService.ToolTip XAML untuk objek.
SetPlacement(DependencyObject, PlacementMode)

Mengatur nilai properti terlampir ToolTipService.Placement XAML untuk elemen target yang ditentukan.
SetPlacementTarget(DependencyObject, UIElement)

Mengatur nilai properti terpasang ToolTipService.PlacementTarget XAML untuk elemen target yang ditentukan.
SetToolTip(DependencyObject, Object)

Mengatur nilai properti toolTipService.ToolTip XAML terlampir.

Berlaku untuk

Lihat juga