OpenDataFile
파일을 엽니다.
GSErr __GDLEXT_CALL OpenDataFile (
Int32 channel,
const GS::UniString& filename,
const GS::UniString& paramstring,
GSHandle* optionhdl
);
파라미터
- channel
- ArchiCAD가 파일에 할당한 채널의 번호입니다. 다른 파일 애드온을 사용하여 열었다 하더라도 이 번호는 열려 있는 모든 파일에 대하여 다릅니다.
- filename
- 열고자 하는 파일의 이름입니다. (GDL 커맨드의 filename 파라미터)
- paramstring
- 이 문자열의 내용은 애드온이 해석해야 합니다. 분리 문자와 열기 모드처럼 파일을 열기 위해 필요한 정보들을 포함할 수 있습니다. 이것의 내용과 의미하는 바는 애드온이 정의합니다. (GDL 커맨드의 parameter_string 파라미터)
- optionhdl
- 동일한 애드온에 대하여 OpenDataFile을 호출할 때마다 ArchiCAD가 저장하는 애드온의 옵션 데이터 핸들입니다. 파일 지정 정보는 저장되거나 변경될 수 있습니다. 이 데이터는 ArchiCAD Preference와 도면 파일에 저장될 것입니다.
리턴 값
- OK
- 동작이 성공했습니다.
- ERROR
- 동작이 실패했습니다.
설명
이 함수는 어떤 파일에 대하여 OPEN GDL 커맨드가 이 애드온에서 처음 해석될 때 호출됩니다. 커맨드의 filter 파라미터가 애드온의 ACNF 리소스에 지정한 모듈 이름과 같을 때 애드온이 로드됩니다.
요구사항
- 버전:
- GDL Developer Kit 13 또는 이후
- 헤더:
- ACGDinc.h
- 라이브러리 가져오기:
- GDLDev.lib
