마법사를 시작하는 데 사용되는 컨텍스트 매개 변수

  • 아티클

업데이트: 2007년 11월

컨텍스트 매개 변수는 사용할 마법사 종류, 프로젝트 이름, 마법사 항목의 디렉터리 등 마법사를 시작하는 데 필요한 정보를 제공합니다.

다음과 같은 세 가지 종류의 마법사가 있습니다.

  • NewProject - 솔루션에 새 프로젝트를 추가합니다.

  • AddSubProject - 기존 프로젝트에 하위 프로젝트를 추가합니다.

  • AddItem - 기존 프로젝트에 항목을 추가합니다.

이러한 세 가지 종류의 마법사는 IDTWizard 인터페이스의 Execute 메서드를 사용하여 호출됩니다. Execute 메서드의 필수 매개 변수는 ContextParams입니다. 각 마법사에는 다음 표에서 간략하게 설명하는 정확한 순서에 따라 서로 다른 ContextParams 값 집합을 사용해야 합니다.

마법사 종류

매개 변수

NewProject

  • WizardType

  • ProjectName

  • LocalDirectory

  • InstallationDirectory

  • FExclusive

  • SolutionName

  • Silent

AddSubProject

  • WizardType

  • ProjectName

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

AddItem

  • WizardType

  • ProjectName

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

다음 표에서는 모든 컨텍스트 매개 변수 목록과 해당 설명을 보여 줍니다.

설정값

설명

WizardType

마법사의 형식을 나타내는 상수로 다음과 같은 세 가지 종류가 있습니다.

  • vsWizardNewProject (GUID = "{0F90E1D0-4999-11D1-B6D1-00A0C90F2744}")

  • vsWizardAddItem (GUID = "{0F90E1D1-4999-11D1-B6D1-00A0C90F2744}")

  • vsWizardAddSubProject (GUID = "{0F90E1D2-4999-11D1-B6D1-00A0C90F2744}")

ProjectName

프로젝트 이름입니다.

ProjectItems

마법사가 작동할 ProjectItems 컬렉션에 대한 포인터이며 프로젝트 계층 구조의 선택을 기준으로 마법사에 전달됩니다.

LocalDirectory

로컬 시스템에서 마법사의 작업 프로젝트 파일이 저장되는 위치입니다.

ItemName

추가할 항목의 이름입니다. ItemName은 항목 추가 대화 상자에서 사용자가 입력하거나 기본적으로 적용되는 파일 이름입니다. VSDIR 파일에 설정된 플래그에 따라 이 설정은 NULL일 수 있습니다.

InstallationDirectory

Visual Studio의 설치 디렉터리 경로입니다.

FExclusive

프로젝트가 전용 프로젝트인지 여부를 나타내는 Boolean 값입니다. 전용 프로젝트이면 시스템에서 현재 솔루션을 닫고 새 솔루션을 만든 다음 프로젝트를 추가하고, 전용 프로젝트가 아니면 현재 솔루션에 프로젝트를 추가합니다.

SolutionName

디렉터리 또는 .sln 확장명을 제외한 솔루션 이름으로, .suo 파일 이름에도 이 루트 이름이 사용됩니다. SolutionName에 값이 있으면 즉, 빈 문자열이 아니면 NewProject 마법사는 Create를 호출한 후 AddFromTemplate으로 프로젝트를 추가합니다. 그러나 SolutionName이 빈 문자열이면 AddFromTemplate을 호출하기 전에 Create를 호출할 필요가 없습니다.

Silent

UI(사용자 인터페이스)를 표시하지 않고 모두 기본값을 사용하여 마법사를 자동으로 실행할지 여부를 나타내는 부울 값입니다. Silent의 기본값은 True입니다.

참고 항목

개념

.Vsdir 파일을 사용하여 항목 추가 및 새 프로젝트 대화 상자에 마법사 추가

참조

Execute

IDTWizard