DGInitData

DGInitData structure는 일반 DG 설정 및 Preference에 대한 정보를 포함합니다.

    struct DGInitData {
      UChar          mainVersion;
      UChar          subVersion;
      UChar          revision;
      char           filler1;
      char           northSymb[4];
      char           southSymb[4];
      char           eastSymb[4];
      char           westSymb[4];
      char           gradSymb[4];
      char           radSymb[4];
      char           degSymb[4];
      char           degreeSymb[4];
      char           minuteSymb[4];
      char           secondSymb[4];
      void*          suspendAppl;           // Macintosh 전용!
      double         internalUnit;
      IO::Location*  pPrefsFileLoc;         // Macintosh 전용!
      GSResModule    contextMenuResModule;  // Windows 전용!
      short          contextMenuStrListId;  // Windows 전용!
      short          applIconId;            // Windows 전용!
      Int32          fontCharSet;           // Windows 전용!
      Int32          largeFontSize;         // Windows 전용!
      Int32          smallFontSize;         // Windows 전용!
      Int32          xSmallFontSize;        // Windows 전용!
      Int32          largeFontWeight;       // Windows 전용!
      Int32          smallFontWeight;       // Windows 전용!
      Int32          xSmallFontWeight;      // Windows 전용!
      char           largeFontName[64];     // Windows 전용!
      char           smallFontName[64];     // Windows 전용!
      char           xSmallFontName[64];    // Windows 전용!
      char           closeMenuText[32];     // Windows 전용!
      char           nextMenuText[32];      // Windows 전용!
      char           errorText[32];         // Windows 전용!
      char           warningText[32];       // Windows 전용!
      char           infoText[32];          // Windows 전용!
      char           applRegKey[256];       // Windows 전용!
      char           allFilesText[64];
      GSResModule    fileNameAlertResModule;// Windows 전용!
      short          fileNameAlerId;        // Windows 전용!
    };

멤버

mainVersion

DG 라이브러리(0-9)의 메인 버전 번호입니다. 십진수이며 문자('0'-'9')가 아닙니다. DGInit을 호출할 때 DGLIB_MAINVERSION 정의를 사용합니다.

 

subVersion

DG 라이브러리(0-9)의 서브 버전 번호입니다. 십진수이며 문자('0'-'9')가 아닙니다. DGInit을 호출할 때 DGLIB_SUBVERSION 정의를 사용합니다.

 

revision

DG 라이브러리(0-9)의 개정 번호입니다. 십진수이며 문자('0'-'9')가 아닙니다. DGInit을 호출할 때 DGLIB_REVISION 정의를 사용합니다.

 

filler1

예약됨.

 

northSymb

각도 타입 Edit 컨트롤에 대한 북쪽 심볼입니다. 만약 northSymb이 빈 문자열이면, DG는 내부적으로 저장된 "N "을 사용합니다.

 

southSymb

각도 타입 Edit 컨트롤에 대한 남쪽 심볼입니다. 만약 southSymb이 빈 문자열이면, DG는 내부적으로 저장된 "S "를 사용합니다.

 

eastSymb

각도 타입 Edit 컨트롤에 대한 동쪽 심볼입니다. 만약 eastSymb이 빈 문자열이면, DG는 내부적으로 저장된 "E "를 사용합니다.

 

westSymb

각도 타입 Edit 컨트롤에 대한 서쪽 심볼입니다. 만약 westSymb이 빈 문자열이면, DG는 내부적으로 저장된 "W "를 사용합니다.

 

gradSymb

각도 타입 Edit 컨트롤에 대한 Grad 심볼입니다. 만약 gradSymb이 빈 문자열이면, DG는 내부적으로 저장된 "G "를 사용합니다.

 

radSymb

각도 타입 Edit 컨트롤에 대한 Radian 심볼입니다. 만약 radSymb이 빈 문자열이면, DG는 내부적으로 저장된 "R "을 사용합니다.

 

degSymb

각도 타입 Edit 컨트롤에 대한 Degree #1 심볼입니다. 만약 degSymb이 빈 문자열이면, DG는 내부적으로 저장된 "D "를 사용합니다.

 

degreeSymb

각도 타입 Edit 컨트롤에 대한 Degree #2 심볼입니다. 만약 degreeSymb이 빈 문자열이면, DG는 내부적으로 저장된 "° "를 사용합니다.

 

minuteSymb

각도 타입 Edit 컨트롤에 대한 분(Minute) 심볼입니다. 만약 minuteSymb이 빈 문자열이면, DG는 내부적으로 저장된 "´ "를 사용합니다.

 

secondSymb

각도 타입 Edit 컨트롤에 대한 초(Second) 심볼입니다. 만약 secondSymb이 빈 문자열이면, DG는 내부적으로 저장된 "" "를 사용합니다.

 

