Bagikan melalui

Gambaran Umum TipsAlat

  • Artikel

Tipsalat adalah jendela pop-up kecil yang muncul ketika pengguna menjeda penunjuk mouse di atas elemen, seperti melalui Button. Topik ini memperkenalkan tipsalat dan membahas cara membuat dan menyesuaikan konten tipsalat.

Apa itu TipsAlat

Saat pengguna memindahkan penunjuk mouse ke elemen yang memiliki tipsalat, jendela yang berisi konten tipsalat (misalnya, konten teks yang menjelaskan fungsi kontrol) muncul selama jumlah waktu tertentu. Jika pengguna memindahkan penunjuk mouse menjauh dari kontrol, jendela menghilang karena konten tipsalat tidak dapat menerima fokus.

Konten tipsalat dapat berisi satu atau beberapa baris teks, gambar, bentuk, atau konten visual lainnya. Anda menentukan tipsalat untuk kontrol dengan mengatur salah satu properti berikut ke konten tipsalat.

Properti mana yang Anda gunakan tergantung pada apakah kontrol yang menentukan tipsalat mewarisi dari FrameworkContentElement kelas atau FrameworkElement .

Membuat TipsAlat

Contoh berikut menunjukkan cara membuat tipsalat sederhana dengan mengatur ToolTip properti untuk Button kontrol ke string teks.

<Button ToolTip="Click to submit your information" 
        Click="SubmitCode" Height="20" Width="50">Submit</Button>

Anda juga dapat menentukan tipsalat ToolTip sebagai objek. Contoh berikut menggunakan XAML untuk menentukan ToolTip objek sebagai tipsalat TextBox elemen. Perhatikan bahwa contoh menentukan ToolTip dengan mengatur FrameworkElement.ToolTip properti .

<TextBox HorizontalAlignment="Left">ToolTip with non-text content
  <TextBox.ToolTip>
    <ToolTip>
      <DockPanel Width="50" Height="70">
        <Image Source="data\flower.jpg"/>
        <TextBlock>Useful information goes here.</TextBlock>
      </DockPanel>
    </ToolTip>
  </TextBox.ToolTip>
</TextBox>

Contoh berikut menggunakan kode untuk menghasilkan ToolTip objek. Contoh membuat ToolTip (tt) dan mengaitkannya dengan Button.

button = new Button();
button.Content = "Hover over me.";
tt = new ToolTip();
tt.Content = "Created with C#";
button.ToolTip = tt;
cv2.Children.Add(button);

button = New Button()
button.Content = "Hover over me."
tt = New ToolTip()
tt.Content = "Created with Visual Basic"
button.ToolTip = tt
cv2.Children.Add(button)

Anda juga dapat membuat konten tipsalat yang tidak didefinisikan sebagai ToolTip objek dengan menyertakan konten tipsalat dalam elemen tata letak, seperti DockPanel. Contoh berikut menunjukkan cara mengatur ToolTip properti dari ke TextBox konten yang diapit dalam DockPanel kontrol.

<TextBox>
  ToolTip with image and text
  <TextBox.ToolTip>
       <StackPanel>
        <Image Source="data\flower.jpg"/>
        <TextBlock>Useful information goes here.</TextBlock>
      </StackPanel>
  </TextBox.ToolTip>

Menggunakan Properti ToolTip dan ToolTipService Classes

Anda dapat menyesuaikan konten tipsalat dengan mengatur properti visual dan menerapkan gaya. Jika Anda menentukan konten tipsalat ToolTip sebagai objek, Anda dapat mengatur properti ToolTip visual objek. Jika tidak, Anda harus mengatur properti terlampir yang setara pada ToolTipService kelas .

Untuk contoh cara mengatur properti untuk menentukan posisi konten tipsalat dengan menggunakan ToolTip properti dan ToolTipService , lihat Memposisikan TipsAlat.

Menata TipsAlat

Anda dapat menata ToolTip dengan menentukan kustom Style. Contoh berikut mendefinisikan panggilan StyleSimple yang menunjukkan cara mengimbangi penempatan ToolTip dan mengubah tampilannya dengan mengatur Background, , ForegroundFontSize, dan FontWeight.

<Style TargetType="ToolTip">
  <Setter Property = "HorizontalOffset" Value="10"/>
  <Setter Property = "VerticalOffset" Value="10"/>
  <Setter Property = "Background" Value="LightBlue"/>
  <Setter Property = "Foreground" Value="Purple"/>
  <Setter Property = "FontSize" Value="14"/>
  <Setter Property = "FontWeight" Value="Bold"/>
</Style>

Menggunakan Properti Interval Waktu ToolTipService

Kelas ToolTipService menyediakan properti berikut bagi Anda untuk mengatur waktu tampilan tipsalat: InitialShowDelay, BetweenShowDelay, dan ShowDuration.

InitialShowDelay Gunakan properti dan ShowDuration untuk menentukan penundaan, biasanya singkat, sebelum ToolTip muncul dan juga untuk menentukan berapa lama ToolTip tetap terlihat. Untuk informasi selengkapnya, lihat Cara: Menunda Tampilan TipsAlat.

Properti BetweenShowDelay menentukan apakah tipsalat untuk kontrol yang berbeda muncul tanpa penundaan awal saat Anda memindahkan penunjuk mouse dengan cepat di antara kontrol tersebut. Untuk informasi selengkapnya tentang BetweenShowDelay properti , lihat Menggunakan Properti BetweenShowDelay.

Contoh berikut menunjukkan cara mengatur properti ini untuk tipsalat.

<Ellipse Height="25" Width="50" 
         Fill="Gray" 
         HorizontalAlignment="Left"
         ToolTipService.InitialShowDelay="1000"
         ToolTipService.ShowDuration="7000"
         ToolTipService.BetweenShowDelay="2000">
  <Ellipse.ToolTip>
    <ToolTip Placement="Right" 
             PlacementRectangle="50,0,0,0"
             HorizontalOffset="10" 
             VerticalOffset="20"
             HasDropShadow="false"
             Opened="whenToolTipOpens"
             Closed="whenToolTipCloses"
             >
      <BulletDecorator>
        <BulletDecorator.Bullet>
          <Ellipse Height="10" Width="20" Fill="Blue"/>
        </BulletDecorator.Bullet>
        <TextBlock>Uses the ToolTip Class</TextBlock>
      </BulletDecorator>
    </ToolTip>
  </Ellipse.ToolTip>
</Ellipse>

Baca juga