APIIo_GetMenuItemTextID

지정한 메뉴 항목의 텍스트를 리턴합니다.

    GSErrCode ACAPI_Interface (
        APIIo_GetMenuItemTextID,
        const API_MenuItemRef*     menuItemRef,
        char*                      itemText,
        GS::UniString*             itemUniText
    );

 

파라미터

itemRef

[in] 메뉴 항목을 식별합니다.

itemText

[out] 메뉴 항목 텍스트입니다. (만약 당신이 itemUniText에게 전달하지 않은 경우)

itemUniText 

[out] 세트하고자 하는 선택적인 Unicode 메뉴 항목 텍스트입니다.

 

리턴 값

NoError

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

APIERR_BADPARS

menuItemRef 또는 itemText와 itemUniText 둘 다 NULL입니다.

APIERR_BADINDEX

지정한 메뉴 항목이 호출자 애드온에게 속해 있지 않습니다.

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

 

설명

이 함수는 호출자 API 도구 애드온에 속한 메뉴 항목의 텍스트를 가져오는 데 사용합니다. 메뉴 항목은 리소스 ID와 문자열 번호로 참조됩니다.

메뉴 항목의 텍스트를 변경하려면 APIIo_SetMenuItemTextID 함수를 사용하십시오.

 

예제

void    ReportChosenCommand (short menuResID, short itemInd)

{
    API_MenuItemRef     itemRef;
    char                itemStr [256], message [256];

    BNZeroMemory (&itemRef, sizeof (API_MenuItemRef));
    itemRef.menuResID = menuResID;
    itemRef.itemIndex = itemInd;
    if (ACAPI_Interface (APIIo_GetMenuItemTextID, &itemRef, itemStr) == NoError) {
        sprintf (message, "You have chosen the %s command", itemStr);
        ACAPI_WriteReport (itemStr, true);
    }

    return;
}

 

요구사항

버전: API 2.1 또는 이후

헤더: APIdefs_Interface.h

 

참고사항

API_MenuItemRef,
APIIo_SetMenuItemTextID,
ACAPI_Interface, API 함수