Compartir a través de

ToolTipService Clase

  • Referencia

Definición

Espacio de nombres:
Windows.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(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
Herencia
Object Platform::Object IInspectable ToolTipService
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

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 Extensible Application Markup Language (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 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 anterior, 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 placement (ya sea como una propiedad adjunta o como atributo en un elemento ToolTip explícito) se aplica a ese destino.

Notas de las versiones anteriores

La información sobre herramientas de Windows 8.x solo está pensada para su uso en Windows. El tipo de información sobre herramientas está disponible en Windows Phone proyectos para la compatibilidad con plantillas de proyecto universales, pero la información sobre herramientas no se muestra en la interfaz de usuario de Windows Phone.

La información sobre herramientas solo se muestra dentro de los límites de la ventana de la aplicación. Es posible que la colocación se ajuste para permanecer dentro de esos límites.

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 el 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 Descripción
Selección de ubicación Obtiene o establece un valor que indica cómo se coloca un ToolTip objeto en relación con el destino de selección de ubicación.
PlacementTarget Obtiene o establece el objeto en relación con el que se coloca .ToolTip
ToolTip Obtiene o establece el objeto o el contenido de cadena de un elemento ToolTip.

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 en relación con el 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 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