Graphisoft®

API Development KitVersion: 18

ACAPI_Resource_GetLocStr

'STR#' 문자열 리스트 리소스로부터 하나의 문자열을 읽어옵니다.

    bool  ACAPI_Resource_GetLocStr (
        char*           str,
        short           resID,
        short           index,
        GSResModule     resModule = ACAPI_GetOwnResModule ()
    );

 

파라미터

str
[out] 문자열의 포인터입니다.
resID
[in] GRC 파일 안에 있는 'STR#' 리소스의 리소스 ID입니다.
index
[in] 리소스의 문자열의 인덱스입니다.
resModule New in API 16
[in] 리소스를 로드할 리소스 모듈입니다. 기본값은 애드온의 자체 리소스 모듈입니다.

 

리턴 값

true
문자열을 성공적으로 가져왔습니다.
false
문자열을 가져오지 못했습니다.

 

설명

이 함수는 지역화가 필요한 문자열 리스트 리소스에서 문자열을 로드하는 데 사용됩니다.

GRC 컴파일러는 이러한 목적으로 'STR#' 리소스 타입을 사용합니다. 리소스의 다른 라인들은 index 파라미터로 참조되는 인덱스입니다. GRC 파일의 구조에 대한 자세한 내용은 GRC 문서를 참조하십시오.

 

예제

/* 이것은 GRC 파일의 according 파트입니다: */

'STR#' 32510 "Fix strings" {
/* [  1] */ "Saving the file in abc format"
/* [  2] */ "You have canceled the operation!"
}

/* 애드온의 소스에서 이렇게 참조될 수 있습니다 */

char          own_res_str[256];
bool          succ;

succ = ACAPI_Resource_GetLocStr (own_res_str, 32510, 1, ACAPI_GetOwnResModule ());

if (succ) {
    /* Report 창에 문자열 출력하기 */
    ACAPI_WriteReport (own_res_str, false);
}

Report 창에 다음과 같은 내용이 나옵니다: "Saving the file in abc format".

 

요구사항

버전: API 2.1 또는 이후
헤더: ACAPinc.h

 

참고사항

ACAPI_Resource_GetLocUStr, ACAPI_Resource_GetFixStr, ACAPI_GetOwnResModule,
리소스 관리자, API 함수