TeachingTip Clase

Definición

Una sugerencia de enseñanza es un control flotante de notificación que se usa para proporcionar información contextualmente relevante. Admite contenido enriquecido (incluidos títulos, subtítulos, iconos, imágenes y texto) y se puede configurar para descarte explícito o claro.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
class TeachingTip : ContentControl
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class TeachingTip : ContentControl
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
public class TeachingTip : ContentControl
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class TeachingTip : ContentControl
Public Class TeachingTip
Inherits ContentControl
Herencia
TeachingTip
Atributos
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContractVersionAttribute

Ejemplos

Sugerencia

Para obtener más información, instrucciones de diseño y ejemplos de código, consulte Sugerencia de enseñanza.

La aplicación WinUI 2 Gallery incluye ejemplos interactivos de la mayoría de los controles, características y funcionalidades de WinUI 2. Obtenga la aplicación en Microsoft Store u obtenga el código fuente en GitHub.

Comentarios

Las sugerencias de enseñanza se suelen usar para informar, recordar y enseñar a los usuarios sobre características nuevas o importantes que podrían mejorar su experiencia.

Estilo de control y plantilla

Puede modificar el estilo predeterminado y controlTemplate para proporcionar al control una apariencia única. Para obtener información sobre cómo modificar el estilo y la plantilla de un control, consulta Estilos XAML. El estilo, la plantilla y los recursos predeterminados que definen la apariencia del control se incluyen en el generic.xaml archivo . Para fines de diseño, generic.xaml se instala con el paquete NuGet WinUI (Microsoft.UI.Xaml). De forma predeterminada, la ubicación es \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Los estilos y recursos de diferentes versiones de WinUI pueden tener valores diferentes.

XAML también incluye recursos que puedes usar para modificar los colores de un control en diferentes estados visuales sin modificar la plantilla de control. Se prefiere modificar estos recursos para establecer propiedades como Background y Foreground. Para obtener más información, consulta la sección Estilo ligero del artículo Estilos XAML .

Constructores

TeachingTip()

Inicializa una nueva instancia de la clase TeachingTip .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Propiedades

ActionButtonCommand

Obtiene o establece el comando que se va a invocar cuando se hace clic en el botón de acción.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

ActionButtonCommandParameter

Obtiene o establece el parámetro que se va a pasar al comando para el botón de acción.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

ActionButtonCommandParameterProperty

Identifica la propiedad de dependencia ActionButtonCommandParameter .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

ActionButtonCommandProperty

Identifica la propiedad de dependencia ActionButtonCommand .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

ActionButtonContent

Obtiene o establece el texto del botón de acción de la sugerencia de enseñanza.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

ActionButtonContentProperty

Identifica la propiedad de dependencia ActionButtonContent .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

ActionButtonStyle

Obtiene o establece el estilo que se va a aplicar al botón de acción.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

ActionButtonStyleProperty

Identifica la propiedad de dependencia ActionButtonStyle .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

CloseButtonCommand

Obtiene o establece el comando que se va a invocar cuando se hace clic en el botón Cerrar.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

CloseButtonCommandParameter

Obtiene o establece el parámetro que se va a pasar al comando para el botón cerrar.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

CloseButtonCommandParameterProperty

Identifica la propiedad de dependencia CloseButtonCommandParameter .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

CloseButtonCommandProperty

Identifica la propiedad de dependencia CloseButtonCommand .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

CloseButtonContent

Obtiene o establece el contenido del botón Cerrar de la sugerencia de enseñanza.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

CloseButtonContentProperty

Identifica la propiedad de dependencia CloseButtonContent .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

CloseButtonStyle

Obtiene o establece el estilo que se va a aplicar al botón cerrar de la sugerencia de enseñanza.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

CloseButtonStyleProperty

Identifica la propiedad de dependencia CloseButtonStyle .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

HeroContent

Contenido gráfico de borde a borde mostrado en el encabezado o pie de página de la sugerencia de enseñanza. Aparecerá enfrente de la cola en sugerencias de enseñanza dirigidas a menos que se establezca lo contrario.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

HeroContentPlacement

Colocación del contenido principal dentro de la sugerencia de enseñanza.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

HeroContentPlacementProperty

Identifica la propiedad de dependencia HeroContentPlacement .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

HeroContentProperty

Identifica la propiedad de dependencia HeroContent .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

IconSource

Obtiene o establece el contenido gráfico que se mostrará junto con el título y el subtítulo.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

IconSourceProperty

Identifica la propiedad de dependencia IconSource .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

IsLightDismissEnabled

Habilita la funcionalidad de cierre de luz para que una sugerencia de enseñanza se descarte cuando un usuario se desplace o interactúe con otros elementos de la aplicación.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

IsLightDismissEnabledProperty

Identifica la propiedad de dependencia IsLightDismissEnabled .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

IsOpen

Obtiene o establece un valor que indica si la sugerencia de enseñanza está abierta.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

IsOpenProperty

Identifica la propiedad de dependencia IsOpen .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

PlacementMargin

Agrega un margen entre una sugerencia de enseñanza dirigida y su destino o entre una sugerencia de enseñanza no dirigida y la raíz xaml.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

PlacementMarginProperty

Identifica la propiedad de dependencia PlacementMargin .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

PreferredPlacement

Selección de ubicación preferida que se usará para la sugerencia de enseñanza. Si no hay suficiente espacio para mostrar en la ubicación preferida, se elegirá automáticamente una nueva ubicación. La colocación es relativa a su destino si Target no es NULL o a la ventana primaria de la sugerencia de enseñanza si Target es NULL.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

PreferredPlacementProperty

Identifica la propiedad de dependencia PreferredPlacement .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

ShouldConstrainToRootBounds

Obtiene o establece un valor que indica si la sugerencia de enseñanza restringirá a los límites de su raíz xaml.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

ShouldConstrainToRootBoundsProperty

Identifica la propiedad de dependencia ShouldConstrainToRootBounds .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Subtitle

Obtiene o establece el subtítulo de la sugerencia de enseñanza.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

SubtitleProperty

Identifica la propiedad de dependencia Subtitle .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

TailVisibility

Alterna el colapso de la cola de una propina de enseñanza. Se puede usar para invalidar el comportamiento automático para hacer que una cola sea visible en una sugerencia de enseñanza no dirigida y ocultarla en una sugerencia de enseñanza dirigida.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

TailVisibilityProperty

Identifica la propiedad de dependencia TailVisibility .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Target

Establece el destino de una sugerencia de enseñanza para colocarse en relación con y apuntar con su cola.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

TargetProperty

Identifica la propiedad de dependencia Target .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

TemplateSettings

Proporciona valores calculados a los que se puede hacer referencia como orígenes TemplatedParent al definir plantillas para una clase TeachingTip. No está pensado para uso general.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

TemplateSettingsProperty

Identifica la propiedad de dependencia TemplateSettings .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Title

Obtiene o establece el título de la sugerencia de enseñanza.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

TitleProperty

Identifica la propiedad de dependencia Title .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Eventos

ActionButtonClick

Se produce después de hacer clic en el botón de acción.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

CloseButtonClick

Se produce después de hacer clic en el botón Cerrar.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Closed

Se produce después de cerrar la sugerencia.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Closing

Se produce justo antes de que la propina comience a cerrarse.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Se aplica a

Consulte también