다이얼로그 타입의 GRC 사양

DG 모듈을 이용하여 다이얼로그를 생성하는 2가지 방법이 있습니다. 코드로부터 혹은 리소스 스크립트로부터 생성할 수 있습니다. 리소스 스크립트에 정의된 다이얼로그를 생성하려면, 애플리케이션은 반드시 GRC 파일 안에 GDLG 리소스를 제공해야 합니다. 이것은 다이얼로그의 크기, 스타일, 내용을 설명합니다. 이 페이지는 DG 모듈이 제공하는 다이얼로그 타입들의 GRC 사양에 대한 모든 필수 정보를 접근하는 데 도움을 줍니다.

경고
Modal 다이얼로그
Modeless 다이얼로그
Palette 다이얼로그

경고의 GRC 사양

    'GALR'  resID  iconID  ["title"] {
      "largeText" (\)
      "smallText" (\)
      "button1"
      "button2"
      "button3"
    }

여기서 resID는 경고의 리소스 ID이며, iconID는 경고의 아이콘 리소스 ID입니다. 선택적인 title 파라미터는 경고의 타이틀을 정의합니다. largeText와 smallText는 경고의 1번째와 2번째 텍스트 필드의 텍스트입니다. 라인의 끝에 backslash (\) 문자들을 사용하면 여러 라인의 문자열을 작성할 수 있습니다. button1, button2, button3들은 버튼 텍스트입니다.

설명

DGResAlert와 DGResAlertParam은 동일한 GRC 사양을 사용합니다. 유일한 차이점은 largeText와 smallText가 DGResAlertParam에 대한 GALR 리소스에서 최대 4개의 "%s" 포맷 지정자를 포함할 수 있다는 것입니다. 경고를 표시하기 전에, 이 포맷 지정자들은 외관의 순서대로 DGResAlertParam의 paramText1, paramText2, paramText3, paramText4 파라미터들로 대체됩니다.

만약 DGAlert의 iconID 파라미터 또는 GALR 리소스가 유효한 아이콘 리소스 ID일 경우, 경고는 리소스로부터 로드한 커스텀 컬러 아이콘을 표시합니다. 그러나 만약 이 파라미터가 다음의 특수 상수들 중 하나라면, 경고 아이콘뿐만 아니라 경고의 타입과 타이틀도 결정합니다.

iconID	경고 타입	의미	Macintosh 아이콘	Windows 아이콘
Error	DG_ERROR	Macintosh의 경우 Stop; Windows의 경우 Error
Information	DG_INFORMATION	Macintosh의 경우 Note; Windows의 경우 Information
Warning	DG_WARNING	Macintosh의 경우 Caution; Windows의 경우 Warning

만약 DGAlert의 titleText 파라미터가 NULL이거나, GALR 리소스의 선택적인 title 파라미터가 생략되어 있으면, 경고는 Macintosh의 경우 타이틀이 없으며, Windows의 경우 DGInit에 주어진 적절한 표준 경고 타이틀을 사용합니다.

1번째와 2번째 텍스트 필드의 텍스트들은 각각 large plain과 small plain 글꼴을 사용하여 그려집니다. 만약 DGAlert의 largeText 또는 smallText 파라미터가 NULL이거나, GALR 리소스의 해당 문자열이 비어 있을 경우(""), 경고의 1번째 또는 2번째 텍스트 필드가 없습니다. 그러나 경고에서 두 필드 모두 누락되어서는 안 된다는 것을 참고하십시오.

만약 DGAlert의 button1Text, button2Text 또는 button3Text 파라미터가 NULL이거나, GALR 리소스의 button1, button2 또는 button3 문자열이 비어 있으면(""), 각각 1번째, 2번째 또는 3번째 버튼이 존재하지 않게 됩니다. 그러나 경고에 최소한 1개 버튼이 존재해야 한다는 것을 참고하십시오.

Modal 다이얼로그의 GRC 사양

    'GDLG'  resID  Modal [| frameFlag | growFlag | captionFlag]  x  y  dx  dy  "dlgTitle" {
      dialogItem1
          ...
      dialogItemi
          ...
      dialogItemn
    }

