Partilhar via


O .vsz arquivo (controle de projeto)

O ponto inicial de cada assistente é o arquivo .vsz.O arquivo .vsz é um arquivo de texto determina o assistente a ser chamado e as informações para passar para o assistente.O arquivo contém um cabeçalho de duas linhas, seguido por vários parâmetros opcionais sejam passadas para o assistente.Para obter uma lista de parâmetros opcionais, consulte Assistente de predefinidos Custom Symbols.

O exemplo a seguir mostra o cabeçalho em um arquivo .vsz:

VSWIZARD 7.0
Wizard=VsWizard.VsWizardEngine.8.0
Param="WIZARD_NAME = My AppWizard"
  • A primeira linha do cabeçalho Especifica o número de versão do modelo de formato de arquivo.Você pode especificar esse número sistema autônomo 6.0, 7.0, ou 7.1. Não há outros números são válido e usando outros números resultados em um erro "Formato inválido".

  • A segunda linha define o Assistente variável para o ProgID do assistente cocreated pelo Visual Studio.ProgID é uma representação de seqüência de caracteres de um CLSID sistema autônomo VsWizard.VsWizardEngine.8.0.

    Se seu assistente tem uma interface de usuário, o ProgID especifica automaticamente o Assistente para implementar IVCWizCtlUI. Por padrão, os métodos da interface são usados no arquivos .htm do seu projeto.Você pode alterar o comportamento do seu assistente usando os métodos para esta interface nos arquivos .htm.See VCWizCtl Para obter mais informações, que é coclass para IVCWizCtlUI.

  • Estas duas linhas a seguir é uma lista opcional de parâmetros que permite que o arquivo .vsz passar parâmetros personalizados adicionais para o assistente.Cada valor é passado sistema autônomo um elemento da seqüência de caracteres em uma matriz de variantes no Execute método. Por padrão, um assistente com uma interface de usuário produz os seguintes parâmetros de padrão:

    Param="START_PATH = <path to the wizard>"
    Param="HTML_PATH = <path to the wizard's HTML file>"
    Param="TEMPLATES_PATH = <path to the wizard's template file>"
    Param="SCRIPT_PATH = <path to the wizard's script files>"
    Param="IMAGES_PATH = <path to the wizard's images>"
    

    Se o assistente não tem uma interface de usuário, ele não possui um IMAGES_PATH parâmetro e, em vez disso, contém os seguintes parâmetros:

    Param="WIZARD_UI = FALSE"
    Param="SOURCE_FILTER = txt"
    
  • O arquivo .vsz pode conter os seguintes parâmetros, especificar funções encontradas no Common.jsarquivo :

    Param="PREPROCESS_FUNCTION = CanAddATLClass"
    Param="PREPROCESS_FUNCTION = CanAddMFCClass"
    Param="PREPROCESS_FUNCTION = CanAddClass"
    

As funções CanAddATLClass, CanAddMFCClass, and CanAddClass são chamados pelo Assistente para confirmar que o O Visual C++ Code Model está disponível.Se uma função retorna False, o assistente não é iniciado.

Você pode adicionar seu assistente ao painel de modelos no Novo projeto caixa de diálogo no Visual Studio colocando o arquivo .vsz no diretório vc7\vcprojects.Por padrão, o assistente personalizada grava o arquivo de .vsz neste diretório.

Observação:

Se você excluir seu assistente de arquivos e diretórios, você também deve excluir o projeto.vsz arquivo.vsdir arquivo, e.ico arquivo do diretório vc7\vcprojects.

Consulte também

Tarefas

Criando um assistente personalizado

Conceitos

Arquivos criados para O Assistente

Adicionando assistentes para o adicionar item e Novo Projeto Caixa de diálogo caixas usando arquivos de .Vsdir

Criando um assistente

Referência

Assistente personalizado

Outros recursos

O Visual C++ Assistente modelo