ACAPI_Register_SettingsPanel

요소 Settings 다이얼로그에 커스텀 패널을 붙입니다.

    GSErrCode  ACAPI_Register_SettingsPanel (
        Int32                   refCon,
        API_ElemTypeID          tool,
        API_ElemVariationID     variation,
        short                   iconId,
        short                   stringId,
        short                   pageId,
        short                   growType,
        bool                    visibleByDefault
    );

 

파라미터

refCon

[in] 이 패널에 대하여 선택한 유일 레퍼런스 번호입니다.

tool

[in] Settings 다이얼로그를 식별하는 요소 타입입니다.

variation

[in] 동일한 타입의 요소 종류들을 구별하는 요소 variation입니다.

iconId

[in] 패널 아이콘 리소스 ID입니다.

stringId

[in] 패널의 핸들러 영역에 나타나는 타이틀 텍스트입니다.

pageId

[in] 탭 페이지의 다이얼로그 리소스 ID입니다.

growType 

[in] 탭 페이지의 성장 타입입니다: DG_DLG_NOGROW, DG_DLG_HGROW, DG_DLG_VGROW, 또는 DG_DLG_HGROW | DG_DLG_VGROW가 될 수 있습니다. 이 파라미터는 선택적입니다. 기본값은 DG_DLG_NOGROW입니다.

visibleByDefault 

[in] 패널을 기본적으로 보여주거나 숨깁니다. (선택적인 파라미터이며, 생략하면 false입니다)

 

리턴 값

APIERR_BADPARS

전달된 요소 타입이 유효하지 않습니다.

APIERR_BADID

전달된 tool / variation 파라미터 쌍(pair)이 유효한 툴박스 항목을 식별하지 않습니다. (보이지 않는 도구들 포함)

NoError

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

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

 

설명

이 함수는 새로운 패널을 tool과 variation으로 지정한 요소 Settings 다이얼로그에 붙입니다. 패널 생성/파괴 이벤트들을 가져오기 위해서는 ACAPI_Install_PanelHandler로 패널 핸들러 콜백 함수들을 설치해야 합니다.

더 자세한 것은 Settings 다이얼로그에서의 커스텀 패널의 일반적인 설명을 참조하십시오.

 

예제

GRC 파일 내 리소스들:

'STR#' 32550 "Panel test settings page" {
/* [  1] */         "Panel test settings page"
}

'GDLG' 32701  TabPage           0    0  444   50  "Panel test settings page" {
/* [  1] */ LeftText            0    3   80   18  LargePlain  vCenter  "Alternate Name:"
/* [  2] */ TextEdit           84    4  136   16  LargePlain  15
/* [  3] */ LeftText            0   28   50   18  LargePlain  vCenter  "U-Value:"
/* [  4] */ RealEdit           84   29   40   16  LargePlain  "0.0" "10.0"
/* [  5] */ LeftText          224   28   50   18  LargePlain  vCenter  "Height:"
/* [  6] */ LengthEdit        278   29   70   16  LargePlain  "0.0" "1000000"
}

'GICN' 32650  "Settings page icon" {
        "Panel_Icon"
        0  128  128
}

RegisterInterface 함수 내 등록:

// -----------------------------------------------------------------------------
// 인터페이스 정의
// -----------------------------------------------------------------------------
GSErrCode    __ACENV_CALL   RegisterInterface (void)
{
    GSErrCode err = ACAPI_Register_SettingsPanel (1, API_WallID, APIVarId_Generic, 32650, 32550, 32701);
    if (err != NoError) {
        DBPRINTF ("Panel_Test add-on: Cannot register element settings panel\n");
    }

    return NoError;
}

 

요구사항

버전: API 4.1 또는 이후

헤더: ACAPinc.h

 

참고사항

API_ElemTypeID
API_ElemVariationID
ACAPI_Install_PanelHandler
ACAPI_Register_InfoBoxPanel
ACAPI_Register_AttributePanel
Settings 다이얼로그에서의 커스텀 패널
API 함수