APIAny_GetAutoTextKeysID

모든 자동 텍스트 키들과 그것들의 값들을 가져옵니다.

    GSErrCode ACAPI_Goodies (
        APIAny_GetAutoTextKeysID,
        char***     keys,
        char***     values
    );

 

파라미터

keys

[out] 사용가능한 자동 텍스트 키들로 채워질 C 문자열들의 배열에 대한 포인터입니다.

values

[out] 해당되는 해석된 값들로 채워질 C 문자열들의 배열에 대한 포인터입니다. (선택사항이며 NULL일 수 있음)

 

리턴 값

NoError

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

APIERR_BADPARS

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

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

 

설명

데이터베이스에서 현재 이용할 수 있는 자동 텍스트 키들("CLIENT", "PROJECTNAME", "PROJECTNUMBER", "COMPANY" 등과 같은)과 값들의 리스트를 가져오기 위해 이 함수를 사용하십시오.

이 함수는 문자열 배열들과 각 문자열들에 대하여 동적으로 메모리를 할당합니다. 더 이상 필요하지 않으면 가져온 포인터들을 폐기하는 것을 잊지 마십시오.

동일한 목적을 위해 APIAny_GetAutoTextsID 함수를 사용할 수도 있습니다. APIAny_SetAnAutoTextID로 자동 텍스트의 값을 변경할 수 있습니다.

 

예제

char** keys;
char** values;

GSErrCode err = ACAPI_Goodies (APIAny_GetAutoTextKeysID, &keys, &values);
if (err == NoError) {
    Int32 count = BMGetPtrSize (reinterpret_cast<GSPtr> (keys)) / sizeof (char*);
    for (Int32 i = 0; i < count; i++) {
        if (keys[i] == NULL) {
            BMKillPtr (&values[i]);
            continue;
        }

        DBPrintf ("AutoText[%03d] \"%s\" = \"%s\"\n", i, keys[i], values[i]);

        BMKillPtr (&keys[i]);
        BMKillPtr (&values[i]);
    }
}

BMKillPtr (reinterpret_cast<GSPtr*>(&keys));
BMKillPtr (reinterpret_cast<GSPtr*>(&values));

 

요구사항

버전: API 10 또는 이후

헤더: APIdefs_Goodies.h

 

참고사항

APIAny_GetAutoTextsID
APIAny_SetAnAutoTextID
ACAPI_Goodies
API 함수