Compartilhar via


Exemplo de rótulo de ajuda do painel de ações

Observação:

Este exemplo é executado somente no Microsoft Office Excel 2007 e o Microsoft Office Word 2007.

Este exemplo inclui um Controlarar que fornece Dinâmico, ajuda Contextoual em um painel de ações para um documento ou planilha que contém regiões mapeadas em XML.O Controlarar automaticamente se associa o esquema XML e usa o esquema anotações como o texto de ajuda.Quando um usuário coloca o ponto de inserção em uma região que contém um nó XML, o Controlarar exibe o texto de nome e a anotação de região associada.O desenvolvedor pode usar propriedades de ’s o Controlarar para indicar o que acontece quando uma região não tem texto da anotação.

O Controlarar possui quatro propriedades que você pode definir para determinar o que o Controlarar exibe se não houver nenhum texto da anotação.Essas propriedades Aparecerr na janela de Propriedades de , em uma seção chamada de conteúdo de .

  • UseAncestorAnnotation
    Especifica se o Controlarar deve exibir o texto da anotação da região ancestral mais próximo se não for especificado na região Selecionadoda.

  • AnnotationType
    Determina se o tipo de elemento ou anotação de nome de elemento é exibida.

  • PlaceholderText
    O texto o Controlarar exibe se não houver nenhuma anotação.

  • ShowLocationName
    Alterna se o nome da região aparece no Controlarar Rótulo de Ajuda.

Há uma solução com três projetos no exemplo de rótulo de Ajuda: um projeto de biblioteca de Controlarar, um projeto de documento do Word e um projeto de pasta de trabalho do Excel.Os projetos do Word e Excel demonstram como usar o Controlarar.Como Clique em diferentes áreas do documento ou planilha, o rótulo da Ajuda exibe texto que é obtido da região de esquema XML associada.

Observação de segurança:

Esse código de exemplo é destinado a ilustrar um conceito, e ele mostra somente o código que é relevante para esse conceito.Ele pode não atender aos requisitos de segurança de um ambiente específico e não deve ser usado exatamente como mostrado.Recomendamos que você adicione segurança e código de tratamento de erros para tornar seus projetos mais seguros e robustos.A Microsoft fornece o código de exemplo "como está" sem garantias.

Para obter informações sobre como instalar o projeto de exemplo no seu computador, consulte Como: Instalar e usar arquivos de exemplo encontrados na Ajuda.

Download sample

Para executar este exemplo.

  • Pressione F5.

Demonstra

Este exemplo demonstra como criar um Controlarar de usuário e incorporá-las em um projeto e como responder a eventos em regiões mapeadas em XML.

Consulte também

Conceitos

Esquemas XML e dados (Visual Studio Tools for Office)

Visão geral painel Ações

Walkthroughs de personalização da interface do usuário

Outros recursos

Exemplos de nível de documento