DGCreateModelessDialog

Modeless 다이얼로그를 생성하고 보여주지는 않습니다.

    short DGCreateModelessDialog (
      short                 resId,
      const DGDialCallBack  dCallBack,
      DGUserData            userData
    );

파라미터

resId

다이얼로그의 GDLG 리소스 식별자입니다.

 

dCallBack

다이얼로그 콜백 프로세지에 대한 상수 포인터입니다.

 

userData

다이얼로그의 사용자 지정 데이터입니다.

리턴 값

만약 성공적으로 생성되면 다이얼로그의 ID입니다. 만약 함수 파라미터들 또는 GRC 설명이 올바르지 않으면 0입니다.

설명

이 함수는 GRC 리소스에서 정의된 Modeless 다이얼로그의 창, 다이얼로그 항목들과 내부 데이터를 생성합니다. 다이얼로그가 생성되자마자 즉시 리턴합니다. 이것은 다이얼로그를 보여주지 않으며 이벤트 처리도 시작하지 않습니다. 다이얼로그 콜백 함수에서 다이얼로그 메시지들을 받으려면, DGBeginProcessEvents 함수로 이벤트 처리를 시작해야 합니다. 이벤트 처리를 시작한 후에 다이얼로그를 보여주려면 DGShowModelessDialog를 사용하십시오.

애플리케이션은 리턴된 다이얼로그 ID를 저장하고 고정 리소스 ID 대신 차후 DG 함수 호출에서 이 값을 사용해야 합니다. 기본적으로 이것이 필수인 2가지 경우가 있습니다:

• 당신이 어떤 다이얼로그의 인스턴스를 다수 생성하고 싶을 때 (동일 리소스 기반으로)
• 동일한 리소스 ID를 갖는 서로 다른 모듈로 정의된 동알한 타입의 더 많은 다이얼로그를 열고 싶을 때

그러한 경우 DG는 리소스 충돌을 해결하기 위해 2번째 및 차후 DGCreateModelessDialog 호출에서 새로운 (음수) 유일 다이얼로그 ID들을 생성합니다. 만약 애플리케이션이 하나의 모듈로 구성되고 모든 다이얼로그를 1번만 연다고 하더라도 이 방법에 익숙해지는 것을 매우 권장합니다.

userData 파라미터로 주어지는 사용자 데이터 블록은 모든 DG 메시지와 함께 다이얼로그 콜백 함수로 전달됩니다. 애플리케이션은 다이얼로그 지정 정보를 이 데이터 블록에 저장하고 해당 포인터를 DGUserData로 캐스팅할 수 있습니다.

Modeless 다이얼로그들은 빈 다이얼로그를 생성하는 DGCreateBlankModelessDialog 함수를 사용하여 리소스 없이 생성할 수 있습니다. 생성한 다이얼로그에 다이얼로그 항목들을 붙이기 위해 DGAppendDialogItem 함수를 사용하십시오.

요구사항

버전: DG 2.0.0 또는 이후

헤더: DG.h

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

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

참고사항

DG 함수, Modeless 다이얼로그, Palette 다이얼로그
DGCreateBlankModelessDialog, DGDestroyModelessDialog
DGModelessInit, DGModelessClose, DGModelessHandler, DGShowModelessDialog, DGCreatePalette, DGCreateBlankPalette, DGCreateBlankDockablePalette, DGCreateDockablePalette, DGAppendDialogItem, DGBeginProcessEvents
콜백 함수, DG 메시지