필수 리소스

'MDID' 리소스

모든 애드온들은 'MDID'라는 리소스를 갖고 있어야 합니다. 이것의 리소스 ID는 32500입니다. 이 리소스는 애드온의 고유 ID를 정의합니다.

ID는 2가지 파트로 이루어져 있습니다:

Graphisoft에서 주어진 개발자의 ID,
AddOnAdmin 도구를 이용해 생성한 애드온의 ID

대상 애드온을 식별하기 위해 Communication Manager와 ModulData Manager가 먼저 사용됩니다. DevKit v4.1부터, Preference 저장에서부터 커스텀 데이터를 요소에 할당하는 것까지 모듈 ID는 애드온 식별의 여러 방면에서 사용됩니다. (비록 항상 보이지는 않지만)

충돌을 피하기 위해 ArchiCAD는 'MDID' 리소스가 동일한 애드온들이 로드되는 것을 거부합니다.

등록 ID를 얻는 방법을 알기 위해 등록 페이퍼를 참고하시기 바랍니다.

'STR#' 리소스

이 리소스는 (ArchiCAD가 유효한 ArchiCAD 애드온으로서 DLL/Code 조각을 번역하는 동안) 필수는 아니지만 대부분의 경우 전적으로 필요로 합니다. ArchiCAD는 커맨드와 관련된 메뉴, 또는 팝업 항목들을 구축하기 위해 이 문자열 리소스들을 사용합니다. 특수 리소스는 당신의 애드온에 대한 일부 정보도 포함해야 합니다. (Add-On Manager 다이얼로그에 나타나는 짧은 설명과 이름) 예제 프로젝트를 보십시오.

ACAPI_Register_Menu의 설명에서 'STR#' 리소스들의 더 많은 예제를 찾을 수 있습니다.

'STR#' 32500 "Menu strings" {
/* [  1] */     "Database Tracker"
/* [  2] */         "Enable red walls^32601"
/* [  3] */         "-"
/* [  4] */         "Enable column links"
/* [  5] */         "List links (selection)^S"
/* [  6] */         "List links (database)"
/* [  7] */         "-"
/* [  8] */         "List walls with assignments"
}

당신은 처음 커맨드의 이름이 문자열 "^32601"로 끝나는 것을 볼 수 있습니다. 이 확장은 주어진 메뉴 항목에 커스텀 그림을 할당하도록 ArchiCAd에게 지시해줍니다. 그림 자체는 ^ 문자가 따라오는 리소스 ID를 갖는 비트맵 리소스('GBMP')이어야 합니다. 물론 확장 문자열은 해당 메뉴에 나타나지 않습니다.
ArchiCAD 8부터는 이 메뉴 항목 아이콘이 메뉴에 기본적으로 나타납니다. 만약 이 아이콘이 메뉴에 나타나는 것을 원하지 않는다면, 아이콘 ID 번호 앞에 ~ (tilde) 문자를 삽입하십시오. 이런 식으로 말입니다. "^~32601"

나머지 컨트롤 코드는 커맨드의 가용성을 제어하기 위해 메뉴 항목 문자열 뒤에 덧붙일 수 있습니다. 다음 값을 넣을 수 있습니다:

컨트롤 코드

의미

^D2

커맨드를 Floor Plan 윈도우에서 사용할 수 없습니다.

^E3

커맨드를 3D 윈도우에서 사용할 수 있습니다.

^ES

커맨드를 Section 타입 윈도우에서 사용할 수 있습니다.

^EE

커맨드를 Elevation 타입 윈도우에서 사용할 수 있습니다.

^EI

커맨드를 Interior Elevation 타입 윈도우에서 사용할 수 있습니다.

^ED

커맨드를 Detail Drawing 윈도우에서 사용할 수 있습니다.

^EL

커맨드를 Layout 및 Master Layout 윈도우에서 사용할 수 있습니다.

^EW

커맨드를 Worksheet 윈도우에서 사용할 수 있습니다.

^ET

커맨드를 3D Document 윈도우에서 사용할 수 있습니다.

^G

기본적으로 메뉴 항목을 사용할 수 없습니다. (회색으로 표시됨)

^M

기본적으로 메뉴 항목이 체크되어 있습니다. (체크 마크 표시됨)

^R

커맨드는 반복 가능합니다. 즉, 메뉴 커맨드를 호출한 후 편집 메뉴의 "Repeat Last Command" 항목에서도 사용할 수 있습니다. 만약 애드온 커맨드가 여러 번 호출되어야 할 경우 이 기능은 유용할 수 있습니다.

^S

선택한 요소들이 현재 창에 있을 때에만 커맨드를 이용할 수 있습니다.

^T

만약 현재 윈도우(Story, Section, Detail, Layout)가 클라이언트의 작업 공간에 속해 있지 않으면 Teamwork 모드에서 커맨드를 사용할 수 없습니다.

컨트롤 코드	의미
`^D2`	커맨드를 Floor Plan 윈도우에서 사용할 수 없습니다.
`^E3`	커맨드를 3D 윈도우에서 사용할 수 있습니다.
`^ES`	커맨드를 Section 타입 윈도우에서 사용할 수 있습니다.
`^EE`	커맨드를 Elevation 타입 윈도우에서 사용할 수 있습니다.
`^EI`	커맨드를 Interior Elevation 타입 윈도우에서 사용할 수 있습니다.
`^ED`	커맨드를 Detail Drawing 윈도우에서 사용할 수 있습니다.
`^EL`	커맨드를 Layout 및 Master Layout 윈도우에서 사용할 수 있습니다.
`^EW`	커맨드를 Worksheet 윈도우에서 사용할 수 있습니다.
`^ET`	커맨드를 3D Document 윈도우에서 사용할 수 있습니다.
`^G`	기본적으로 메뉴 항목을 사용할 수 없습니다. (회색으로 표시됨)
`^M`	기본적으로 메뉴 항목이 체크되어 있습니다. (체크 마크 표시됨)
`^R`	커맨드는 반복 가능합니다. 즉, 메뉴 커맨드를 호출한 후 편집 메뉴의 "Repeat Last Command" 항목에서도 사용할 수 있습니다. 만약 애드온 커맨드가 여러 번 호출되어야 할 경우 이 기능은 유용할 수 있습니다.
`^S`	선택한 요소들이 현재 창에 있을 때에만 커맨드를 이용할 수 있습니다.
`^T`	만약 현재 윈도우(Story, Section, Detail, Layout)가 클라이언트의 작업 공간에 속해 있지 않으면 Teamwork 모드에서 커맨드를 사용할 수 없습니다.

파일 가져오기/내보내기 타입 애드온은 당신의 파일 포맷을 설명하는 문자열을 요구합니다. 그리고 가져오기/내보내기 다이얼로그의 목록에 나타나야 합니다.

'STR#' 32501 "File type popup string" {
/* [  1] */     "My file format"
}

더 자세한 것은 ACAPI_Register_FileType 함수의 설명을 보십시오.

ArchiCAD의 모든 파일 다이얼로그에 선택한 파일 포맷에 할당된 아이콘을 나타내는 항목을 포함하고 있습니다. 당신은 '#ICN' 리소스를 이용하면 당신의 파일 포맷에 커스텀 아이콘을 할당할 수 있습니다. 이 기능은 Machintosh에서만 구현되어 있습니다.

물론 당신은 다른 리소스 ID를 가진 'STR#' 문자열 리소스를 더 추가할 수 있습니다. 이 문자열들은 ACAPI_Resource_GetLocStr 또는 ACAPI_Resource_GetLocUStr 함수로 로드될 수 있습니다.