ToolTipService Klasse

Referenz

Definition

Namespace:: Windows.UI.Xaml.Controls

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 `ToolTip`fest.

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:

Freigeben über