서식 파일 디렉터리에 대 한 설명 (.Vsdir) 파일
템플릿 디렉터리 설명 파일 (.vsdir) 활성화 통합된 개발 환경 (IDE) 대화 상자에서 프로젝트와 연결 된 서식 파일 폴더, 마법사.vsz 파일을 표시 하는 텍스트 파일이입니다. 내용 파일이 나 폴더 당 레코드 하나를 포함합니다. 한.vsdir 파일은 일반적으로 여러 폴더 마법사 또는 서식 파일에 설명 합니다 제공 되지만 모든.vsdir 파일 참조 된 위치에 병합 됩니다.
폴더 (하위),.vsdir 파일 및.vsdir 파일을 참조 하는 파일 모두 같은 디렉터리에 위치 합니다. IDE는 마법사를 실행 하거나 폴더 또는 파일에 표시 됩니다 때에 새 프로젝트 또는 새 항목 추가 대화 상자가 IDE.vsdir 파일 존재 여부를 확인 하려면 실행된 파일이 들어 있는 디렉터리를 검사 합니다. .Vsdir 파일을 검색 하는 경우 IDE 실행 또는 표시 된 폴더 또는 파일에 대 한 항목이 포함 되어 있는지 여부를 확인 하 여 읽습니다. 항목이 발견 되 면 IDE 마법사의 실행 또는 표시 내용에 정보를 사용 합니다.
다음 코드 예제에서는 <EnvSDK> \BscPrj\BscPrj\BscPrjProjectItems\Source_Files 레지스트리 키에서 SourceFiles.vsdir 파일에서입니다.
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
이 경우 두 레코드의 파일입니다. 새 줄 (캐리지 리턴 문자) 각 레코드를 구분합니다. 각 줄에 다른 파일 형식을 나타냅니다. 파이프 (|) 문자는 각 레코드의에서 필드를 구분합니다. 다른 파일 이름을 가진 여러.vsdir 파일 단일 디렉터리를 포함 하거나 각 파일 형식에 대 한.vsdir 파일을 가질 수 있습니다.
필드
다음 표에서 각 레코드에 대해 지정한 필드를 나열 합니다.
필드 |
설명 |
|---|---|
상대 경로 이름 (RelPathName) |
예: MyWizard.vsz 또는 HeaderFile.h 폴더, 템플릿 또는.vsz 파일의 이름입니다. 이 필드 이름을 폴더를 나타내는 데 사용 될 수도 있습니다. |
{clsidPackage} |
있는 VSPackage 위성 동적 연결 라이브러리 (DLL) 리소스에서 LocalizedName, 설명, Iconresourceid를 SuggestedBaseName, 등 번역 된 문자열에 액세스할 수 있도록 하는 Vspackage의 GUID입니다. DLLPath 제공 되지 않으면 Iconresourceid를 적용 합니다. 참고 리소스 id 이전 필드 중 하나 이상이 아닌 경우이 필드는 선택 사항입니다.이 필드에 해당 텍스트를 지역화 하지 않습니다 타사 마법사에 해당.vsdir 파일 일반적으로 비어 있습니다. |
LocalizedName |
서식 파일 또는 마법사의 지역화 된 이름입니다. 이 필드는 "resid"의 리소스 식별자 또는 문자열이 될 수 있습니다. 이 이름은 표시 되는 새 항목 추가 대화 상자. 참고 LocalizedName 리소스 식별자 이면 {clsidPackage}은 필수입니다. |
SortPriority |
이 서식 파일 또는 마법사의 상대적인 우선 순위를 나타내는 정수입니다. 예를 들어,이 항목 값이 1 인 경우이 항목 값이 1 및 2 또는 큰 정렬 값을 가진 모든 항목을 다른 항목 옆에 표시 됩니다. 정렬 우선 순위 항목 같은 디렉터리에 상대적입니다. 같은 디렉터리에서.vsdir 파일을 두 개 이상 있을 수 있습니다. 경우에 모두에서 .디렉터리에 있는 vsdir 파일에 병합 됩니다. 동일한 우선 순위를 가진 항목이 표시 되는 이름은 대/소문자 구분 lexicographic 순으로 나열 됩니다. _wcsicmp 함수 항목을 주문 하는 데 사용 됩니다. .Vsdir 파일에 설명 되지 않은 항목 수보다.vsdir 파일에 나열 된 가장 높은 우선 순위에 우선 순위를 포함 합니다. 이 항목 끝에 표시 된 목록의 이름에 관계 없이 인지 결과가입니다. |
설명 |
서식 파일 또는 마법사의 지역화 된 설명입니다. 이 필드는 "resid"의 리소스 식별자 또는 문자열이 될 수 있습니다. 이 문자열에 나타납니다를 새 프로젝트 또는 새 항목 추가 에서 항목을 선택할 때 대화 상자. |
DLLPath 또는 {clsidPackage} |
서식 파일 및 마법사에 대 한 아이콘을 로드 하는 데 사용. 아이콘은 Iconresourceid를 사용 하 여.dll 또는.exe 파일을 리소스로 로드 됩니다. 이.dll 또는.exe 파일의 전체 경로 사용 하 여 나가 있는 Vspackage의 GUID를 사용 하 여 확인할 수 있습니다. 구현 DLL에 있는 VSPackage 아이콘 (않습니다: 위성 DLL)를 로드 하는 데 사용 됩니다. |
IconResourceId |
DLL 또는 VSPackage 구현 표시할 아이콘을 결정 하는 DLL의에서 리소스 식별자입니다. |
Flags (__VSDIRFLAGS) |
설정 하거나 해제 하는 데 사용 되는 이름 및 위치 에서 필드는 새 항목 추가 대화 상자. 값은 플래그 필드와 같은 십진수를 필요한 비트 플래그의 조합입니다. 때 사용자가 선택 항목에는 New 프로젝트 탭을 결정 하 고 위치 필드 이름 필드 시기 표시 되는지 여부는 새 항목 추가 대화 상자가 처음 표시 합니다. 항목을.vsdir 파일을 통해 항목을 선택 하면 필드 사용 안 함 및 사용할 수 있는지 여부는 제어할 수 있습니다. |
SuggestedBaseName |
파일, 마법사, 서식 파일의 기본 이름을 나타냅니다. 이 필드에는 "설명은 # resid" 폼의 리소스 식별자 또는 문자열이 됩니다. IDE이이 값을 사용 하 여 항목의 기본 이름을 제공 합니다. 이 기준 값의 이름을 MyFile21.asp 같은 고유 하 게 정수 값으로 추가 됩니다. 이전 목록에 설명, DLLPath 고 IconResourceId, 플래그 및 SuggestedBaseNumber 템플릿 및 마법사 파일에만 적용 됩니다. 이 필드는 폴더에 적용 되지 않습니다. 이 사실은 <EnvSDK> \BscPrj\BscPrj\BscPrjProjectItems 레지스트리 키에서 BscPrjProjectItems 파일에서의 코드에서를 보여 줍니다. 세 개의 레코드 (1 각 폴더에 대해) 각 레코드에 대 한 네 개의 필드를이 파일에 들어 있습니다: RelPathName, {clsidPackage}를 LocalizedName 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 |
또한 마법사 파일을 만들 때 다음 문제를 고려해 야 합니다.
의미 있는 데이터가 없는 선택적 필드는 숫자 0을 자리 표시자로 포함해야 합니다.
지역화 된 이름이 제공 되지 않은 경우 마법사 파일의 상대 경로 이름이 사용 됩니다.
DLLPath clsidPackage 아이콘 위치를 무시합니다.
정의 된 아이콘이 없는 경우 IDE는 해당 확장명을 가진 파일에 대 한 기본 아이콘 사용.
'프로젝트'는 제공 된 기본 이름이 없는 경우에 사용 됩니다.
.Vsz 파일, 폴더 또는 파일을 삭제 하는 경우.vsdir 파일에서 관련 된 레코드를 또한 제거 해야 합니다.