Übersicht über die QuickInfoToolTip Overview

Eine QuickInfo ist ein kleines Popupfenster, das angezeigt wird, wenn ein Benutzer den Mauszeiger auf ein Element, beispielsweise über hält eine Button.A tooltip is a small pop-up window that appears when a user pauses the mouse pointer over an element, such as over a Button. In diesem Thema wird die QuickInfo vorgestellt und das Erstellen und Anpassen von QuickInfo-Inhalten erläutert.This topic introduces the tooltip and discusses how to create and customize tooltip content.

Was ist eine QuickInfo?What Is a Tooltip?

Wenn ein Benutzer den Mauszeiger über ein Element mit einer QuickInfo bewegt, wird für einen festgelegten Zeitraum ein Fenster mit dem Inhalt dieser QuickInfo angezeigt. Dabei kann es sich z.B. um Text handeln, der die Funktion eines Steuerelements beschreibt.When a user moves the mouse pointer over an element that has a tooltip, a window that contains tooltip content (for example, text content that describes the function of a control) appears for a specified amount of time. Wenn der Benutzer den Mauszeiger vom Steuerelement wegbewegt, wird das Fenster nicht mehr angezeigt, da der Inhalt der QuickInfo keinen Fokus erhalten kann.If the user moves the mouse pointer away from the control, the window disappears because the tooltip content cannot receive focus.

Der Inhalt einer QuickInfo kann eine oder mehrere Zeilen Text, Bilder, Formen oder andere visuelle Inhalte enthalten.The content of a tooltip can contain one or more lines of text, images, shapes, or other visual content. Um eine QuickInfo für ein Steuerelement zu definieren, legen Sie für deren Inhalt eine der folgenden Eigenschaften fest.You define a tooltip for a control by setting one of the following properties to the tooltip content.

Die Eigenschaft, die Sie verwenden, hängt davon ab, ob das Steuerelement, das die QuickInfo definiert, erbt die FrameworkContentElement oder FrameworkElement Klasse.Which property you use depends on whether the control that defines the tooltip inherits from the FrameworkContentElement or FrameworkElement class.

Erstellen einer QuickInfoCreating a ToolTip

Das folgende Beispiel zeigt, wie Sie eine einfache QuickInfo erstellen, durch Festlegen der ToolTip -Eigenschaft für eine Button Steuerelement auf eine Zeichenfolge.The following example shows how to create a simple tooltip by setting the ToolTip property for a Button control to a text string.

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

Sie können auch eine QuickInfo als definieren eine ToolTip Objekt.You can also define a tooltip as a ToolTip object. Im folgenden Beispiel wird XAMLXAML an eine ToolTip Objekt als QuickInfo für ein TextBox Element.The following example uses XAMLXAML to specify a ToolTip object as the tooltip of a TextBox element. Beachten Sie, die im Beispiel wird die ToolTip durch Festlegen der FrameworkElement.ToolTip Eigenschaft.Note that the example specifies the ToolTip by setting the FrameworkElement.ToolTip property.

<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 der Code zum Generieren einer ToolTip Objekt.The following example uses code to generate a ToolTip object. Das Beispiel erstellt eine ToolTip (tt) und ordnet ihn einem Button.The example creates a ToolTip (tt) and associates it with a Button.

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, die als nicht definiert ist erstellen eine ToolTip Objekt schließen Sie den QuickInfo-Inhalt in ein Layoutelement, z. B. eine DockPanel.You can also create tooltip content that is not defined as a ToolTip object by enclosing the tooltip content in a layout element, such as a DockPanel. Das folgende Beispiel zeigt, wie Sie festlegen der ToolTip Eigenschaft eine TextBox zu Inhalt, der in eingeschlossen ist eine DockPanel Steuerelement.The following example shows how to set the ToolTip property of a TextBox to content that is enclosed in a DockPanel control.

<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 Klassen ToolTip und ToolTipServiceUsing the Properties of the ToolTip and ToolTipService Classes

Sie können den Inhalt einer QuickInfo anpassen, indem Sie Eigenschaften für das Erscheinungsbild festlegen und Stile anwenden.You can customize tooltip content by setting visual properties and applying styles. Wenn Sie den QuickInfo-Inhalt als definieren eine ToolTip Objekt ist, können Sie die visuellen Eigenschaften des Festlegen der ToolTip Objekt.If you define the tooltip content as a ToolTip object, you can set the visual properties of the ToolTip object. Andernfalls müssen Sie entsprechende angefügte Eigenschaften festlegen, auf die ToolTipService Klasse.Otherwise, you must set equivalent attached properties on the ToolTipService class.

Ein Beispiel zum Festlegen von Eigenschaften, um die Position der QuickInfo-Inhalte mithilfe von angeben der ToolTip und ToolTipService Eigenschaften finden Sie Positionieren einer QuickInfo.For an example of how to set properties in order to specify the position of tooltip content by using the ToolTip and ToolTipService properties, see Position a ToolTip.

Formatieren einer QuickInfoStyling a ToolTip

Sie können Formatieren einer ToolTip durch Definieren eines benutzerdefinierten Style.You can style a ToolTip by defining a custom Style. Das folgende Beispiel definiert eine Style namens Simple , die zeigt, wie die Platzierung der offset der ToolTip , und ändern Sie seine Darstellung durch Festlegen der Background, Foreground, FontSize, und FontWeight.The following example defines a Style called Simple that shows how to offset the placement of the ToolTip and change its appearance by setting the Background, Foreground, FontSize, and FontWeight.

<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 von ToolTipService für ZeitintervalleUsing the Time Interval Properties of ToolTipService

Die ToolTipService -Klasse bietet die folgenden Eigenschaften für die Sie festlegen, QuickInfo anzeigen: InitialShowDelay, BetweenShowDelay, und ShowDuration.The ToolTipService class provides the following properties for you to set tooltip display times: InitialShowDelay, BetweenShowDelay, and ShowDuration.

Verwenden der InitialShowDelay und ShowDuration Eigenschaften an eine Verzögerung in der Regel eine kurze, vor einer ToolTip angezeigt wird und auch angeben, wie lange eine ToolTip sichtbar bleibt.Use the InitialShowDelay and ShowDuration properties to specify a delay, typically brief, before a ToolTip appears and also to specify how long a ToolTip remains visible. Weitere Informationen finden Sie unter Vorgehensweise: Verzögern der Anzeige einer QuickInfo.For more information, see How to: Delay the Display of a ToolTip.

Die BetweenShowDelay Eigenschaft bestimmt, ob QuickInfos für andere Steuerelemente ohne Verzögerung angezeigt werden, wenn Sie den Mauszeiger Maus schnell zwischen diesen bewegen.The BetweenShowDelay property determines if tooltips for different controls appear without an initial delay when you move the mouse pointer quickly between them. Weitere Informationen zu den BetweenShowDelay -Eigenschaft finden Sie unter verwenden der BetweenShowDelay-Eigenschaft.For more information about the BetweenShowDelay property, see Use the BetweenShowDelay Property.

Das nachstehende Beispiel zeigt, wie Sie diese Eigenschaften für eine QuickInfo festlegen.The following example shows how to set these properties for a tooltip.

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