ToolTipService Clase

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 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 la interfaz de usuario que actúe como su propietario. En Lenguaje de marcado extensible de aplicaciones (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.

Colocación

De forma predeterminada , se muestra información sobre herramientas centrada encima del puntero. La 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 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 de ubicación (ya sea como una propiedad adjunta o como atributo en un elemento de información sobre herramientas 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 equivalentes de obtención y establecimiento del 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 de identificador como identificador de propiedad de dependencia.

Propiedad adjunta Description
Colocació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.
ToolTip Obtiene o establece el objeto o el contenido de cadena de la información sobre herramientas de un elemento.

Propiedades

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

Nombre Description
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 objeto o el contenido de cadena de la información sobre herramientas de un elemento.

Métodos

Nombre Description
GetPlacement(DependencyObject)

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

Obtiene el valor de la 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 la 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