Freigeben über

Übersicht über Tooltipp

  • Artikel

Eine Tooltip ist ein kleines Popupfenster, das angezeigt wird, wenn ein Benutzer den Mauszeiger über ein Element hält, z. B. über eine Button. In diesem Thema werden die QuickInfos vorgestellt und erläutert, wie Sie QuickInfo-Inhalte erstellen und anpassen.

Was ist ein Tooltip?

Wenn ein Benutzer den Mauszeiger über ein Element bewegt, das eine QuickInfo enthält, wird ein Fenster mit QuickInfo-Inhalt (z. B. Textinhalt, der die Funktion eines Steuerelements beschreibt) für einen bestimmten Zeitraum angezeigt. Wenn der Benutzer den Mauszeiger weg vom Steuerelement verschiebt, wird das Fenster ausgeblendet, da der QuickInfo-Inhalt den Fokus nicht erhalten kann.

Der Inhalt einer QuickInfo kann eine oder mehrere Textzeilen, Bilder, Formen oder andere visuelle Inhalte enthalten. Sie definieren eine QuickInfo für ein Steuerelement, indem Sie eine der folgenden Eigenschaften auf den Inhalt der QuickInfo setzen.

Welche Eigenschaft Sie verwenden, hängt davon ab, ob das Steuerelement, das die QuickInfo definiert, von der FrameworkContentElement oder FrameworkElement Klasse erbt.

Erstellen einer QuickInfo

Das folgende Beispiel zeigt, wie Sie eine einfache QuickInfo erstellen, indem Sie die ToolTip-Eigenschaft für ein Button-Steuerelement auf eine Textzeichenfolge festlegen.

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

Sie können eine QuickInfo auch als ToolTip-Objekt definieren. Im folgenden Beispiel wird XAML verwendet, um ein ToolTip -Objekt als QuickInfo eines TextBox-Elements anzugeben. Beachten Sie, dass das Beispiel ToolTip festlegt, indem es die Eigenschaft FrameworkElement.ToolTip festlegt.

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

Im folgenden Beispiel wird Code verwendet, um ein ToolTip-Objekt zu generieren. Im Beispiel wird ein ToolTip (tt) erstellt und einem Buttonzugeordnet.

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)

Sie können auch QuickInfo-Inhalte erstellen, die nicht als ToolTip-Objekt definiert sind, indem der QuickInfo-Inhalt in ein Layoutelement wie ein DockPaneleingefügt wird. Das folgende Beispiel zeigt, wie die ToolTip-Eigenschaft eines TextBox auf Inhalte festgelegt wird, die in einem DockPanel-Steuerelement eingeschlossen sind.

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

Verwenden der Eigenschaften der ToolTip- und ToolTipService-Klassen

Sie können den Inhalt der QuickInfo anpassen, indem Sie visuelle Eigenschaften festlegen und Stile anwenden. Wenn Sie den QuickInfo-Inhalt als ToolTip-Objekt definieren, können Sie die visuellen Eigenschaften des ToolTip-Objekts festlegen. Andernfalls müssen Sie gleichwertige angefügte Eigenschaften für die ToolTipService-Klasse festlegen.

Ein Beispiel für das Festlegen von Eigenschaften, um die Position von QuickInfo-Inhalten mithilfe der Eigenschaften ToolTip und ToolTipService zu bestimmen, finden Sie unter Position einer QuickInfo.

Formatieren einer QuickInfo

Sie können eine ToolTip formatieren, indem Sie eine benutzerdefinierte Styledefinieren. Im folgenden Beispiel wird eine Style namens Simple definiert, die zeigt, wie die Positionierung des ToolTip versetzt und die Darstellung geändert wird, indem die Background, Foreground, FontSizeund FontWeightfestgelegt werden.

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

Verwenden der Eigenschaften für Zeitintervalle von ToolTipService

Die ToolTipService Klasse stellt die folgenden Eigenschaften bereit, mit denen Sie die QuickInfo-Anzeigezeiten festlegen können: InitialShowDelay, BetweenShowDelayund ShowDuration.

Verwenden Sie die Eigenschaften InitialShowDelay und ShowDuration, um eine Verzögerung anzugeben – in der Regel kurz –, bevor ein ToolTip erscheint, sowie die Dauer, für die ein ToolTip sichtbar bleibt. Weitere Informationen finden Sie unter So verzögern Sie die Anzeige eines ToolTips.

Die BetweenShowDelay-Eigenschaft bestimmt, ob QuickInfos für verschiedene Steuerelemente ohne anfängliche Verzögerung angezeigt werden, wenn Sie den Mauszeiger schnell dazwischen bewegen. Weitere Informationen zur BetweenShowDelay-Eigenschaft finden Sie unter Verwenden der BetweenShowDelay-Eigenschaft.

Das folgende Beispiel zeigt, wie Sie diese Eigenschaften für eine QuickInfo festlegen.

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

Siehe auch