애드온 데이터를 Preferences와 Project File에 저장하기

이 페이퍼는 당신이 갖고 있는 데이터를 preferences와 실제 프로젝트 파일로 저장하는 방법에 대한 힌트를 제공합니다.

 

가능성

당신은 preferences 파일에 무제한 크기의 데이터를 저장할 수 있습니다. preferences 데이터는 또한 모든 프로젝트 파일들에 저장됩니다.

프로젝트에 저장된 Preferences 데이터는 동일한 작업 환경을 가진 저장된 프로젝트 파일을 열 수 있게 해줍니다. 또한 애플리케이션을 종료하지 않더라도 닫을 때와 동일한 설정으로 다이얼로그 박스들을 여는 데 사용할 수 있습니다.

만약 당신의 애드온이 보존되어야 할 설정들을 사용한다면, 이 기능을 써보시기 바랍니다.

당신은 ACAPI_SetPreferences 함수를 이용하여 데이터를 preferences 파일에 저장할 수 있습니다. 그리고 ACAPI_GetPreferences 함수를 이용하여 저장된 preferences를 가져올 수 있습니다.

서버 애플리케이션이 새로운 도면을 열면서 시작했을 때, 예전에 애플리케이션의 preferences 파일로 저장된 애드온의 preferences 데이터를 이용할 수 있습니다. 만약 당신의 애드온에 의해 저장된 preferences 데이터를 가진 도면 파일을 열게 되면, 이 데이터는 애드온의 현재 preferences를 덮어쓰게 됩니다. 즉, 애드온 preferences는 프로젝트를 연 후에 변경될 수 있습니다. 만약 당신의 애드온에 preferences 데이터의 지속성을 유지할 필요가 있다면 이것을 기억하십시오.

  만약 당신의 애드온이 서로 다른 프로그램 릴리즈 버전에서 서로 다른 버전의 preferences 데이터를 갖고 있다면, 역 호환성을 보장하기 위해 예전 포맷들의 preferences를 설정하는 것을 권장합니다. 현재 preferences 버전을 저장하는 대신 지정된 (그리고 예전) 도면 버전에 저장되는 데이터를 정의하기 위해 ACAPI_SetPreferences_OldVersion 함수(ArchiCAD 전용)를 사용하십시오.

preferences가 다른 플랫폼에 저장된 도면 파일로부터 올 수도 있으므로 플랫폼 지정 데이터를 다루는 것 역시 중요합니다. 플랫폼 정보도 가져오기 위해 ACAPI_GetPreferences 대신 ACAPI_GetPreferences_Platform 함수를 사용하십시오. 만약 저장된 preferences의 플랫폼 식별자가 실제 플랫폼과 일치하지 않으면, 데이터를 적절한 포맷으로 변환하십시오.

 

참고

preferences 데이터를 다루는 제안된 방법을 보려면 DG Test 예제의 소스 코드를 연구하시기 바랍니다.