DGAppendDialogItem

다이얼로그 항목을 다이얼로그의 항목 리스트 끝에 추가합니다.

    short DGAppendDialogItem (
      short  dialId,
      short  itemType,
      short  itemSubType,
      short  itemData,
      short  hPos,
      short  vPos,
      short  hSize,
      short  vSize
    );

파라미터

dialId

다이얼로그 또는 탭 페이지의 ID입니다. DG_TOP_MODAL은 최상의 Modal 다이얼로그를 지정합니다.

 

itemType

다이얼로그 항목의 타입입니다.

 

itemSubType

다이얼로그 항목의 서브 타입입니다.

 

itemData

다이얼로그 항목의 추가 데이터입니다.

 

hPos

다이얼로그 항목의 수평 위치입니다. (픽셀 단위) 다이얼로그 클라이언트 직사각형에 상대적입니다.

 

vPos

다이얼로그 항목의 수직 위치입니다. (픽셀 단위) 다이얼로그 클라이언트 직사각형에 상대적입니다.

 

hSize

다이얼로그 항목의 수평 크기입니다 (픽셀 단위)

 

vSize

다이얼로그 항목의 수직 크기입니다 (픽셀 단위)

리턴 값

새로 생성된 다이얼로그 항목의 1-기반 인덱스입니다. (다이얼로그 항목들의 현재 개수와 동일함) 만약 오류가 발생하면 0입니다.

설명

다이얼로그 항목들은 GRC 또는 프로그램 코드로 생성한 다이얼로그에 추가될 수 있습니다. 만약 당신이 DGModalDialog 또는 제로(0) 값인 resId 파라미터를 가진 DGModelessInit 함수를 호출하여 빈 다이얼로그를 생성하면, 당신은 다이얼로그 콜백 함수에서 DG_MSG_INIT 메시지를 처리할 때 DGAppendDialogItem를 사용하여 항목들로 다이얼로그를 채울 수 있습니다.

다음 표는 DGAppendDialogItem로 생성할 수 있는 다이얼로그 항목 타입들을 요약한 것입니다. 이 표는 함수의 itemType과 itemSubType 파라미터의 가능한 값들을 포함합니다. 일부 타입의 다이얼로그 항목들은 1개 이상의 수정 flag들을 가질 수 있습니다. 또한 이것은 비트 또는 (|) 연산자를 이용하여 itemSubType 파라미터에 주어질 수 있습니다. 이 수정 flag들에 대한 자세한 정보는 다이얼로그 항목들의 설명을 보십시오. 마지막 열은 추가 itemData 파라미터의 의미를 설명합니다.

항목 타입	itemType	itemSubType	itemData
체크박스	DG_ITM_CHECKBOX	DG_BT_TEXT DG_BT_ICON DG_BT_PUSHTEXT DG_BT_PUSHICON
날짜 & 시간 컨트롤	DG_ITM_DATETIME	DG_DT_DATE DG_DT_TIME
Edit 컨트롤	DG_ITM_EDITTEXT	DG_ET_TEXT DG_ET_MULTILINETEXT DG_ET_PASSWORD DG_ET_REAL DG_ET_ANGLE DG_ET_POLARANGLE DG_ET_LENGTH DG_ET_MM_OR_PT DG_ET_INT DG_ET_POSINT	텍스트의 최대 길이 (바이트 단위) (DG_ET_TEXT와 DG_ET_PASSWORD 서브 타입에 대해서만)
그룹 박스	DG_ITM_GROUPBOX	DG_GT_PRIMARY DG_GT_SECONDARY
아이콘	DG_ITM_ICONITEM		프레임 타입
리스트 박스	DG_ITM_LISTBOX	DG_LT_SINGLESELECT DG_LT_MULTISELECT	만약 DG_LT_HEADER flag가 있으면 헤더 높이입니다.
리스트 뷰	DG_ITM_LISTVIEW	DG_LVT_SINGLESELECT DG_LVT_MULTISELECT	뷰 모드
그림	DG_ITM_PICTITEM		프레임 타입
팝업 컨트롤	DG_ITM_POPUPCONTROL	리스트 높이 (Windows 전용)	항목 텍스트의 왼쪽 여백 (Windows 전용)
진행 바	DG_ITM_PROGRESSBAR		프레임 타입
푸시 버튼	DG_ITM_BUTTON	DG_BT_ICONTEXT DG_BT_ICON
푸시 메뉴 컨트롤	DG_ITM_CHECKBOX DG_ITM_RADIOBUTTON	DG_BT_PUSHMENUICON
라디오 버튼	DG_ITM_RADIOBUTTON	DG_BT_TEXT DG_BT_ICON DG_BT_PUSHTEXT DG_BT_PUSHICON	그룹 ID
Rich Edit 컨트롤	DG_ITM_EDITTEXT	DG_ET_RICHEDITTEXT
스크롤 바	DG_ITM_SCROLLBAR	DG_SB_NORMAL DG_SB_PROPORTIONAL DG_SB_NOAUTOSCROLL DG_SB_NONFOCUSABLE
구분자 항목	DG_ITM_SEPARATOR
슬라이더 바	DG_ITM_SLIDER	DG_SL_BOTTOMRIGHT DG_SL_TOPLEFT	Tick 마크의 수 - 1, 또는 Tick 마크가 없을 경우 0
스핀 컨트롤	DG_ITM_SPINCONTROL	DG_ST_SINGLESPIN DG_ST_EDITSPIN	관련 Edit 컨트롤의 인덱스 (DG_ST_EDITSPIN 서브 타입에 대해서만)
정적 텍스트	DG_ITM_STATICTEXT	DG_IS_LEFT DG_IS_CENTER DG_IS_RIGHT	프레임 타입
탭 컨트롤	DG_ITM_TABCONTROL	DG_TT_NORMALTAB DG_TT_SIMPLETAB	프레임 타입
트리 뷰	DG_ITM_TREEVIEW	DG_TVT_SINGLESELECT DG_TVT_MULTISELECT	항목 라벨의 최대 길이 (Editable인 경우에만)
유저 컨트롤	DG_ITM_USERCONTROL		컨트롤 정의 프로시저 ID
유저 아이템	DG_ITM_USERITEM	DG_UT_NORMALUPDATE DG_UT_PARTIALUPDATE	프레임 타입

추가된 다이얼로그 항목들의 나머지 프로퍼티(텍스트, 글꼴, 값 등)들은 항목이 생성된 후에 DG 함수로 세트할 수 있습니다. 이 함수들은 DGAppendDialogItem이 리턴한 항목 인덱스를 사용합니다.

요구사항

버전: DG 2.0.0 또는 이후

헤더: DG.h

라이브러리 가져오기: DG.lib [WIN]

모듈: DGLib [MAC], DG.dll [WIN]

참고사항

DG 함수, DGRemoveDialogItems
다이얼로그 항목 타입, 콜백 함수, DGModelessInit, DGModalDialog, DG_MSG_INIT