Descrizione della directory del modello. File Vsdir)
Un file di descrizione della directory del modello (.vsdir) è un file di testo che consente all'(IDE) ambiente di sviluppo integrato alle cartelle di visualizzazione, i file vsz di procedura guidata e i file modelli associati al progetto nelle finestre di dialogo. Il contenuto incluso un record per file o cartella. Tutti i file vsdir in una posizione a cui si fa riferimento vengono uniti, anche se solo un file vsdir venga fornito in genere per descrivere più cartelle, le procedure guidate, o i file modello.
Le cartelle (file system, i file a cui si fa riferimento nel file vsdir e il file stesso tutto vsdir si trovano nella stessa directory. Quando l'ide esegue una procedura guidata o visualizzare una cartella o un file in nuovo progetto o nelle finestre di dialogo di Aggiungi nuovo elemento , l'ide esamina la directory che contiene i file eseguiti per determinare se un file vsdir è presente. Se una chiamata al metodo GetDropdownBar indica che una barra a discesa non esiste, quindi chiamare AddDropdownBar. Se una voce viene trovata, l'ide utilizza le informazioni nell'esecuzione della procedura guidata o la visualizzazione del contenuto.
Nell'esempio di codice presente nel file SourceFiles.vsdir nella chiave del Registro di sistema di <EnvSDK> \BscPrj\BscPrj\BscPrjProjectItems\Source_Files:
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
In questo caso, due record sono contenuti in un file. Una nuova riga (carattere di ritorno a capo) separa ciascun record. Ogni riga rappresenta un tipo di file diversa. Le pipe|il carattere separa i campi in ciascun record. Una singola directory può contenere file multipli .vsdir con nomi diversi file, oppure può essere un file vsdir per ogni tipo di file.
Campi
Nella tabella seguente sono elencati i campi specificati per ciascun record.
Campo |
Descrizione |
|---|---|
Percorso relativo (RelPathName) |
Il nome della cartella, il modello, o del file VSZ, come HeaderFile.h o esempio MyWizard.vsz. Questo campo può essere anche un nome utilizzato per rappresentare una cartella. |
{clsidPackage} |
Il GUID del pacchetto VS che consente l'accesso alle stringhe localizzate, ad LocalizedName, la descrizione, IconResourceId e SuggestedBaseName, nelle risorse satellite (DLL) della DLL del package VS. IconResourceId viene applicata se DLLPath non viene fornito. Nota Questo campo è facoltativo a meno che uno o più dei campi precedenti sia un identificatore di risorsa.Questo campo è in genere vuoto per i file vsdir che corrispondono alle procedure guidate di terze parti che non localizzano il testo. |
LocalizedName |
Il nome localizzato del file modello o della procedura guidata. Questo campo può essere una stringa o un identificatore di risorsa in formato “#ResID„. Questo nome viene visualizzato nella finestra di dialogo di Aggiungi nuovo elemento . Nota Se LocalizedName è un identificatore di risorsa, quindi {clsidPackage} è obbligatorio. |
SortPriority |
Intero che rappresenta la priorità relativa del file modello o la procedura guidata. Ad esempio, se l'elemento ha un valore pari a 1, questo elemento viene visualizzato accanto ad altri elementi con un valore pari a 1 e davanti a tutti gli elementi con un valore di ordinamento di 2 o maggiore. La proprietà di ordinamento è relativo agli elementi nella stessa directory. Possono essere presenti più file vsdir nella stessa directory. In tal caso, gli elementi di tutti i file vsdirnella directory vengono uniti. Gli elementi con la stessa priorità sono elencati per lessicografico senza distinzione tra maiuscole e minuscole il nome. La funzione di _wcsicmp viene utilizzata per ordinare gli elementi. Gli elementi non descritti in file vsdir includono un numero di priorità maggiore del numero più elevata elenco dei file vsdir. Il risultato è che questi elementi sono alla fine dell'elenco vengono visualizzati indipendentemente dal relativo nome. |
Descrizione |
La descrizione localizzata del file modello o della procedura guidata. Questo campo può essere una stringa o un identificatore di risorsa in formato “#ResID„. Questa stringa viene visualizzata in nuovo progetto o nella finestra di dialogo di Aggiungi nuovo elemento quando l'elemento è selezionato. |
DLLPath o {clsidPackage} |
Utilizzato per caricare una per il file modello o della procedura guidata. L'icona viene caricata come una risorsa da un file dll o EXE utilizzando il IconResourceId. Questo file dll o EXE può essere identificato utilizzando un percorso completo o tramite un GUID di un VSPackage. La DLL di implementazione del package VS viene utilizzato per caricare l'icona (non la DLL satellite). |
IconResourceId |
L'identificatore della risorsa nella DLL o nelle DLL di implementazione di package VS che determinano l'icona da visualizzare. |
flag (__VSDIRFLAGS) |
Utilizzata per disabilitare o abilitare i campi di Percorso e di Nome nella finestra di dialogo Aggiungi nuovo elemento . Il valore del campo di flag è l'equivalente decimale della combinazione di flag di bit richiesto. Quando un utente seleziona un elemento nella scheda di nuovo , il progetto determina se il campo nome e il campo del percorso vengono visualizzati quando la finestra di dialogo di Aggiungi nuovo elemento necessario innanzitutto visualizzarla. Un elemento, da un file vsdir, può controllare solo se i campi siano abilitati in disabilitato quando l'elemento è selezionato. |
SuggestedBaseName |
Rappresenta il nome predefinito del file, la procedura guidata, o il modello. Questo campo è una stringa o un identificatore di risorsa in formato “#ResID„. L'ide utilizza questo valore per specificare il nome predefinito dell'elemento. Questo valore di base viene accodato un valore Integer per rendere il nome univoco, ad MyFile21.asp. Nell'elenco precedente, la descrizione, DLLPath, IconResourceId, flag e SuggestedBaseNumber si applicano solo ai file della procedura guidata e del modello. Questi campi non si applicano alle cartelle. Questo fatto è illustrato nel codice nel file di BscPrjProjectItems nella chiave del Registro di sistema di <EnvSDK> \BscPrj\BscPrj\BscPrjProjectItems. questo file contiene tre record (uno per ogni cartella) con quattro campi per ogni record: 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 si crea un file della procedura guidata, è inoltre necessario considerare i problemi seguenti.
Qualsiasi campo facoltativo in cui non vi sono dati significativi dovrebbe contenere uno zero (0) come segnaposto.
Se non viene fornito alcun nome localizzato, il percorso relativo viene utilizzato nel file della procedura guidata.
DLLPath esegue l'override del clsidPackage per la posizione dell'icona.
Se non è definita alcuna icona, l'ide sostituisce l'icona predefinita per un file che dispone di tale estensione.
Se non viene fornito alcun nome di base, viene utilizzato “progetto„.
Se si eliminano file, cartelle, o i file di modello con estensione vsz, è necessario rimuovere anche i record associati dal file vsdir.
Vedere anche
Concetti
procedura guidata (. File con estensione Vsz)