Aracılığıyla paylaş

ToolTip Genel Bakışı

  • Makale

Araç ipucu, kullanıcı fare işaretçisini bir öğenin üzerinde, örneğin üzerinde duraklattığında görüntülenen küçük bir Buttonaçılır penceredir. Bu konuda araç ipucu tanıtılır ve araç ipucu içeriğinin nasıl oluşturulacağı ve özelleştirileceği açıklanır.

Araç İpucu nedir?

Kullanıcı fare işaretçisini araç ipucu olan bir öğenin üzerine getirince, belirli bir süre için araç ipucu içeriği (örneğin, denetimin işlevini açıklayan metin içeriği) içeren bir pencere görüntülenir. Kullanıcı fare işaretçisini denetimden uzaklaştırırsa, araç ipucu içeriği odağı alamadığından pencere kaybolur.

Araç ipucunun içeriği bir veya daha fazla metin satırı, resim, şekil veya diğer görsel içeriği içerebilir. Aşağıdaki özelliklerden birini araç ipucu içeriğine ayarlayarak bir denetim için araç ipucu tanımlarsınız.

Hangi özelliği kullanacağınız, araç ipucunun tanımlandığı denetimin veya FrameworkElement sınıfından devralıp devralmadığına FrameworkContentElement bağlıdır.

Araç İpucu Oluşturma

Aşağıdaki örnekte, denetimin özelliğini bir metin dizesine ayarlayarak ToolTip basit bir Button araç ipucunun nasıl oluşturulacağı gösterilmektedir.

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

Araç ipucu da nesne olarak ToolTip tanımlayabilirsiniz. Aşağıdaki örnekte, bir öğenin araç ipucu TextBox olarak bir ToolTip nesne belirtmek için XAML kullanılmaktadır. Örneğin özelliğini ayarlayarak öğesini belirttiğini ToolTipFrameworkElement.ToolTip unutmayın.

<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>

Aşağıdaki örnekte bir ToolTip nesne oluşturmak için kod kullanılmaktadır. Örnek bir ToolTip oluşturur (tt) ve ile Buttonilişkilendirir.

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)

Araç ipucu içeriğini gibi DockPanelbir ToolTip düzen öğesi içine alarak nesne olarak tanımlanmayan araç ipucu içeriği de oluşturabilirsiniz. Aşağıdaki örnekte, bir özelliğinin ToolTip bir TextBox denetimin içinde yer alan içeriğe nasıl ayarlanacağı DockPanel gösterilmektedir.

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

ToolTip ve ToolTipService Sınıflarının Özelliklerini Kullanma

Görsel özellikleri ayarlayarak ve stilleri uygulayarak araç ipucu içeriğini özelleştirebilirsiniz. Araç ipucu içeriğini bir ToolTip nesne olarak tanımlarsanız, nesnenin görsel özelliklerini ToolTip ayarlayabilirsiniz. Aksi takdirde, sınıfında eşdeğer ekli özellikler ToolTipService ayarlamanız gerekir.

ve ToolTipService özelliklerini kullanarak araç ipucu içeriğinin konumunu belirtmek için özelliklerin nasıl ayarlanacağına ToolTip ilişkin bir örnek için bkz. Araç İpucu konumlandırma.

Araç İpucu Stili Oluşturma

Özel Stylebir tanımlayarak stil ToolTip oluşturabilirsiniz. Aşağıdaki örnekte , , FontSizeForegroundve FontWeightayarlanarak Backgroundöğesinin yerleşiminin ToolTip nasıl kaydırıldığını ve görünümünün nasıl değiştirildiğini gösteren bir Style çağrı Simple tanımlanır.

<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>

ToolTipService'in Zaman Aralığı Özelliklerini Kullanma

sınıfı, ToolTipService araç ipucu görüntüleme sürelerini ayarlamanız için aşağıdaki özellikleri sağlar: InitialShowDelay, BetweenShowDelayve ShowDuration.

InitialShowDelay ve ShowDuration özelliklerini kullanarak, bir görüntülenmeden önce genellikle kısa bir ToolTip gecikme ve ne kadar süreyle ToolTip görünür kalacağını belirtin. Daha fazla bilgi için bkz . Nasıl yapılır: Araç İpucunun Görüntülenmesini Geciktirme.

özelliği, BetweenShowDelay fare işaretçisini aralarında hızlı bir şekilde hareket ettirdiğinizde farklı denetimler için araç ipuçlarının ilk gecikme olmadan görüntülenip görüntülenmediğini belirler. Özelliği hakkında BetweenShowDelay daha fazla bilgi için bkz . BetweenShowDelay Özelliğini Kullanma.

Aşağıdaki örnekte bir araç ipucu için bu özelliklerin nasıl ayarlanacağı gösterilmektedir.

<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>

Ayrıca bkz.