APIAny_GetAutoTextsID

현재 사용가능한 자동 텍스트들의 키, 설명, 값을 가져옵니다.

    GSErrCode ACAPI_Goodies (
        APIAny_GetAutoTextsID,
        Uni3Array*            autotexts,
        API_AutotextType      autotextType
    );

    typedef GS::Array< GS::ArrayFB<GS::UniString, 3> > Uni3Array;

파라미터

autotexts

[out] 자동 텍스트의 설명, 키, 값을 포함하는 UniString triplet들의 배열입니다.

autotextType

[in] 주어진 타입의 자동 텍스트들만 수집하기 위한 필터입니다.

 

리턴 값

NoError

함수가 성공적으로 완료되었습니다.

APIERR_BADPARS

전달된 autotexts 파라미터가 NULL입니다.

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

 

설명

자동 텍스트들의 키, 설명(ArchiCAD의 사용자 인터페이스에 나오는 대로), 그리고 현재 값을 가져오는 데 이 함수를 사용하십시오. 자동 텍스트 데이터는 UniString들의 배열의 배열에 가져옵니다. 그래서 할당된 메모리를 해제할 필요가 없습니다. 왜냐하면 파괴자에서 자동으로 폐기되기 때문입니다.

UniString triplet들은 다음 순서대로 자동 텍스트 데이터를 포함하고 있습니다: 설명 텍스트, 데이터베이스 키, 값.

API_AutotextType 파라미터로 가져올 자동 텍스트들의 범위를 제어할 수 있습니다.

APIAny_SetAnAutoTextID로 자동 텍스트의 값을 변경할 수 있습니다.

 

예제

#include "UniString.hpp"
#include "Array.hpp"

GS::Array<GS::ArrayFB<GS::UniString, 3> > autotexts;
API_AutotextType type = APIAutoText_Fixed;

GSErrCode err = ACAPI_Goodies (APIAny_GetAutoTextsID, &autotexts, (void *) (Int32) type);
if (err == NoError) {
    for (ULong i = 0; i < autotexts.GetSize (); i++) {
        DBPrintf ("AutoText[%03d] \"%s\" (\"%s\") = \"%s\"\n", i,
            (const char *) autotexts[i][0].ToCStr (), (const char *) autotexts[i][1].ToCStr (), (const char *) autotexts[i][2].ToCStr ());
    }
}

 

요구사항

버전: API 10 또는 이후

헤더: APIdefs_Goodies.h

 

참고사항

API_AutotextType
APIAny_GetAutoTextKeysID
APIAny_SetAnAutoTextID
ACAPI_Goodies
API 함수