Freigeben über

QuickInfo-Übersicht

Eine QuickInfo ist ein kleines Popupfenster, das angezeigt wird, wenn ein Benutzer den Mauszeiger über ein Element, z.B. einen Button bewegt. 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 für den QuickInfo-Inhalt verwenden.

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

Erstellen eines Tooltips

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

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

Sie können auch ein Tooltip als ein ToolTip Objekt definieren. Im folgenden Beispiel wird XAML verwendet, um ein ToolTip-Objekt als QuickInfo eines TextBox-Elements festzulegen. Beachten Sie, dass das Beispiel die ToolTip Eigenschaft durch Festlegen der FrameworkElement.ToolTip Eigenschaft angibt.

<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. Das Beispiel erstellt ein ToolTip (tt) und ordnet es einem Button zu.

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 Sie den QuickInfo-Inhalt in ein Layoutelement einschließen, z. B. ein DockPanel. 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 Tooltip-Inhalte 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, wie Sie Eigenschaften festlegen, um die Position von QuickInfo-Inhalten mithilfe der Eigenschaften ToolTip und ToolTipService anzugeben, finden Sie unter Position einer QuickInfo.

Formatieren einer QuickInfo

Sie können einen Stil für ToolTip festlegen, indem Sie eine benutzerdefinierte Style-Vorlage definieren. Im folgenden Beispiel wird ein Style definiert, der Simple genannt wird und zeigt, wie die Platzierung des ToolTip versetzt und sein Erscheinungsbild geändert werden kann, indem die Background, Foreground, FontSize, und FontWeight eingestellt 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 Zeitintervalleigenschaften von ToolTipService

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

Verwenden Sie die InitialShowDelay- und ShowDuration-Eigenschaften, um eine Verzögerung anzugeben, die in der Regel kurz ist, bevor ein ToolTip erscheint, und auch um festzulegen, wie lange ein ToolTip sichtbar bleibt. Weitere Informationen finden Sie unter Vorgehensweise: Anzeigen eines Tooltips verzögern.

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