TeachingTip Classe

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Uma dica de ensino é um submenu de notificação usado para fornecer informações contextualmente relevantes. Ele dá suporte a conteúdo avançado (incluindo títulos, legendas, ícones, imagens e texto) e pode ser configurado para explicita ou light dismiss.

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

/// [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.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

Herança

ContentControl

TeachingTip

Atributos

Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

Exemplos

Dica

Para obter mais informações, diretrizes de design e exemplos de código, consulte Dica de ensino.

Abra o aplicativo Galeria do WinUI 2 e consulte TeachingTip em ação.

Os aplicativos da Galeria do WinUI 2 incluem exemplos interativos da maioria dos controles, recursos e funcionalidades do WinUI 2. Obtenha o aplicativo na Microsoft Store ou o código-fonte no GitHub.

Comentários

Dicas de ensino geralmente são usadas para informar, lembrar e ensinar os usuários sobre recursos novos ou importantes que podem aprimorar sua experiência.

Estilo e modelo de controle

Você pode modificar o Estilo e ControlTemplate padrão para dar ao controle uma aparência exclusiva. Para obter informações sobre como modificar o estilo e o modelo de um controle, consulte Estilos XAML. O estilo, o modelo e os recursos padrão que definem a aparência do controle são incluídos no generic.xaml arquivo. Para fins de design, generic.xaml é instalado com o pacote NuGet WinUI (Microsoft.UI.Xaml). Por padrão, esse local é \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Estilos e recursos de diferentes versões do WinUI podem ter valores diferentes.

O XAML também inclui recursos que você pode usar para modificar as cores de um controle em diferentes estados visuais sem modificar o modelo de controle. É preferível modificar esses recursos para definir propriedades como Plano de Fundo e Primeiro Plano. Para obter mais informações, consulte a seção Estilo leve do artigo Estilos XAML .

Construtores

TeachingTip()

Inicializa uma nova instância da classe TeachingTip . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Propriedades

ActionButtonCommand	Obtém ou define o comando a ser invocado quando o botão de ação é clicado. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ActionButtonCommandParameter	Obtém ou define o parâmetro a ser passado para o comando do botão de ação. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ActionButtonCommandParameterProperty	Identifica a propriedade de dependência ActionButtonCommandParameter . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ActionButtonCommandProperty	Identifica a propriedade de dependência ActionButtonCommand . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ActionButtonContent	Obtém ou define o texto do botão de ação da dica de ensino. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ActionButtonContentProperty	Identifica a propriedade de dependência ActionButtonContent . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ActionButtonStyle	Obtém ou define o estilo a ser aplicado ao botão de ação. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ActionButtonStyleProperty	Identifica a propriedade de dependência ActionButtonStyle . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
CloseButtonCommand	Obtém ou define o comando a ser invocado quando o botão fechar é clicado. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
CloseButtonCommandParameter	Obtém ou define o parâmetro a ser passado para o comando do botão fechar. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
CloseButtonCommandParameterProperty	Identifica a propriedade de dependência CloseButtonCommandParameter . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
CloseButtonCommandProperty	Identifica a propriedade de dependência CloseButtonCommand . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
CloseButtonContent	Obtém ou define o conteúdo do botão fechar da dica de ensino. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
CloseButtonContentProperty	Identifica a propriedade de dependência CloseButtonContent . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
CloseButtonStyle	Obtém ou define o Botão de fechamento Estilo a ser aplicado à dica de ensino. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
CloseButtonStyleProperty	Identifica a propriedade de dependência CloseButtonStyle . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
HeroContent	Conteúdo gráfico borda a borda exibido no cabeçalho ou rodapé da dica de ensino. Aparecerá em frente à cauda em dicas de ensino direcionadas, a menos que seja definido de outra forma. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
HeroContentPlacement	Posicionamento do conteúdo hero dentro da dica de ensino. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
HeroContentPlacementProperty	Identifica a propriedade de dependência HeroContentPlacement . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
HeroContentProperty	Identifica a propriedade de dependência HeroContent . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IconSource	Obtém ou define o conteúdo gráfico a ser exibido junto com o título e o subtítulo. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IconSourceProperty	Identifica a propriedade de dependência IconSource . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsLightDismissEnabled	Habilita a funcionalidade light-dismiss para que uma dica de ensino seja ignorada quando um usuário rolar ou interagir com outros elementos do aplicativo. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsLightDismissEnabledProperty	Identifica a propriedade de dependência IsLightDismissEnabled . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsOpen	Obtém ou define um valor que indica se a dica de ensino está aberta. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsOpenProperty	Identifica a propriedade de dependência IsOpen . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
PlacementMargin	Adiciona uma margem entre uma dica de ensino direcionada e seu destino ou entre uma dica de ensino não direcionada e a raiz xaml. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
PlacementMarginProperty	Identifica a propriedade de dependência PlacementMargin . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
PreferredPlacement	Posicionamento preferencial a ser usado para a dica de ensino. Se não houver espaço suficiente para mostrar no posicionamento preferencial, um novo posicionamento será escolhido automaticamente. O posicionamento será relativo ao destino se Target não for nulo ou à janela pai da dica de ensino se Target for nulo. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
PreferredPlacementProperty	Identifica a propriedade de dependência PreferredPlacement . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ShouldConstrainToRootBounds	Obtém ou define um valor que indica se a dica de ensino restringirá aos limites de sua raiz xaml. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ShouldConstrainToRootBoundsProperty	Identifica a propriedade de dependência ShouldConstrainToRootBounds . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
Subtitle	Obtém ou define o subtítulo da dica de ensino. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SubtitleProperty	Identifica a propriedade de dependência Subtítulo . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TailVisibility	Alterna o colapso da cauda de uma dica de ensino. Pode ser usado para substituir o comportamento automático para tornar uma cauda visível em uma dica de ensino não direcionada e ocultada em uma dica de ensino direcionada. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TailVisibilityProperty	Identifica a propriedade de dependência TailVisibility . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
Target	Define o destino de uma dica de ensino para se posicionar em relação a e apontar com sua cauda. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TargetProperty	Identifica a propriedade Dependência de destino. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TemplateSettings	Fornece valores calculados que podem ser referenciados como fontes TemplatedParent ao definir modelos para uma Dica de Ensino. Não destinado ao uso geral. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TemplateSettingsProperty	Identifica a propriedade de dependência TemplateSettings . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
Title	Obtém ou define o título da dica de ensino. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TitleProperty	Identifica a propriedade de dependência Title . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Eventos

ActionButtonClick	Ocorre depois que o botão de ação é clicado. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
CloseButtonClick	Ocorre depois que o botão fechar é clicado. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
Closed	Ocorre depois que a dica é fechada. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
Closing	Ocorre logo antes da dica começar a ser fechada. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Confira também

• TeachingTipClosedEventArgs
• TeachingTipCloseReason
• TeachingTipClosingEventArgs
• TeachingTipHeroContentPlacementMode
• TeachingTipPlacementMode
• TeachingTipTailVisibility
• TeachingTipTemplateSettings
• Visão geral da dica de ensino