internalUnit

mm로 표시된 애플리케이션의 내부 길이 단위입니다.

 

allFilesText

파일 다이얼로그에 대한 'All Files' 텍스트입니다. 만약 비어 있으면, DG는 내부적으로 저장된 English 텍스트 "All Files"를 사용합니다

 

 Macintosh 전용:

 

suspendAppl

Modal 다이얼로그 또는 경고 창이 최전방 창일 때, 중지 및 재개 이벤트에서 호출됩니다. 중지/재개 프로시저의 프로토타입은 다음과 같습니다.

 

typedef void (*SuspendAppl) (Boolean suspend);

 

suspendAppl은 void*로 캐스팅되는 이 함수에 대한 포인터입니다. 이 프로시저에서 애플리케이션은 프로그램이 활성화 혹은 비활성화되었을 때 모든 적절한 작업을 해야만 합니다. 만약 suspendAppl이 NULL이면, Modal 다이얼로그 또는 경고 창이 최전방 창일 때 중지/재개 이벤트 알림이 없습니다. suspend는 이벤트가 중지이면 true (0 아님), 이벤트가 재개이면 false (0)입니다.

 

pPrefsFileLoc

DG는 다이얼로그를 닫을 때, 모든 다이얼로그의 스크린 위치/크기를 저장합니다. 다이얼로그들이 다시 열리면 그것들은 가장 최근 위치에 나타나게 됩니다. 창들의 위치들은 시스템 Preferences 폴더의 preferences 파일에 저장됩니다. pPrefsFileLoc은 이 파일의 위치입니다. 만약 pPrefsFileLoc이 NULL, DG는 다이얼로그들의 위치와 크기를 저장하지 않습니다.

 

 Windows 전용:

 

contextMenuResModule

만약 사용자가 오른쪽 마우스 버튼으로 드래그 앤 드롭 동작을 마치거나, 오른쪽 마우스 버튼으로 Edit 컨트롤 항목 위를 클릭하거나, 오른쪽 마우스 버튼으로 비-Edit 컨트롤 항목 위를 클릭하면, 액션을 선택하도록 스크린에 컨텍스트 메뉴가 나타나게 됩니다. contextMenuResModule은 특수 문자열 리스트 리소스를 포함하는 모듈의 리소스 모듈입니다. 다양한 컨텍스트 메뉴들은 이 문자열 리스트의 항목들로부터 만들어집니다. 만약 contextMenuResModule이 0이면, DG는 내부 리소스 모듈을 사용합니다.

 

contextMenuStrListId

contextMenuStrListId는 문자열 리스트에 저장된 지역화된 컨텍스트 메뉴 항목들의 문자열 리스트 id의 리소스 ID입니다. 만약 contextMenuStrListId가 0이면, DG는 내부적으로 저장된 English 기본 메뉴들을 사용합니다. 문자열 리스트는 엄격한 포맷을 갖고 있습니다. 항목들은 다음 순서대로 있어야 하며 각자 의미를 갖고 있습니다: "Help", "Undo", "Cut", "Copy", "Paste", "Clear", "Select All", "Copy Here", "Move Here", "Cancel". 만약 사용자가 마우스 오른쪽 버튼으로 Edit 컨트롤 항목 위를 클릭하면, 컨텍스트 메뉴가 스크린에 나타나 액션을 선택하라고 합니다. (Help/Undo/Cut/Copy/Paste/Clear/SelectAll) 만약 사용자가 마우스 오른쪽 버튼으로 드래그 앤 드롭 동작을 마치면, 액션을 선택하도록 스크린에 컨텍스트 메뉴가 나타나게 됩니다. (Copy/Move/Cancel) 만약 사용자가 마우스 오른쪽 버튼으로 비-Edit 컨트롤 항목 위를 클릭하면, 스크린에 단일 항목을 가진 컨텍스트 메뉴가 나타나게 됩니다. (Help)

 

applIconId

애플리케이션의 아이콘의 리소스 ID입니다. 이 아이콘은 경고 창, Modal 및 Modeless 다이얼로그 캡션에 나타납니다.

 

fontCharSet

다이얼로그 글꼴들의 문자 세트입니다. 만약 fontCharSet가 0이면, DG는 ANSI_CHARSET를 사용합니다.

 

largeFontSize

large 다이얼로그 글꼴의 문자 크기입니다. (단위: points) 만약 largeFontSize가 0이면, DG는 13을 사용합니다.

 

smallFontSize

small 다이얼로그 글꼴의 문자 크기입니다. (단위: points) 만약 smallFontSize가 0이면, DG는 13을 사용합니다.

 

xSmallFontSize

extra small 다이얼로 글꼴의 문자 크기입니다. (단위: points) 만약 xSmallFontSize가 0이면, DG는 12를 사용합니다.

 

