DGAlert
표준 DG 경고를 호출합니다.
short DGAlert (
short alertType,
const char* titleText,
const char* largeText,
const char* smallText,
const char* button1Text,
const char* button2Text,
const char* button3Text
);
파라미터
- alertType
-
값 의미 DG_ERROR Macintosh에서는 Stop 경고; Windows에서는 Error 경고입니다. DG_WARNING Macintosh에서는 Caution 경고; Windows에서는 Warning 경고입니다. DG_INFORMATION Macintosh에서는 Note 경고; Windows에서는 Information 경고입니다. 아무 양수 경고 창에 표시할 컬러 아이콘의 리소스 ID입니다. - titleText
- 경고창 타이틀입니다. 이 파라미터는 NULL이 될 수 있습니다.
- largeText
- 경고 창의 1번째 정적 텍스트입니다. 이 파라미터는 NULL이 될 수 있습니다.
- smallText
- 경고 창의 2번째 정적 텍스트입니다. 이 파라미터는 NULL이 될 수 있습니다.
- button1Text
- 1번째(우측, 기본) 버튼의 텍스트입니다. 이 파라미터는 NULL이 될 수 있습니다.
- button2Text
- 2번째(중앙, 취소) 버튼의 텍스트입니다. 이 파라미터는 NULL이 될 수 있습니다.
- button3Text
- 3번째(좌측) 버튼의 텍스트입니다. 이 파라미터는 NULL이 될 수 있습니다.
리턴 값
-
값 의미 DG_OK 1번째 버튼을 클릭했습니다. DG_CANCEL 2번째 버튼을 클릭했습니다. DG_THIRD 3번째 버튼을 클릭했습니다.
만약 함수 파라미터들이 올바르지 않으면, 0을 리턴합니다.
Windows의 경우 사용자가 캡션에 있는 닫힘 박스를 클릭하면 DGAlert는 DG_CANCEL을 리턴합니다. 만약 경고 창에 2번째 버튼이 없으면 DG_OK를 리턴합니다.
설명
DGAlert는 DGResAlert와 동일한 행동을 합니다. 유일한 차이점은 아이콘, 경고, 버튼 텍스트를 지정하는 방식입니다.
만약 titleText가 NULL이면, Macintosh의 경우 타이틀이 없습니다. Windows의 경우 DG는 DGInit에서 주어진 표준 경고 타이틀 중 하나를 사용합니다. 1번째와 2번째 경고 텍스트는 각각 large plain과 small plain 글꼴을 사용하여 그려집니다. 만약 largeText 또는 smallText가 NULL이면, 1번째와 2번째 정적 텍스트가 없습니다. 그러나 largeText 또는 smallText 중 하나는 NULL이 되어서는 안 됩니다. 만약 button1Text, button2Text 또는 button3Text가 NULL이면, 각각 1번째, 2번째 또는 3번째 버튼이 없습니다. button1Text와 button2Text 중 하나는 NULL이 되어서는 안 됩니다.
경고 창의 크기는 자동으로 주어진 요소들을 모두 담을 수 있는 최소한의 크기로 변합니다. 만약 1번째 그리고/또는 2번째 경고 텍스트가 한 라인 안에 다 들어오지 않으면, DG는 자동으로 여러 라인으로 쪼갭니다. 물론, 이 텍스트들은 명시적인 line break를 포함할 수도 있습니다.
요구사항
- 버전: DG 1.0.0 또는 이후
- 헤더: DG.h
- 라이브러리 가져오기: DG.lib [WIN]
- 모듈: DGLib [MAC], DG.dll [WIN]
