APIIo_GetMenuItemFlagsID

API 도구 애드온에 의해 마운트된 지정된 메뉴 항목의 flag 값들을 리턴합니다.

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

 

파라미터

menuItemRef

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

itemFlags

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

Flag 값	의미
API_MenuItemDisabled	메뉴 항목은 현재 비활성화되어 있습니다.
API_MenuItemChecked	메뉴 항목이 현재 체크되어 있습니다.

 

리턴 값

NoError

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

APIERR_BADPARS

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

APIERR_BADINDEX

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

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

 

설명

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

메뉴 항목의 상태를 변경하려면 APIIo_SetMenuItemFlagsID 함수를 사용하십시오.

 

예제

void    EnableACMenuItem (short itemInd, bool enable)
{
    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 (enable)
        itemFlags &= ~API_MenuItemDisabled;
    else
        itemFlags |= API_MenuItemDisabled;
    ACAPI_Interface (APIIo_SetMenuItemFlagsID, &itemRef, &itemFlags);

    return;
}       // EnableACMenuItem

 

요구사항

버전: API 2.1 또는 이후

헤더: APIdefs_Interface.h

 

참고사항

API_MenuItemRef,
APIIo_SetMenuItemFlagsID,
ACAPI_Interface, API 함수