APIDb_AddTextWindowContentID

텍스트 창의 내용에 새로운 라인들을 추가합니다.

    GSErrCode ACAPI_Database (
        APIDb_AddTextWindowContentID,
        API_WindowInfo*     windowInfo,
        char*               content
    );

 

파라미터

windowInfo

[in] 창 식별입니다.

content

[in] 이어붙일 텍스트입니다.

 

리턴 값

NoError

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

APIERR_BADPARS

windowPars가 NULL입니다.

APIERR_REFUSEDPAR

APIWind_MyTextID가 참조되지 않았습니다.

APIERR_WINDNOTEXIST

참조한 창이 존재하지 않습니다.

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

 

설명

이 함수는 텍스트 창에 새로운 라인들을 이어붙이는 데 사용합니다.

동일한 애드온에서 APIDb_NewWindowID로 연 커스텀 텍스트 창들에 대해서만 사용할 수 있습니다. Report Window, Missing Library Parts Window 등에는 이 함수를 활용할 수 없습니다.

문자열은 '\0'으로 끝나야 합니다. 라인 피드는 '\n' 문자와 함께 전달되어야 합니다.

 

예제

API_WindowInfo      windowInfo;
char                buffer[256];
GSErrCode           err;

BNZeroMemory (&windowInfo, sizeof (API_WindowInfo));
windowInfo.typeID = APIWind_MyTextID;
windowInfo.refCon = 1;

sprintf (buffer, "Number of lines: %d\nOK\n", nLine);

err = ACAPI_Database (APIDb_AddTextWindowContentID, &windowInfo, buffer);

 

요구사항

버전: API 4.1 또는 이후

헤더: APIdefs_Database.h

 

참고사항

API_WindowInfo,
APIDb_NewWindowID,
ACAPI_Database, API 함수