ToolTipService Klasse

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml.Controls
Bearbeiten

Stellt einen Dienst dar, der statische Methoden zum Anzeigen einer QuickInfo bereitstellt.

public ref class ToolTipService sealed
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ToolTipService final
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ToolTipService
Public NotInheritable Class ToolTipService
Vererbung
Object Platform::Object IInspectable ToolTipService
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Beispiele

Im folgenden Codebeispiel werden die Platzierungsmodi für eine QuickInfo veranschaulicht.

<StackPanel Margin="120" >
    <TextBlock Text="ToolTip Control"/>
    <TextBlock Text="Hover over an item to see its ToolTip: " Margin="0,10"/>
    <ListBox Width="100" HorizontalAlignment="Left">
        <ListBoxItem Content="Left" 
            ToolTipService.ToolTip="ToolTip to the left." 
            ToolTipService.Placement="Left" />
        <ListBoxItem Content="Right" 
            ToolTipService.ToolTip="ToolTip to the right." 
            ToolTipService.Placement="Right" />
        <ListBoxItem Content="Top" 
            ToolTipService.ToolTip="ToolTip at the top." 
            ToolTipService.Placement="Top" />
        <ListBoxItem Content="Bottom" 
            ToolTipService.ToolTip="ToolTip at the bottom." 
            ToolTipService.Placement="Bottom"/>
        <ListBoxItem Content="Mouse" 
            ToolTipService.ToolTip="ToolTip based on the cursor position." 
            ToolTipService.Placement="Mouse"/>
    </ListBox>
</StackPanel>

Hinweise

Eine QuickInfo muss einem anderen Benutzeroberflächenelement zugewiesen werden, das ihr Eigentümer ist. Verwenden Sie in Extensible Application Markup Language (XAML) die angefügte Eigenschaft ToolTipService.ToolTip, um die QuickInfo einem Besitzer zuzuweisen. Verwenden Sie im Code die ToolTipService.SetToolTip-Methode , um die QuickInfo einem Besitzer zuzuweisen.

Platzierung

Standardmäßig wird eine QuickInfo zentriert über dem Zeiger angezeigt. Die Platzierung wird nicht durch das App-Fenster eingeschränkt, sodass die QuickInfo teilweise oder vollständig außerhalb der App-Fenstergrenzen angezeigt wird.

Wenn eine QuickInfo den Inhalt verschleiert, auf den sie sich bezieht, können Sie die Platzierung anpassen. Verwenden Sie die angefügte ToolTipService.Placement-Eigenschaft, um die QuickInfo oberhalb, unterhalb, links oder rechts des Zeigers zu platzieren.

Wenn kein explizites PlacementTarget vorhanden ist, ist das Platzierungsziel für eine QuickInfo das Element, das einen Wert für den angefügten Eigenschaftswert tooltipService.ToolTip angibt. Jeder Platzierungswert (entweder als angefügte Eigenschaft oder als Attribut für ein explizites ToolTip-Element) gilt für dieses Ziel.

XAML angefügte Eigenschaften

ToolTipService ist die Hostdienstklasse für mehrere xaml angefügte Eigenschaften.

Um den XAML-Prozessorzugriff auf die angefügten Eigenschaften zu unterstützen und äquivalente Get - und Set-Vorgänge für Code verfügbar zu machen, verfügt jede angefügte XAML-Eigenschaft über ein Paar von Get- und Set-Accessormethoden. Eine andere Möglichkeit zum Abrufen oder Festlegen des Werts im Code besteht darin, das Abhängigkeitseigenschaftssystem zu verwenden, entweder GetValue oder SetValue aufzurufen und das Bezeichnerfeld als Abhängigkeitseigenschaftsbezeichner zu übergeben.

Angefügte Eigenschaft BESCHREIBUNG
Platzierung Ruft einen Wert ab, der angibt, wie eine QuickInfo im Verhältnis zum Platzierungsziel positioniert ist, oder legt diesen fest.
Placementtarget Ruft das Objekt ab, zu dem eine QuickInfo positioniert ist, oder legt es fest.
ToolTip Ruft den Objekt- oder Zeichenfolgeninhalt der QuickInfo eines Elements ab oder legt diese fest.

Eigenschaften

PlacementProperty

Identifiziert die angefügte XAML-Eigenschaft ToolTipService.Placement .
PlacementTargetProperty

Gibt die angefügte XAML-Eigenschaft ToolTipService.PlacementTarget an.
ToolTipProperty

Gibt die angefügte XAML-Eigenschaft ToolTipService.Tooltip an.

Angefügte Eigenschaften

Placement

Ruft einen Wert ab, der angibt, wie eine QuickInfo im Verhältnis zum Platzierungsziel positioniert ist, oder legt diesen fest.
PlacementTarget

Ruft das Objekt ab, zu dem eine QuickInfo positioniert ist, oder legt es fest.
ToolTip

Ruft den Objekt- oder Zeichenfolgeninhalt der QuickInfo eines Elements ab oder legt diese fest.

Methoden

GetPlacement(DependencyObject)

Ruft den angefügten XAML-Eigenschaftswert von ToolTipService.Placement für das angegebene Zielelement ab.
GetPlacementTarget(DependencyObject)

Ruft den angefügten XAML-Eigenschaftswert von ToolTipService.PlacementTarget für das angegebene Zielelement ab.
GetToolTip(DependencyObject)

Ruft den Wert der angefügten XAML-Eigenschaft ToolTipService.ToolTip für ein Objekt ab.
SetPlacement(DependencyObject, PlacementMode)

Legt den angefügten XAML-Eigenschaftswert von ToolTipService.Placement für das angegebene Zielelement fest.
SetPlacementTarget(DependencyObject, UIElement)

Legt den Wert der angefügten XAML-Eigenschaft toolTipService.PlacementTarget für das angegebene Zielelement fest.
SetToolTip(DependencyObject, Object)

Legt den Wert der angefügten XAML-Eigenschaft ToolTipService.ToolTip fest.

Gilt für:

Weitere Informationen