Aracılığıyla paylaş

Araç İpuçları Genel Görünümü

  • Makale

Araç ipucu, kullanıcı fare işaretçisini bir öğenin üzerinde duraklattığında (örneğin, bir Button) görüntülenen küçük bir açı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ç ipucunu tanımlayan kontrolün FrameworkContentElement mı yoksa FrameworkElement sınıfından mı devraldığına bağlıdır.

Araç İpucu Oluşturma

Aşağıdaki örnekte, bir Button denetimi için ToolTip özelliğini bir metin dizesine ayarlayarak basit bir 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 ToolTip nesnesi olarak da tanımlayabilirsiniz. Aşağıdaki örnekte, XAML kullanılarak bir ToolTip nesnesi, bir TextBox öğesinin araç ipucu olarak belirtilmiştir. Örneğin, FrameworkElement.ToolTip özelliğini ayarlayarak ToolTip belirttiğini 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 ToolTip nesnesi oluşturmak için kod kullanılmaktadır. Örnek bir ToolTip (tt) oluşturur ve bunu bir Buttonile iliş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 DockPanelgibi bir düzen öğesi içine alarak ToolTip nesnesi olarak tanımlanmayan araç ipucu içeriği de oluşturabilirsiniz. Aşağıdaki örnekte, bir TextBox'in ToolTip özelliğinin bir DockPanel denetiminde yer alan içeriğe nasıl ayarlanacağı 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 nesnesi olarak tanımlarsanız, ToolTip nesnesinin görsel özelliklerini ayarlayabilirsiniz. Aksi takdirde, ToolTipService sınıfında eşdeğer ekli özellikler ayarlamanız gerekir.

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

Araç İpucunun Biçimlendirilmesi

Özel bir Styletanımlayarak bir ToolTip stili tanımlayabilirsiniz. Aşağıdaki örnek, Background, Foreground, FontSizeve FontWeightayarlayarak ToolTip yerleşiminin nasıl kaydırıldığını ve görünümünün nasıl değiştirildiğini gösteren Simple adlı bir Style tanımlar.

<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

ToolTipService sınıfı, 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 ToolTip görünmeden önce genellikle kısa bir gecikme ve bir ToolTip ne kadar süre 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.

BetweenShowDelay özelliği, 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. BetweenShowDelay özelliği hakkında 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.