Dela via

Verktygstipsöversikt

Ett verktygstips är ett litet popup-fönster som visas när en användare håller muspekaren stilla över ett element, till exempel över en Button. Det här avsnittet beskriver knappbeskrivningen och beskriver hur du skapar och anpassar knappbeskrivningsinnehåll.

Vad är en knappbeskrivning

När en användare flyttar muspekaren över ett element som har en knappbeskrivning visas ett fönster som innehåller knappbeskrivningsinnehåll (till exempel textinnehåll som beskriver en kontrolls funktion) under en angiven tidsperiod. Om användaren flyttar muspekaren bort från kontrollen försvinner fönstret eftersom knappbeskrivningsinnehållet inte kan ta emot fokus.

Innehållet i en knappbeskrivning kan innehålla en eller flera rader med text, bilder, former eller annat visuellt innehåll. Du definierar en knappbeskrivning för en kontroll genom att ange någon av följande egenskaper till knappbeskrivningsinnehållet.

Vilken egenskap som används beror på om kontrollen som definierar knappbeskrivningen ärvs från klassen FrameworkContentElement eller FrameworkElement.

Skapa ett verktygstips

I följande exempel visas hur du skapar ett enkelt verktygstips genom att ange egenskapen ToolTip för en Button-kontroll till en textsträng.

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

Du kan också definiera en knappbeskrivning som ett objekt av typen ToolTip. I följande exempel används XAML för att ange ett ToolTip objekt som knappbeskrivning för ett TextBox element. Observera att exemplet anger ToolTip genom att ange egenskapen FrameworkElement.ToolTip.

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

I följande exempel används kod för att generera ett ToolTip objekt. Exemplet skapar en ToolTip (tt) och associerar den med en 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)

Du kan också skapa knappbeskrivningsinnehåll som inte definieras som ett ToolTip objekt genom att omsluta knappbeskrivningsinnehållet i ett layoutelement, till exempel en DockPanel. I följande exempel visas hur du anger egenskapen ToolTip för en TextBox till innehåll som omges av en DockPanel kontroll.

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

Använda egenskaperna för toolTip- och ToolTipService-klasserna

Du kan anpassa knappbeskrivningsinnehåll genom att ange visuella egenskaper och tillämpa formatmallar. Om du definierar innehållet i verktygstipset som ett ToolTip-objekt kan du ange de visuella egenskaperna för ToolTip-objektet. Annars måste du ange motsvarande anslutna egenskaper för klassen ToolTipService.

Ett exempel på hur du anger egenskaper för att ange positionen för knappbeskrivningsinnehåll med hjälp av egenskaperna ToolTip och ToolTipService finns i Placera en knappbeskrivning.

Formatera en knappbeskrivning

Du kan formatera en ToolTip genom att definiera en anpassad Style. I följande exempel definieras en Style med namnet Simple som visar hur du förskjuter placeringen av ToolTip och ändrar dess utseende genom att ange Background, Foreground, FontSizeoch 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>

Använda tidsintervallegenskaperna för ToolTipService

Klassen ToolTipService tillhandahåller följande egenskaper för att ange visningstider för verktygstips: InitialShowDelay, BetweenShowDelayoch ShowDuration.

Använd egenskaperna InitialShowDelay och ShowDuration för att ange en fördröjning, vanligtvis kort, innan en ToolTip visas och för att ange hur länge en ToolTip förblir synlig. Mer information finns i Så här: Fördröj visningen av ett verktygstips.

Egenskapen BetweenShowDelay avgör om knappbeskrivningar för olika kontroller visas utan en inledande fördröjning när du flyttar muspekaren snabbt mellan dem. För mer information om egenskapen BetweenShowDelay, se Använd egenskapen BetweenShowDelay.

I följande exempel visas hur du anger dessa egenskaper för ett verktygstips.

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

Se även

  • Last updated on