ToolTipService Kelas

Referensi

Definisi

Ruang nama:: Microsoft.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

Mewakili layanan yang menyediakan metode statis untuk menampilkan TipsAlat.

public ref class ToolTipService sealed

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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

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 ToolTipService.Placement terlampir 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.

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 dapatkan dan atur 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 TipsAlat diposisikan dalam kaitannya dengan target penempatan. Jenis: PlacementMode Bidang pengidentifikasi: PlacementProperty Metode aksesor: GetPlacement, SetPlacement
PlacementTarget	Mendapatkan atau mengatur objek relatif terhadap tempat tipsalat diposisikan. Jenis: UIElement Bidang pengidentifikasi: PlacementTargetProperty Metode aksesor: GetPlacementTarget, SetPlacementTarget
ToolTip	Mendapatkan atau mengatur konten objek atau string dari TipsAlat elemen. Ketik: objek Bidang pengidentifikasi: ToolTipProperty Metode aksesor: GetToolTip, SetToolTip

Properti

PlacementProperty	Mengidentifikasi properti terlampir ToolTipService.Placement XAML.
PlacementTargetProperty	Mengidentifikasi properti terlampir ToolTipService.PlacementTarget XAML.
ToolTipProperty	Mengidentifikasi properti terlampir ToolTipService.Tooltip XAML.

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 terlampir ToolTipService.PlacementTarget XAML untuk elemen target yang ditentukan.
SetToolTip(DependencyObject, Object)	Mengatur nilai properti toolTipService.ToolTip XAML terlampir.

Berlaku untuk

Bagikan melalui