DGModelessInit
Modeless 또는 Palette 다이얼로그를 초기화합니다.
short DGModelessInit ( short resId, const DGDialCallBack dCallBack, DGUserData userData short show );
파라미터
- resId
- 다이얼로그의 GDLG 리소스 식별자입니다.
- dCallBack
- 다이얼로그 콜백 프로시저에 대한 상수 포인터입니다.
- userData
- 다이얼로그의 사용자 지정 데이터입니다.
- show
-
값 의미 0 DGModelessInit이 다이얼로그를 표시하지 않습니다. 1 DGModelessInit이 다이얼로그를 표시합니다.
리턴 값
만약 성공적으로 초기화되면 다이얼로그의 ID를 리턴하고, 만약 함수 파라미터들이나 GRC 설명이 올바르지 않으면 0을 리턴합니다.
설명
DGModelessInit은 다이얼로그가 생성되자마자 즉시 리턴합니다. 만약 Modeless 또는 Palette 다이얼로그가 0 값을 갖는 show 파라미터로 생성되면, DGModelessInit은 리턴하기 전에 다이얼로그를 보여주지 않습니다. 나중에 다이얼로그를 보여주려면 DGShowModelessDialog 함수를 사용하십시오. 다이얼로그가 생성된 후에 이 함수는 이벤트 처리 또한 시작합니다. 더 자세한 것은 DGBeginProcessEvents와 DGEndProcessEvents를 보십시오.
애플리케이션은 다이얼로그 콜백 함수에서 리턴된 다이얼로그 ID를 저장하고, 고정 리소스 ID 대신 다음에 DG 함수를 호출할 때 이 값을 사용해야 합니다. 기본적으로 이것이 필수인 2가지 상황이 있습니다:
- 당신이 어떤 다이얼로그의 인스턴스를 다수 생성하고 싶을 때 (동일 리소스 기반으로)
- 동일한 리소스 ID를 갖는 서로 다른 모듈로 정의된 동알한 타입의 더 많은 다이얼로그를 열고 싶을 때
그러한 경우 DG는 리소스 충돌을 해결하기 위해 2번째 및 차후 DGModelessInit 호출에서 새로운 (음수) 유일 다이얼로그 ID들을 생성합니다. 만약 애플리케이션이 하나의 모듈로 구성되고 모든 다이얼로그를 1번만 연다고 하더라도 이 방법에 익숙해지는 것을 매우 권장합니다.
userData 파라미터로 주어지는 사용자 데이터 블록은 모든 DG 메시지와 함께 다이얼로그 콜백 함수로 전달됩니다. 애플리케이션은 다이얼로그 지정 정보를 이 데이터 블록에 저장하고 해당 포인터를 DGUserData로 캐스팅할 수 있습니다.
요구사항
- 버전: DG 2.0.0 또는 이후
- 헤더: DG.h
- 라이브러리 가져오기: DG.lib [WIN]
- 모듈: DGLib [MAC], DG.dll [WIN]
참고사항
DG 함수, Modeless 다이얼로그, Palette 다이얼로그
DGModelessClose
DGModelessHandler, DGShowModelessDialog, DGBeginProcessEvents, DGEndProcessEvents, DGCreateModelessDialog, DGCreateBlankModelessDialog, DGDestroyModelessDialog, DGCreatePalette, DGCreateBlankPalette, DGCreateBlankDockablePalette, DGCreateDockablePalette, DGDestroyPalette
콜백 함수, DG 메시지