DGBlankModalDialog

Modal 다이얼로그를 표시합니다. 다이얼로그는 리소스 데이터 없이 생성됩니다.

    short DGBlankModalDialog (
      short                 hSize,
      short                 vSize,
      short                 growFlag,
      short                 captionFlag,
      short                 frameFlag,
      const DGDialCallBack  dCallBack,
      DGUserData            userData
    );

파라미터

hSize

다이얼로그의 수평 크기입니다.

 

vSize

다이얼로그의 수직 크기입니다.

 

growFlag

Flag	설명
DG_DLG_NOGROW	다이얼로그는 리사이즈할 수 없습니다.
DG_DLG_HGROW	다이얼로그는 수평 방향으로 리사이즈 할 수 있습니다.
DG_DLG_VGROW	다이얼로그는 수직 방향으로 리사이즈 할 수 있습니다.

수평/수직 방향으로 리사이즈 할 수 있게 하려면, growFlag 파라미터를 DG_DLG_HGROW | DG_DLG_VGROW로 세트하십시오.

 

captionFlag

Flag	설명
DG_DLG_NOCAPTION	다이얼로그는 캡션이 없습니다.
0	다이얼로그는 위에 캡션이 있습니다.

 

frameFlag

Flag	설명
DG_DLG_NOFRAME	다이얼로그는 프레임이 없습니다.
DG_DLG_THICKFRAME	다이얼로그는 두꺼운 프레임을 갖고 있습니다.
DG_DLG_NORMALFRAME	다이얼로그는 일반 프레임을 갖고 있습니다.

 

dCallBack

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

 

userData

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

리턴 값

값	의미
0	함수 파라미터들이 올바르지 않거나 다이얼로그를 생성할 수 없습니다.
양수	다이얼로그 콜백 함수에 의해 양수가 리턴됩니다. 이것은 보통 클릭한 버튼의 1-기반 다이얼로그 항목 인덱스입니다.
DG_ABORT	Modal 다이얼로그가 DGAbortModalDialog에 의해 중단되었습니다.
Windows 전용:
DG_CLOSEBOX	다이얼로그가 닫힘 받스에 의해 닫혔습니다.

설명

DGBlankModalDialog는 Modal 다이얼로그가 사용자나 프로그램 코드에 의해 닫혔을 때에만 리턴합니다.

애플리케이션은 다이얼로그 콜백 함수에서 DG_MSG_INIT 메시지를 처리할 때 다이얼로그 ID를 저장하고 다음 DG 함수 호출에 이 값을 사용해야 합니다.

DGBlankModalDialog는 Modal 다이얼로그가 닫힐 때에만 리턴합니다. 사용자는 보통 OK 또는 Cancel 버튼을 클릭하여 Modal 다이얼로그를 닫습니다. 다이얼로그 콜백 함수는 DG_OK 또는 DG_CANCEL을 item 파라미터로 하는 DG_MSG_CLICK 메시지를 수신합니다. Windows에서 사용자가 캡션에 있는 닫힘 상자를 클릭하면 item 파라미터는 DG_CANCEL(또는 다이얼로그에 Cancel 버튼이 없는 경우 DG_OK)입니다. 다이얼로그는 콜백 함수가 DG_MSG_CLICK 메시지에 대해 0이 아닌 값(일반적으로 DG_OK 또는 DG_CANCEL)을 리턴하는 경우에만 실제로 닫힙니다. 애플리케이션은 이 리턴 값을 사용하여 Modal 다이얼로그가 작업을 성공적으로 완료했는지 또는 사용자가 취소했는지 여부를 결정할 수 있습니다.

또한 Modal 다이얼로그는 DGAbortModalDialog 함수를 호출하거나 다이얼로그 콜백 함수에서 DG_MSG_NULL 메시지에 대한 0이 아닌 값을 리턴하여 프로그램 코드에서 종료할 수 있습니다. DGAbortModalDialog가 호출되면 콜백 함수는 DG_ABORT를 item 파라미터로 한 DG_MSG_CLOSE 메시지를 수신하고 DGBlankModalDialog는 DG_ABORT를 리턴합니다.

DGBlankModalDialog로 생성된 다이얼로그는 처음에 다이얼로그 항목들이 없습니다. DGAppendDialogItem 함수로 다이얼로그 항목들을 추가할 수 있습니다.

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

GRC 리소스에 정의된 Modal 다이얼로그는 DGModalDialog를 사용하여 표시할 수 있습니다. 이 함수는 다이얼로그 항목들도 만듭니다.

요구사항

버전: DG 2.0.0 또는 이후

헤더: DG.h

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

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

참고사항

DG 함수, Modal 다이얼로그
DGAbortModalDialog, DGAppendDialogItem, DGModalDialog
DG_MSG_CLICK, DG_MSG_INIT, DG_MSG_NULL, 콜백 함수