여기서 resID는 Modal 다이얼로그의 리소스 ID입니다. Modal 키워드는 OR (|) 연산자를 이용하여 선택적인 frameFlag, growFlag 그리고 captionFlag와 함께 결합될 수 있습니다. 만약 frameFlag를 생략하면, 다이얼로그는 일반 프레임을 갖습니다. 만약 growFlag를 생략하면, 다이얼로그는 성장할 수 없습니다. 만약 captionFlag를 지정하지 않으면, 다이얼로그는 기본적으로 위에 캡션을 갖게 됩니다. x와 y는 다이얼로그의 좌상단 코너의 픽셀 좌표입니다. dx와 dy는 다이얼로그의 너비와 높이의 픽셀 크기입니다. dlgTitle은 다이얼로그의 타이틀을 정의합니다. dialogItemi (1 <= i <= n)는 다이얼로그 항목들의 n 조각들을 지정합니다. 다양한 다이얼로그 항목들의 GRC 사양들에 대해서는 DG 다이얼로그 항목 페이지를 보십시오.

frameFlag의 가능한 값은 다음과 같습니다:

값	의미
normalFrame	다이얼로그가 일반 다이얼로그 프레임을 갖고 있습니다.
thickFrame	다이얼로그가 두꺼운 프레임을 갖고 있습니다.
noFrame	다이얼로그가 프레임을 갖고 있지 않습니다.

growFlag의 가능한 값은 다음과 같습니다:

값	의미
noGrow	다이얼로그의 크기를 바꿀 수 없습니다.
hGrow	다이얼로그의 크기를 수평 방향으로 바꿀 수 있습니다.
vGrow	다이얼로그의 크기를 수직 방향으로 바꿀 수 있습니다.
grow	다이얼로그의 크기를 수평, 수직 방향으로 바꿀 수 있습니다.

captionFlag의 가능한 값은 다음과 같습니다:

값	의미
noCaption	다이얼로그가 캡션이 없습니다.

Modeless 다이얼로그의 GRC 사양

    'GDLG'  resID  Modeless [| frameFlag | growFlag | captionFlag | closeFlag | minimizeFlag | maximizeFlag]  x  y  dx  dy  "dlgTitle" {
      dialogItem1
          ...
      dialogItemi
          ...
      dialogItemn
    }

resID는 Modeless 다이얼로그의 리소스 ID입니다. Modeless 키워드는 OR (|) 연산자를 이용하여 선택적인 frameFlag, growFlag, captionFlag, closeFlag, minimizeFlag 그리고 maximizeFlag와 함께 결합될 수 있습니다. 만약 이 flag들을 생략하면, 캡션이 위에 있고 닫기 박스, 최소화, 최대화 버튼이 없는 일반 프레임을 가진 성장할 수 없는 다이얼로그가 생성됩니다. x와 y는 다이얼로그의 좌상단 코너의 픽셀 좌표입니다. dx와 dy는 다이얼로그의 너비와 높이의 픽셀 크기입니다. dlgTitle은 다이얼로그의 타이틀을 정의합니다. dialogItemi (1 <= i <= n)는 다이얼로그 항목들의 n 조각들을 지정합니다. 다양한 다이얼로그 항목들의 GRC 사양들에 대해서는 DG 다이얼로그 항목 페이퍼를 보십시오.

frameFlag의 가능한 값은 다음과 같습니다:

값	의미
normalFrame	다이얼로그가 일반 다이얼로그 프레임을 갖습니다.
thickFrame	다이얼로그가 두꺼운 프레임을 갖습니다.
noFrame	다이얼로그가 프레임을 갖지 않습니다.

growFlag의 가능한 값은 다음과 같습니다:

값	의미
noGrow	다이얼로그의 크기를 바꿀 수 없습니다.
hGrow	다이얼로그의 크기를 수평 방향으로 바꿀 수 있습니다.
vGrow	다이얼로그의 크기를 수직 방향으로 바꿀 수 있습니다.
grow	다이얼로그의 크기를 수평, 수직 방향으로 바꿀 수 있습니다.

