ToolTipService Klasse
Definition
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.
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
- Attribute
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. |