ACAPI_LibPart_GetSection

등록된 라이브러리 파트의 기존 섹션을 리턴합니다.

    GSErrCode  ACAPI_LibPart_GetSection (
        Int32                   libInd,
        API_LibPartSection*     section,
        GSHandle*               sectionHdl,
        GS::UniString*          sectionStr,
        GS::UniString*          password = NULL
    );

파라미터

libInd: [in] 라이브러리 파트의 인덱스입니다.
section: [in/out] 섹션의 정의입니다. 섹션은 API_LibPartSection structure의 sectType과 subIdent 필드들로 정의됩니다.
sectionHdl: [out] 섹션 데이터입니다.
sectionStr: [out] Unicode 문자열 형태의 텍스트 섹션의 내용입니다. 만약 당신이 이 데이터가 필요하면 기존 Unicode 문자열의 주소를 전달합니다.
password: [in] 섹션을 암호화한 패스워드입니다. (선택적)

리턴 값

NoError: 함수가 성공적으로 완료되었습니다.
APIERR_BADPARS: 유효하지 않은 libInd입니다. 또는
파라미터 중 NULL인 것이 있습니다. 또는
호출한 라이브러리 파트는 매크로, 그림 파일 등입니다.
APIERR_NOLIBSECT: 라이브러리 파트 안에 그러한 섹션은 없습니다.

다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.

설명

이 함수는 라이브러리 파트로부터 요청한 섹션의 데이터를 가져오는 데 사용합니다.

이것은 sectionHdl의 libInd에 의해 정의된 라이브러리 파트의 요청한 섹션을 리턴합니다. 섹션은 API_LibPartSection structure의 sectType 필드에 의해 정의됩니다. 만약 이것(4-문자 대소문자 구별하는 식별자)이 표준 타입이 아니라면, 커스텀 타입으로 해석합니다. 이 경우 당신은 이 섹션의 내용 및 관리를 책임져야 합니다. 표준 섹션들의 설명은 ArchiCAD Reference Manual에서 찾아볼 수 있습니다.

함수는 실제 라이브러리 파트에서만 작동합니다. 대상 라이브러리 파트의 타입이 아래 목록에 있지 않은 것이라면, 함수는 오류 코드를 리턴합니다. 다른 타입의 라이브러리 파트들은 단지 활성 라이브러리 폴더로부터 열거되고 등록된 단순한 그림 또는 텍스트 파일들이기 때문입니다; 그림 또는 매크로.

라이브러리 파트의 적용 가능한 타입은 다음과 같습니다:

만약 더 이상 필요하지 않으면 데이터를 폐기하는 것을 잊지 마십시오.

API 11부터는 텍스트 섹션 데이터가 라이브러리 파트 안에 GS::UniString으로 저장됩니다. 당신은 또한 sectionStr 파라미터에 이 포맷으로 텍스트를 얻을 수 있습니다.

예제

ACAPI_LibPart_GetSectionList 함수의 예제를 보십시오.

요구사항

버전: API 1.3 또는 이후

헤더: ACAPinc.h

참고사항

API_LibPartSection, ACAPI_LibPart_GetSectionList,
라이브러리 파트 관리자, API 함수