APIIo_SetMenuItemFlagsID

지정한 메뉴 항목의 flag 값들을 세트합니다.

    GSErrCode ACAPI_Interface (
        APIIo_SetMenuItemFlagsID,
        const API_MenuItemRef*     menuItemRef,
        GSFlags                    itemFlags
    );

 

파라미터

menuItemRef

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

itemFlags

[in] 메뉴 항목 flag들입니다.

Flag 값	의미
API_MenuItemDisabled	메뉴 항목을 비활성화합니다.
API_MenuItemChecked	메뉴 항목을 체크합니다.

 

리턴 값

NoError

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

APIERR_BADPARS

파라미터들 중 하나 이상이 NULL입니다.

APIERR_BADINDEX

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

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

 

설명

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

메뉴 항목의 현재 상태를 가져오려면 APIIo_GetMenuItemFlagsID 함수를 사용하십시오.

메뉴 항목의 초기 상태는 애드온의 메뉴 항목 문자열 리소스들에서도 세트할 수 있다는 것을 참고하십시오. 필수 리소스 페이퍼에 자세히 설명하고 있는 STR# 사양을 참조하십시오.

 

예제

// -----------------------------------------------------------------------------
// 애드온의 메뉴 항목에 체크 마크를 표시함
// -----------------------------------------------------------------------------

static void             CheckACMenuItem (short itemInd, bool checked)
{
        API_MenuItemRef itemRef;
        GSFlags         itemFlags;

        BNZeroMemory (&itemRef, sizeof (API_MenuItemRef));
        itemRef.menuResID = 32500;
        itemRef.itemIndex = itemInd;

        itemFlags = 0;
        ACAPI_Interface (APIIo_GetMenuItemFlagsID, &itemRef, &itemFlags);
        if (checked)
                itemFlags |= API_MenuItemChecked;
        else
                itemFlags &= ~API_MenuItemChecked;
        ACAPI_Interface (APIIo_SetMenuItemFlagsID, &itemRef, &itemFlags);

        return;
}               // CheckACMenuItem

 

요구사항

버전: API 2.1 또는 이후

헤더: APIdefs_Interface.h

 

참고사항

API_MenuItemRef,
APIIo_GetMenuItemFlagsID,
ACAPI_Interface, API 함수