ACAPI_Resource_GetLocUStr

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

    bool  ACAPI_Resource_GetLocUStr (
        GS::uchar_t*     str,
        short            resID,
        short            index,
        GSResModule      resModule = ACAPI_GetOwnResModule ()
    );

 

파라미터

str

[out] 문자열의 포인터입니다.

resID

[in] GRC 파일 안에 있는 'STR#' 리소스의 리소스 ID입니다.

index

[in] 리소스의 문자열의 인덱스입니다.

resModule

[in] 리소스를 로드할 리소스 모듈입니다. 기본값은 애드온의 자체 리소스 모듈입니다.

 

리턴 값

true

문자열을 성공적으로 가져왔습니다.

false

문자열을 가져오지 못했습니다.

 

설명

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

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

 

예제

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

'STR#' 32530 "Localizable strings" {
/* [  1] */ "Saving the file in abc format"
/* [  2] */ "MISSING"
}

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

UC257HeadData  header;
bool           succ;

succ = ACAPI_Resource_GetLocUStr (header.missingName, 32530, 2, ACAPI_GetOwnResModule ());

if (succ) {
    ...
}

 

요구사항

버전: API 16 또는 이후

헤더: ACAPinc.h

 

참고사항

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