ToolTipService Klasse

  • Referenz

Definition

Namespace:
Windows.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(Windows.Foundation.UniversalApiContract, 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(Windows.Foundation.UniversalApiContract), 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

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

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 verdeckt, auf den sie sich bezieht, können Sie die Platzierung anpassen. Verwenden Sie die angefügte Eigenschaft ToolTipService.Placement, um die QuickInfo oben, unterhalb, links oder rechts neben dem Zeiger 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 TooltipService.ToolTip-Eigenschaftswert angibt. Jeder Placement-Wert (entweder als angefügte Eigenschaft oder als Attribut für ein explizites QuickInfo-Element) gilt für dieses Ziel.

Hinweise zu früheren Versionen

Windows 8.x-QuickInfo ist nur für die Verwendung in Windows vorgesehen. Der QuickInfo-Typ ist aus Gründen der Kompatibilität mit universellen Projektvorlagen in Windows Phone Projekten verfügbar, die QuickInfo wird jedoch nicht auf der benutzeroberfläche des Windows Phone angezeigt.

QuickInfo wird nur innerhalb der Grenzen des App-Fensters angezeigt. Die Platzierung kann angepasst werden, um innerhalb dieser Grenzen zu bleiben.

Angefügte XAML-Eigenschaften

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

Um den XAML-Prozessorzugriff auf die angefügten Eigenschaften zu unterstützen und auch ä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 weitere Möglichkeit zum Abrufen oder Festlegen des Werts im Code besteht darin, das Abhängigkeitseigenschaftensystem 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 ein ToolTip im Verhältnis zum Platzierungsziel positioniert ist, oder legt diesen fest.
Placementtarget Ruft das Objekt relativ ab, zu dem ein ToolTip positioniert ist, oder legt es fest.
ToolTip Ruft den Objekt- oder Zeichenfolgeninhalt des -Elements ab oder legt diese ToolTipfest.

Eigenschaften

PlacementProperty

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

Identifiziert die angefügte XAML-Eigenschaft ToolTipService.PlacementTarget .
ToolTipProperty

Identifiziert die angefügte Xaml-Eigenschaft ToolTipService.ToolTip .

Angefügte Eigenschaften

Placement

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

Ruft das Objekt relativ 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 für das angegebene Zielelement ab.
GetPlacementTarget(DependencyObject)

Ruft den angefügten XAML-Eigenschaftswert 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 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