ToolTipService Clase

  • Referencia

Definición

Espacio de nombres:
Microsoft.UI.Xaml.Controls
Editar

Representa un servicio que proporciona métodos estáticos para mostrar una información sobre herramientas.

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
Herencia
Object Platform::Object IInspectable ToolTipService
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Ejemplos

En el ejemplo de código siguiente se muestran los modos de selección de ubicación de una información sobre herramientas.

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

Comentarios

Se debe asignar una información sobre herramientas a otro elemento de interfaz de usuario que sea su propietario. En Lenguaje de marcado de aplicaciones extensibles (XAML), use la propiedad adjunta ToolTipService.ToolTip para asignar la información sobre herramientas a un propietario. En el código, use el método ToolTipService.SetToolTip para asignar la información sobre herramientas a un propietario.

Selección de ubicación

De forma predeterminada, se muestra una información sobre herramientas centrada encima del puntero. La selección de ubicación no está restringida por la ventana de la aplicación, por lo que la información sobre herramientas puede mostrarse parcialmente o completamente fuera de los límites de la ventana de la aplicación.

Si una información sobre herramientas oculta el contenido al que hace referencia, puede ajustar su ubicación. Utilice la propiedad adjunta ToolTipService.Placement para colocar la información sobre herramientas encima, debajo, izquierda o derecha del puntero.

Si no hay ningún objeto PlacementTarget explícito, el destino de selección de ubicación de una información sobre herramientas es el elemento que especifica un valor para su valor de propiedad adjunta TooltipService.ToolTip. Cualquier valor placement (ya sea como una propiedad adjunta o como un atributo en un elemento ToolTip explícito) se aplica a ese destino.

Propiedades adjuntas xaml

ToolTipService es la clase de servicio host para varias propiedades adjuntas xaml.

Para admitir el acceso del procesador XAML a las propiedades adjuntas, y también para exponer operaciones de obtención y establecimiento equivalentes en código, cada propiedad adjunta XAML tiene un par de métodos de descriptor de acceso Get y Set. Otra manera de obtener o establecer el valor en el código es usar el sistema de propiedades de dependencia, llamar a GetValue o SetValue y pasar el campo identificador como identificador de propiedad de dependencia.

Propiedad adjunta Descripción
Selección de ubicación Obtiene o establece un valor que indica cómo se coloca una información sobre herramientas en relación con el destino de selección de ubicación.
PlacementTarget Obtiene o establece el objeto relativo al que se coloca una información sobre herramientas.
Información sobre herramientas Obtiene o establece el contenido de objeto o cadena de la información sobre herramientas de un elemento.

Propiedades

PlacementProperty

Identifica la propiedad adjunta XAML ToolTipService.Placement .
PlacementTargetProperty

Identifica la propiedad adjunta XAML ToolTipService.PlacementTarget .
ToolTipProperty

Identifica la propiedad adjunta XAML ToolTipService.Tooltip .

Propiedades adjuntas

Placement

Obtiene o establece un valor que indica cómo se coloca una información sobre herramientas en relación con el destino de selección de ubicación.
PlacementTarget

Obtiene o establece el objeto relativo al que se coloca una información sobre herramientas.
ToolTip

Obtiene o establece el contenido de objeto o cadena de la información sobre herramientas de un elemento.

Métodos

GetPlacement(DependencyObject)

Obtiene el valor de propiedad adjunta XAML ToolTipService.Placement para el elemento de destino especificado.
GetPlacementTarget(DependencyObject)

Obtiene el valor de propiedad adjunta XAML ToolTipService.PlacementTarget para el elemento de destino especificado.
GetToolTip(DependencyObject)

Obtiene el valor de la propiedad adjunta XAML ToolTipService.ToolTip para un objeto .
SetPlacement(DependencyObject, PlacementMode)

Establece el valor de propiedad adjunta XAML ToolTipService.Placement para el elemento de destino especificado.
SetPlacementTarget(DependencyObject, UIElement)

Establece el valor de la propiedad adjunta XAML ToolTipService.PlacementTarget para el elemento de destino especificado.
SetToolTip(DependencyObject, Object)

Establece el valor de la propiedad adjunta XAML ToolTipService.ToolTip .

Se aplica a

Consulte también