Revit SDK에는 두 개의 샘플 폴더가 포함되어 있습니다.
\Revit SDK <릴리즈>\Software Development Kit\Samples\...
\Revit SDK <릴리즈>\Software Development Kit\Macro Samples\...
SDK \Samples\ 폴더의 프로그램은 표준 Revit API를 사용합니다. 이 샘플을 Revit 매크로 샘플과 구분하여 SDK 샘플 코드라고 합니다.
매크로에 SDK 샘플 코드를 사용하려면 수정이 필요합니다. 이 절의 단계를 수행하십시오. 프로그래밍 언어의 경우 C# 예가 표시됩니다. 그러나 이 지침은 SDK 샘플의 VB.NET 버전에도 적용됩니다.
초기 단계
SDK의 표준 API 샘플을 Revit 매크로 IDE 프로젝트로 마이그레이션하기 위한 초기 단계는 매크로를 Revit IDE에 통합 섹션과 유사합니다. 그러나 SDK의 \Macro Samples\<샘플 이름>\... 폴더에서 파일을 복사하는 대신 SDK의 \Samples\<샘플 이름>\... 폴더에서 파일을 복사합니다.
검토하기 위한 단계는 다음과 같습니다.
- IDE에서 필요한 참조 추가
- IDE에서 마이그레이션할 SDK 샘플에 대한 폴더 작성
- Windows 탐색기에서 해당 파일 시스템 폴더에 SDK 표준 API 샘플 파일 복사
- IDE에서 매크로 프로젝트에 기존 파일 추가
SDK 샘플 코드 업데이트
Revit 매크로 IDE에서는 IExternalCommand 인터페이스를 사용할 수 없거나 사용되지 않습니다. SDK 표준 API 샘플 코드에서 이 인터페이스로부터 상속하는 클래스를 업데이트해야 합니다.
- Excute 메서드의 메서드 매개변수 및 리턴 값을 제거합니다.
- ExternalCommandData와 관련된 다른 코드를 업데이트합니다.
편집 전 코드 예
다음은 표준 Revit API를 사용하는 프로그램의 코드 조각입니다.
편집 후 코드 예
Revit 매크로 IDE에서 다음과 같이 코드를 업데이트해야 합니다. 이 예에서는 응용프로그램 레벨 매크로를 보여줍니다. RunSampleRooms() 메서드는 이 매크로 샘플에 대한 항목입니다. commandData.Application을 대치하기 위해 이 포인터를 사용했습니다.
SDK 표준 API 샘플에 대한 추가 마이그레이션 참고사항
- 기본적으로 SDK 샘플 네임스페이스는 다음과 같습니다. Revit.SDK.Samples.<샘플 이름>.CS. SDK 표준 API 샘플의 샘플 코드를 편집하는 경우 Revit IDE에 대한 네임스페이스를 변경해야 합니다. 예를 들어 ThisApplication.cs에서는 다음과 같습니다.
namespace AppCSharp.csproj
- Revit IDE 프로젝트의 기본 프로젝트 참조는Revit.Proxy와 같은 기본 참조로만 구성됩니다. 다른 필수 참조를 추가해야 합니다. 예를 들어, 사용자 인터페이스를 나타내는 샘플을 실행하는 경우 System.Windows.Forms 및 System.Drawing 참조를 추가해야 합니다.
- 일부 샘플에는 resources.resx 파일에 정의되어야 하는 자원이 있습니다. 한 예로 GridCreation을 들 수 있습니다. GridCreation의 SDK 표준 API 샘플을 Revit IDE로 마이그레이션하는 경우 resx 특성을 설정해야 합니다.
- Revit 매크로 IDE 내에서는 프로젝트 작성 의존성이 지원되지 않습니다. 다른 DLL을 사용하려면 Revit 매크로 IDE 외부에 있는 해당되는 의존적 샘플 프로젝트를 컴파일해야 합니다. 예를 들어 SDK 표준 API 샘플에는 RevitViewer에 대한 참조에 종속되는 AnalyticalViewer 및 RoomViewer와 같이, 뷰어에 관련된 여러 개의 샘플이 있습니다.
그러나 Revit IDE의 제한으로 인해 프로젝트 의존성을 설정할 수 없으며 RevitViewer 샘플을 마이그레이션할 수 없습니다. 따라서 RevitViewer를 독립적인 SDK 샘플으로 컴파일한 후 해당 DLL을 Revit IDE 프로젝트의 참조로 추가해야 합니다.
- SDK 표준 API 샘플을 Revit IDE로 마이그레이션하는 경우 솔루션 파일(*.sln*)이나 기존 프로젝트 파일(*.csproj 또는 *.vbproj)을 복사하지 마십시오.
- 도구막대 관련 샘플은 Revit IDE에서 사용할 수 없습니다.