largeFontWeight

bold large 글꼴의 가중치입니다. (범위: 400-1000) 만약 largeFontWeight가 0이면, DG는 700을 사용합니다. (FW_BOLD)

 

smallFontWeight

bold small 글꼴의 가중치입니다. (범위: 400-1000) 만약 smallFontWeight가 0이면, DG는 600을 사용합니다. (FW_SEMIBOLD)

 

xSmallFontWeight

bold extra small 글꼴의 가중치입니다. (범위: 400-1000) 만약 xSmallFontWeight가 0이면, DG는 700을 사용합니다. (FW_BOLD)

 

largeFontName

large 다이얼로그 글꼴의 이름입니다. 만약 largeFontName이 빈 문자열이면, DG는 "MS Sans Serif"를 사용합니다.

 

smallFontName

small 다이얼로그 글꼴의 이름입니다. 만약 smallFontName이 빈 문자열이면, DG는 "Arial"을 사용합니다.

 

xSmallFontName

extra small 다이얼로그 글꼴의 이름입니다. 만약 xSmallFontName이 빈 문자열이면, DG는 "Arial"을 사용합니다.

 

closeMenuText

Modeless 다이얼로그들의 시스템 메뉴 안에 있는 닫기 메뉴 항목 텍스트입니다. 만약 closeMenuText가 빈 문자열이면, DG는 내부적으로 저장된 English 텍스트 "&Close"를 사용합니다.

 

nextMenuText

Modeless 다이얼로그들의 시스템 메뉴 안에 있는 다음 창 메뉴 항목 텍스트입니다. 만약 nextMenuText가 빈 문자열이면, DG는 내부적으로 저장된 English 텍스트 "Nex&t"를 사용합니다.

 

errorText

DGAlert에 의해 생성된 error 경고 창의 타이틀입니다. 만약 errorText가 빈 문자열이면, DG는 내부적으로 저장된 English 텍스트 "Error!"를 사용합니다.

 

warningText

DGAlert에 의해 생성된 warning 경고 창의 타이틀입니다. 만약 warningText가 빈 문자열이면, DG는 내부적으로 저장된 English 텍스트 "Warning!"을 사용합니다.

 

infoText

DGAlert에 의해 생성된 information 경고 창의 타이틀입니다. 만약 infoText가 빈 문자열이면, DG는 내부적으로 저장된 English 텍스트 "Information"을 사용합니다.

 

applRegKey

DG는 다이얼로그를 닫을 때 모든 다이얼로그의 스크린 위치/크기를 저장합니다. 다이얼로그들이 다시 열리면 그것들은 가장 최근 위치에 나타나게 됩니다. 창들의 위치들은 애플리케이션의 레지스트리 키의 Windows 시스템 레지스트리에 저장됩니다. applRegKey는 이 레지스트리 키의 전체 경로입니다. 만약 applRegKey가 빈 문자열이면, DG는 다이얼로그들의 위치와 크기를 저장하지 않습니다.

 

fileNameAlertResModule

만약 사용자가 파일 다이얼로그 안에 너무 긴 경로 또는 파일명을 제공하면, 경고 창이 나타나게 됩니다. fileNameAlertResModule은 이 파일명 경고의 리소스 모듈입니다.

 

fileNameAlertId

만약 사용자가 파일 다이얼로그 안에 너무 긴 경로 또는 파일명을 제공하면, 경고 창이 나타나게 됩니다. fileNameAlertId는 이 파일명 경고의 리소스 ID입니다.

설명

DGInitData structure는 DGInit 함수가 사용합니다. DGInit을 호출하기 전에 이 structure를 전부 0으로 채워야 합니다. 빈 필드들의 경우 DG가 내부 기본 값을 사용하기 때문입니다. 위에서 언급한 기본값과 다른 값을 가진 필드들만 세트됩니다.

DGInit 함수를 호출할 때 DG 다이얼로그 관리자에서 버전 체크가 있습니다. DGInitData structure에서 주어진 버전 번호들(외부 버전)과 DG 다이얼로그 관리자에서 주어진 버전 번호들(내부 버전)과의 관계는 다음과 같아야 합니다: mainVersion 멤버들은 동일해야 합니다. 내부 subVersion은 외부 subVersion과 같거나 더 커야 합니다. 만약 subVersion 멤버들이 동일하다면, 내부 revision은 외부 revision과 같거나 더 커야 합니다. 이 프로시저는 이전 버전의 DG 다이얼로그 관리자fㅡㄹ 사용할 수 없도록 보장해 줍니다.

요구사항

버전: DG 2.0.0 또는 이후

헤더: DG.h

참고사항

DG Structure, Edit 컨트롤, DGAlert, DGInit