Graphisoft®

API Development KitVersion: 18

APIAny_CreateAnAutoTextID

Project Info에 새로운 엔트리를 생성합니다.

    GSErrCode ACAPI_Goodies (
        APIAny_CreateAnAutoTextID,
        const API_Guid*     guid,
        const char*         uiKey
    );

 

파라미터

guid
[in] 자동 텍스트의 guid입니다. (데이터베이스에 저장됨)
uiKey
[in] GUI (Project Info, Insert Autotext 다이얼로그)에 표시되는 문자열입니다.

 

리턴 값

NoError
함수가 성공적으로 완료되었습니다.
APIERR_BADPARS
guid 또는 uiKey 파라미터가 NULL이거나 uiKey가 이미 존재합니다.

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

 

설명

이 함수는 Project Info에 새로운 엔트리를 생성하는 데 사용합니다. 이것은 Insert Autotext 다이얼로그에도 표시될 것입니다.

 

예제

bool    InsertAutotext (void)
{
    char* uiKey = {"Created Via API"};
    GS::Guid guid;
    guid.Generate ();
    API_Guid dbKey = GSGuid2APIGuid (guid);

    GSErrCode err = ACAPI_Goodies (APIAny_CreateAnAutoTextID, &dbKey, uiKey);
    if (err != NoError)
        DBPrintf ("APIAny_CreateAnAutoTextID function failed.");

    if (err == NoError) {
        GS::UniString dbKey ("autotext-");
        dbKey.Append (guid.ToUniString ());
        GS::UniString value ("custom text");
        err = ACAPI_Goodies (APIAny_SetAnAutoTextID, &dbKey, &value);
        if (err != NoError)
            DBPrintf ("APIAny_SetAnAutoTextID function failed.");
    }
}

 

요구사항

버전: API 12 또는 이후
헤더: APIdefs_Goodies.h

 

참고사항

ACAPI_Goodies, APIAny_GetAutoTextsID, APIAny_SetAnAutoTextID, API 함수