APIIo_SetMenuItemTextID

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

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

 

파라미터

menuItemRef

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

itemText

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

itemUniText 

[in] 세트할 선택적인 Unicode 메뉴 항목 텍스트입니다.

 

리턴 값

NoError

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

APIERR_BADPARS

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

APIERR_BADINDEX

지정한 메뉴 항목은 호출자 애드온에게 속하지 않았습니다.

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

 

설명

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

메뉴 항목의 현재 텍스트를 가져오려면 APIIo_GetMenuItemTextID 함수를 사용하십시오.

 

예제

void    SetPaletteMenuText (short paletteItemInd, bool paletteIsVisible)

{
    API_MenuItemRef     itemRef;
    GS::UniString       itemStr;

    if (paletteIsVisible)
        itemStr.Append ("Hide Palette");
    else
        itemStr.Append ("Show Palette");

    BNZeroMemory (&itemRef, sizeof (API_MenuItemRef));
    itemRef.menuResID = 32500;
    itemRef.itemIndex = paletteItemInd;
    ACAPI_Interface (APIIo_SetMenuItemTextID, &itemRef, NULL, itemStr);

    return;
}

 

요구사항

버전: API 2.1 또는 이후

헤더: APIdefs_Interface.h

 

참고사항

API_MenuItemRef,
APIIo_GetMenuItemTextID,
ACAPI_Interface, API 함수