Compartilhar via


Arquivo .Vsz (controle do projeto)

O ponto de partida de cada assistente é o arquivo vsz.O arquivo vsz é um arquivo de texto que determina o Assistente para 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 a serem passados para o assistente.Para obter uma lista de parâmetros opcionais, consulte Predefinidos símbolos de assistente personalizada.

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

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

  • Os conjuntos de linha segundo o Assistente variável para o ProgID do assistente que é cocreated por Visual Studio.Um ProgID é uma representação de seqüência de caracteres de um CLSID, como VsWizard.VsWizardEngine.10.0.

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

  • Estas duas linhas a seguir é uma lista opcional de parâmetros que permitem que o arquivo vsz passar parâmetros personalizados adicionais para o assistente.Cada valor é passado como um elemento da seqüência de caracteres em uma matriz de variantes do controle wizard 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 tem 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, especifique as funções encontradas na Common.js arquivo:

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

As funções CanAddATLClass, CanAddMFCClass, e CanAddClass são chamados pelo Assistente para confirmar que o Modelo de código do Visual C++ está disponível.Se uma função retorna false, o assistente não é iniciado.

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

ObservaçãoObservação

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

Consulte também

Tarefas

Criando um assistente personalizado

Referência

Assistente Personalizado

Conceitos

Arquivos criados para o assistente

Adicionando assistentes às caixas de diálogo Adicionar Item e Novo Projeto usando arquivos .Vsdir

Projetando um assistente

Outros recursos

Modelo de assistente do Visual C++