captionFlag의 가능한 값은 다음과 같습니다:

값	의미
noCaption	다이얼로그가 캡션이 없습니다.

closeFlag의 가능한 값은 다음과 같습니다:

값	의미
noClose	다이얼로그의 캡션에 닫기 박스가 없습니다.
close	다이얼로그의 캡션에 닫기 박스가 있습니다.

minimizeFlag의 가능한 값은 다음과 같습니다:

값	의미
noMinimize	다이얼로그의 캡션에 최소화 버튼이 없습니다.
minimize	다이얼로그의 캡션에 최소화 버튼이 있습니다.

maximizeFlag의 가능한 값은 다음과 같습니다:

값	의미
noMaximize	다이얼로그의 캡션에 최대화 버튼이 없습니다.
maximize	다이얼로그의 캡션에 최대화 버튼이 있습니다.

Palette 다이얼로그의 GRC 사양

    'GDLG'  resID  Palette [| frameFlag | growFlag | captionFlag | closeFlag]  x  y  dx  dy  "dlgTitle" {
      dialogItem1
          ...
      dialogItemi
          ...
      dialogItemn
    }

resID는 Palette 다이얼로그의 리소스 ID입니다. Palette 키워드는 OR (|) 연산자를 이용하여 선택적인 growFlag, captionFlag 그리고 closeFlag와 함께 결합될 수 있습니다. 만약 이 flag들을 생략하면, 위에 캡션이 있고 닫기 박스가 없는 일반 프레임을 가진 성장할 수 없는 다이얼로그가 생성됩니다. x와 y는 다이얼로그의 좌상단 코너의 픽셀 좌표입니다. dx와 dy는 다이얼로그의 너비와 높이의 픽셀 크기입니다. dlgTitle은 다이얼로그의 타이틀을 정의합니다. dialogItemi (1 <= i <= n)는 다이얼로그 항목들의 n 조각들을 지정합니다. 다양한 다이얼로그 항목들의 GRC 사양들에 대해서는 DG 다이얼로그 항목 페이퍼를 보십시오.

frameFlag의 가능한 값은 다음과 같습니다:

값	의미
normalFrame	다이얼로그가 일반 다이얼로그 프레임을 갖습니다.
thickFrame	다이얼로그가 두꺼운 프레임을 갖습니다.
noFrame	다이얼로그가 프레임을 갖지 않습니다.

growFlag의 가능한 값은 다음과 같습니다:

값	의미
noGrow	다이얼로그의 크기를 바꿀 수 없습니다.
hGrow	다이얼로그의 크기를 수평 방향으로 바꿀 수 있습니다.
vGrow	다이얼로그의 크기를 수직 방향으로 바꿀 수 있습니다.
grow	다이얼로그의 크기를 수평, 수직 방향으로 바꿀 수 있습니다.

captionFlag의 가능한 값은 다음과 같습니다:

값	의미
topCaption	캡션이 다이얼로그 위에 있습니다.
leftCaption	캡션이 다이얼로그 왼쪽에 있습니다.
noCaption	다이얼로그에 캡션이 없습니다.

closeFlag의 가능한 값은 다음과 같습니다:

값	의미
noClose	다이얼로그의 캡션에 닫기 박스가 없습니다.
close	다이얼로그의 캡션에 닫기 박스가 있습니다.

설명

다이얼로그들은 다이얼로그 항목들에 대한 문맥 인식 도움말을 제공할 수 있습니다. 더 자세한 것은 다음을 보십시오: 다이얼로그 도움말의 GRC 사양.

요구사항

버전: DG 1.0.0 또는 이후

헤더: DG.h

참고사항

경고, Modal 다이얼로그, Modeless 다이얼로그, Palette 다이얼로그
다이얼로그 항목 타입의 GRC 사양, 다이얼로그 도움말의 GRC 사양, 이미지 타입의 GRC 사양
다이얼로그 항목 타입, DGInit