Compartilhar via


Exemplo do ATLPages: Implementa uma página de propriedades usando IPropertyPageImpl

O exemplo ATLPages demonstra a implementação de uma página de propriedades usando IPropertyPageImpl.

Este exemplo consiste em:

  • Uma classe de página de propriedades, CDocumentProperties, que usa o EnvDTE::Document interface exibir (e permitir que as alterações) as propriedades de um documento de texto.

  • Um componente de Ajuda, CHelper, que expõe um wrapper simplificado para o OleCreatePropertyFrame API para linguagens de script.

  • Uma macro de teste simples, teste em que o projeto ATLPages.vsmacros, que usa o auxiliar para exibir o propriedade página do documento ativo dentro do editor do Visual C++.

Observação de segurança:

Este código de exemplo é fornecido para ilustrar um conceito e não deve ser usado em aplicativos ou sites da Web, pois ele não pode ilustrar sistema autônomo práticas de codificação mais seguras.Microsoft sistema autônomo sumes nenhuma responsabilidade por danos incidentais ou conseqüenciais deve o código de exemplo ser usado para fins diferentes de sistema autônomo se destina.

Para obter exemplos e instruções para instalá-los:

  • Sobre o Visual Studio Ajuda menu, clicar Exemplos.

    Para obter mais informações, consulte Localizando arquivos de exemplo.

  • A versão mais recente e a lista completa das Exemplos está disponível online a partir de O Visual Studio 2008 Exemplos página.

  • Você também pode localizar exemplos no disco rígido do seu computador.Por padrão, exemplos e um arquivo Leiame são copiados para uma pasta sob \programa Files\Visual Studio 9.0\Samples\.Para edições Express do Visual Studio, todos os exemplos estão localizados online.

Criando e executando o exemplo

Para executar o exemplo, você precisa compilar a solução e, em seguida, executar a macro de teste.

Para compilação esta amostra

  1. em aberto ATLPages7.sln do arquivo de solução.

  2. From a Compilação menu, clicar Criar solução.

Para executar a macro

  1. em aberto um documento de texto no editor.Por exemplo, abra um dos arquivos de fonte da amostra ATLPages.

  2. From a Ferramentas menu, point to Macros e, em seguida, clicar Gerenciador de Macro.Este será em aberto a janela Gerenciador de macro.

  3. From a Ferramentas , aponte para Macros e, em seguida, clicar Carregar projeto de macro.Este será em aberto o Adicionar projeto de macro caixa de diálogo.

  4. Navegue até o local do arquivo ATLPages.vsmacros (é na mesma pasta sistema autônomo amostra ATLPages) e clicar no em aberto botão.Esta ação irá carregar o arquivo de macros e ela será exibida no Gerenciador de macro.

  5. expandir o nó ATLPages e clicar duas vezes na macro de teste.

    Se nenhum documento de texto estiver em aberto quando você executar a macro, ela não faz nada.Se um documento estiver em aberto, uma página de propriedades para o documento será exibida indicando o nome do arquivo e seu status de somente leitura.Você pode alterar qualquer um desses itens.Suas alterações serão aplicadas quando você clicar na Aplicar or OK botão.Alterar o nome do arquivo vai fazer com que o arquivo a ser salvo em disco com o novo nome.Alterar o status somente leitura do arquivo afeta se o arquivo pode ser alterado dentro do editor do Visual C++ (ela não afeta o atributo somente leitura do arquivo no disco).

    Observação:

    Alterar a propriedade somente leitura dos arquivos sob controle do código-fonte não é possível usando a página de propriedades.

Palavras-chave

Este exemplo utiliza as seguintes palavras-chave:

IPropertyPage, IPropertyPageImpl, OleCreatePropertyFrame, IPropertyPage::SetObjects, IPropertyPage::ativar, IPropertyPage::aplicar, EnvDTE

Consulte também

Outros recursos

Exemplos do ATL