Descrição do diretório de modelo (.Arquivos de Vsdir)
Um arquivo de descrição do diretório de modelo (.vsdir) é um arquivo de texto que permite que o ambiente de desenvolvimento integrado (IDE) para exibir pastas, arquivos do assistente vsz e arquivos de modelo que estão associados ao seu projeto nas caixas de diálogo. O conteúdo inclui um registro por arquivo ou pasta. Todos os arquivos de .vsdir em um local referenciado são mesclados, embora .vsdir apenas um arquivo é geralmente fornecido para descrever vários arquivos de modelos, assistentes ou pastas.
Pastas (subpastas), os arquivos referenciados no arquivo .vsdir e o próprio arquivo de .vsdir estão localizadas no mesmo diretório. Quando o IDE executa um assistente ou exibe uma pasta ou arquivo de Novo projeto ou Add New Item caixas de diálogo, o IDE examina o diretório que contém os arquivos executados para determinar se um arquivo de .vsdir está presente. Se for encontrado um arquivo de .vsdir, o IDE lê-lo para determinar se ele contém uma entrada para o arquivo ou pasta executada ou exibida. Se uma entrada for encontrada, o IDE usa as informações na tela do conteúdo ou a execução do assistente.
O exemplo de código a seguir está no arquivo SourceFiles.vsdir na chave do registro de \BscPrj\BscPrj\BscPrjProjectItems\Source_Files <EnvSDK>:
HeaderFile.h|{E59935A1-6156-11d1-87A6-00A0C91E2A46}|#125|130|#126|0|0|0|#127
SourceFile.cpp|{E59935A1-6156-11d1-87A6-00A0C91E2A46}|#122|110|#123|0|0|0|#124
Nesse caso, os dois registros estão em um arquivo. Uma nova linha (caractere de retorno de carro) separa cada registro. Cada linha representa um tipo de arquivo diferente. Um caractere de pipe (|) separa os campos de cada registro. Um único diretório pode conter vários arquivos de .vsdir que têm nomes de arquivo diferente, ou você pode ter um arquivo de .vsdir para cada tipo de arquivo.
Campos
A tabela a seguir lista os campos especificados para cada registro.
Campo |
Descrição |
|---|---|
Nome de caminho relativo (RelPathName) |
O nome do arquivo vsz, modelo ou pasta, como, por exemplo, HeaderFile.h ou MyWizard.vsz. Este campo também pode ser um nome usado para representar uma pasta. |
{clsidPackage} |
O GUID do VSPackage que permite o acesso às seqüências localizadas, como, por exemplo, LocalizedName, descrição, IconResourceId e SuggestedBaseName, nos recursos do VSPackage satélite dynamic link library (DLL). IconResourceId se aplica se DLLPath não for fornecido. Dica Este campo é opcional, a menos que um ou mais campos anteriores são um identificador de recurso.Este campo é normalmente em branco para os arquivos de .vsdir que correspondem aos assistentes de terceiros que não localiza o texto. |
LocalizedName |
O nome localizado do arquivo de modelo ou assistente. Este campo pode ser uma seqüência de caracteres ou um identificador de recurso do formulário "#resid". Esse nome é exibido no Add New Item caixa de diálogo. Dica Se LocalizedName é um identificador de recurso, é necessário {clsidPackage}. |
SortPriority |
Um inteiro que representa a prioridade relativa deste arquivo de modelo ou assistente. Por exemplo, se este item tiver um valor de 1, este item é exibido ao lado de outros itens com um valor de 1 e à frente de todos os itens com um valor de classificação 2 ou maior. Prioridade de classificação é em relação aos itens no mesmo diretório. Pode haver mais de um arquivo de .vsdir no mesmo diretório. Nesse caso, os itens de todos os .vsdir arquivos nesse diretório são mesclados. Itens com a mesma prioridade são listados em ordem de lexicographic de maiúsculas e minúsculas do nome exibido. O _wcsicmp função é usada para solicitar os itens. Itens não são descritos nos arquivos de .vsdir inclui um número de prioridade maior que o número de prioridade mais alto listado nos arquivos .vsdir. O resultado é que esses itens estão no final da lista exibida, independentemente de seu nome. |
Descrição |
A descrição localizada do arquivo de modelo ou assistente. Este campo pode ser uma seqüência de caracteres ou um identificador de recurso do formulário "#resid". Essa seqüência aparece no Novo projeto ou Add New Item caixa de diálogo quando o item é selecionado. |
DLLPath ou {clsidPackage} |
Usado para carregar um ícone para o arquivo de modelo ou assistente. O ícone é carregado como um recurso de check-out de um arquivo. dll ou. exe usando o IconResourceId. Este arquivo. dll ou. exe pode ser identificado usando um caminho completo ou usando um GUID de um VSPackage. A implementação de DLL do VSPackage é usada para carregar o ícone (não a DLL satélite). |
IconResourceId |
O identificador de recursos na implementação de DLL ou VSPackage DLL que determina o ícone para exibir. |
Flags (__VSDIRFLAGS) |
Usado para ativar ou desativar o nome e local os campos na Add New Item caixa de diálogo. O valor da sinalizadores de campo é o equivalente a combinação de sinalizadores de bit necessária. Quando um usuário seleciona um item a novo o projeto de guia, que determina se os campos de nome e o local são mostradas quando a Add New Item caixa de diálogo é exibida pela primeira vez. Um item, por meio de um arquivo de .vsdir, pode controlar somente se os campos estão habilitados em vez de desabilitado quando o item é selecionado. |
SuggestedBaseName |
Representa o nome padrão para o arquivo, Assistente ou modelo. Este campo é uma seqüência de caracteres ou um identificador de recurso do formulário "#resid". O IDE usa esse valor para fornecer um nome padrão para o item. Esse valor de base é acrescido de um valor inteiro para tornar o nome exclusivo, como, por exemplo, MyFile21.asp. Na lista anterior, descrição, DLLPath, sinalizadores, IconResourceId e SuggestedBaseNumber se aplicam apenas aos arquivos de modelo e o assistente. Esses campos não se aplicam às pastas. Esse fato é ilustrado no código no arquivo BscPrjProjectItems na chave do registro de \BscPrj\BscPrj\BscPrjProjectItems <EnvSDK>. Este arquivo contém três registros (um para cada pasta) com quatro campos de cada registro: RelPathName {clsidPackage}, LocalizedName e SortPriority. General|{E59935A1-6156-11d1-87A6-00A0C91E2A46}|#110|100 Source_Files|{E59935A1-6156-11d1-87A6-00A0C91E2A46}|#111|110 Env|{E59935A1-6156-11d1-87A6-00A0C91E2A46}|#112|120 |
Quando você cria um arquivo do assistente, você também deve considerar as questões a seguir.
Qualquer campo não necessárias para o qual não há nenhum dado significativo deve conter um 0 (zero) como um espaço reservado.
Se nenhum nome localizado for fornecido, o nome de caminho relativo é usado no arquivo do assistente.
DLLPath substitui clsidPackage para a localização do ícone.
Se nenhum ícone for definido, o IDE substitui o ícone padrão para um arquivo com extensão.
Se nenhum nome de base sugerido for fornecido, 'Projeto' é usado.
Se você excluir o vsz arquivos, pastas ou arquivos de modelo, você também deve remover seus registros associados do arquivo .vsdir.