ToolTip Genel Bakışı
Araç ipucu, kullanıcı fare işaretçisini bir öğe üzerinde duraklatıyorsa görüntülenen küçük bir açılır penceredir( örneğin, Button üzerinde). Bu konu araç ipucuna yer ve araç ipucu içeriğinin nasıl oluşturularak özelleştirildiklerini ele almaktadır.
Araç İpucu Nedir?
Kullanıcı fare işaretçisini araç ipucuna sahip bir öğenin üzerine taşırsa, belirtilen 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ünür. Kullanıcı fare işaretçisini denetimden uzağa taşırsa, araç ipucu içeriği odağı alamay ettiğinden pencere kaybolur.
Araç ipucu içeriği bir veya daha fazla metin, görüntü, şekil veya başka görsel içerik satırı içerebilir. Aşağıdaki özelliklerden birini araç ipucu içeriğine ayarlayarak bir denetim için araç ipucu tanımlayın.
Hangi özelliği kullandığınız, araç ipucu tanımlayan denetimin veya sınıfından devralınıp FrameworkContentElement devralmay durumuna FrameworkElement bağlıdır.
ToolTip Oluşturma
Aşağıdaki örnekte, bir denetimin özelliğini bir metin dizesine ToolTip ayarerek basit bir araç Button ipucu oluşturma adımları açıkmaktadır.
<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 örnek, bir nesneyi öğenin araç ipucu olarak belirtmek için XAML ToolTipTextBox kullanır. örneğinin özelliğini ayarerek ToolTipFrameworkElement.ToolTip belirtir.
<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 örnek, nesne oluşturmak için kod ToolTip kullanır. Örnek bir oluşturur ToolTip ( ) ve bir ile ttButton ilişkilendirin.
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 bir düzen öğesi içine alan bir nesne olarak tanımlanmamış araç ipucu içeriği ToolTip de DockPanel oluşturabilirsiniz. Aşağıdaki örnek, bir özelliğinin ToolTip bir denetimin TextBox içine alınmış içeriğe nasıl ayarlay olduğunu DockPanel gösterir.
<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 ayarp stilleri uygulayarak araç ipucu içeriğini özelleştirebilirsiniz. Araç ipucu içeriğini bir nesne olarak ToolTip tanımlarsanız, nesnenin görsel özelliklerini ToolTip ayarlayın. Aksi takdirde, sınıfında eşdeğer ekli özellikler ToolTipService ayarlayabilirsiniz.
ve özelliklerini kullanarak araç ipucu içeriğinin konumunu belirtmek için özellikleri ayarlama örneği ToolTipToolTipService için, ToolTip.
ToolTip'e Stil Ekleme
Özel bir ToolTip tanımlayarak stil Style oluşturabilirsiniz. Aşağıdaki örnek, ve ayarıyla yerleşimini kaydırmayı ve görünümünü StyleSimpleToolTip değiştirmeyi gösteren Background adlı bir ForegroundFontSizeFontWeight 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
sınıfı, ToolTipService araç ipucu görüntüleme sürelerini ayarlamak için aşağıdaki özellikleri sağlar: InitialShowDelay , ve BetweenShowDelayShowDuration .
Ve özelliklerini kullanarak bir görünmeden önce bir gecikme (genellikle kısa) ve ayrıca bir'in ne kadar InitialShowDelayShowDurationToolTip süreyle görünür ToolTip durumda kalarak kalarak belirtebilirsiniz. Daha fazla bilgi için, bkz. How to: Delay the Display of a ToolTip.
özelliği, fare işaretçisini aralarında hızlı bir şekilde taşısanız, farklı denetimler için araç ipucunın başlangıç gecikmesi olmadan BetweenShowDelay görünp görünmeyeceklerini belirler. özelliği hakkında daha fazla BetweenShowDelay bilgi için BetweenShowDelay
Aşağıdaki örnekte, bir araç ipucu için bu özelliklerin nasıl ayarlanları gösterir.
<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>