창 형식의 특성을 지정하거나 수정하려면 이 구조를 사용합니다.
구문
typedef struct tagHH_WINTYPE {
int cbStruct;
BOOL fUniCodeStrings;
LPCTSTR pszType;
DWORD fsValidMembers;
DWORD fsWinProperties;
LPCTSTR pszCaption;
DWORD dwStyles;
DWORD dwExStyles;
RECT rcWindowPos;
int nShowState;
HWND hwndHelp;
HWND hwndCaller;
HH_INFOTYPE *paInfoTypes;
HWND hwndToolBar;
HWND hwndNavigation;
HWND hwndHTML;
int iNavWidth;
RECT rcHTML;
LPCTSTR pszToc;
LPCTSTR pszIndex;
LPCTSTR pszFile;
LPCTSTR pszHome;
DWORD fsToolBarFlags;
BOOL fNotExpanded;
int curNavType;
int tabpos;
int idNotify;
BYTE tabOrder[HH_MAX_TABS + 1];
int cHistory;
LPCTSTR pszJump1;
LPCTSTR pszJump2;
LPCTSTR pszUrlJump1;
LPCTSTR pszUrlJump2;
RECT rcMinSize;
int cbInfoTypes;
LPCTSTR pszCustomTabs;
} HH_WINTYPE, *PHH_WINTYPE;
멤버
cbStruct
구조체의 크기를 지정합니다. 이 값은 구조를 HtmlHelp()에 전달하기 전에 항상 채워야 합니다.
fUniCodeStrings
이 구조에 사용되는 문자열이 UNICODE인지 여부를 지정합니다.
pszType
창 형식의 이름을 지정하는 null로 끝나는 문자열입니다.
fsValidMembers
구조체에서 유효한 멤버를 지정합니다.
fsWinProperties
창의 속성을 지정합니다(예: 표준 HTML 도움말 뷰어인지 또는 검색 탭이 포함되어 있는지 여부).
pszCaption
창의 제목 표시줄에 표시할 캡션 지정하는 null로 끝나는 문자열입니다.
dwStyles
창을 만드는 데 사용되는 스타일을 지정합니다. 이러한 스타일은 무시하거나, 확장된 스타일과 결합하거나, fsValidMembers 및 fsWinProperties 매개 변수의 값에 따라 단독으로 사용할 수 있습니다.
dwExStyles
창을 만드는 데 사용되는 확장 스타일을 지정합니다. 이러한 스타일은 무시하거나, 기본 스타일과 결합하거나, fsValidMembers 및 fsWinProperties 매개 변수의 값에 따라 단독으로 사용할 수 있습니다.
rcWindowPos
창의 좌표를 픽셀 단위로 지정합니다. 값은 다음 순서로 읽습니다.
rcWindowPos = {left, top, right, bottom};
nShowState
창의 초기 표시 상태를 지정합니다. 유효한 값은 Win32 API ShowWindow 함수의 값과 동일합니다.
hwndHelp
창이 만들어진 경우 창의 핸들을 지정합니다.
hwndCaller
HTML 도움말 알림 메시지를 받을 창을 지정합니다. 알림 메시지는 Windows WM_NOTIFY 메시지를 통해 전송됩니다.
paInfoTypes
정보 형식 배열에 대한 포인터입니다.
hwndToolBar
도구 모음의 핸들을 지정합니다.
hwndNavigation
탐색 창의 핸들을 지정합니다.
hwndHTML
Shdocvw.dll 호스트하는 토픽 창의 핸들을 지정합니다.
iNavWidth
도움말 뷰어를 확장할 때 탐색 창의 너비를 지정합니다.
rcHTML
토픽 창의 좌표를 지정합니다.
pszToc
탐색 창에 표시할 내용(.hhc) 파일을 지정합니다.
pszIndex
탐색 창에 표시할 인덱스(.hhk) 파일을 지정합니다.
pszFile
토픽 창에 표시할 기본 HTML 파일을 지정합니다.
pszHome
홈 단추를 클릭할 때 토픽 창에 표시할 파일 또는 URL을 지정합니다.
도구 모음에 포함할 단추를 지정합니다.
fsToolBarFlags
3개 창 도움말 뷰어의 도구 모음 창에 포함할 단추를 지정합니다.
fNotExpanded
탐색 창이 닫힌 상태에서 도움말 뷰어가 열리도록 지정합니다.
curNavType
탐색 창에 표시할 기본 탭을 지정합니다.
tabpos
HTML 도움말 뷰어의 탐색 창에 탭을 배치할 위치를 지정합니다.
idNotify
HTML 도움말 알림 메시지를 사용하도록 설정하기 위한 0이 아닌 ID를 지정합니다. 이 ID는 Windows WM_NOTIFY 메시지의 wParam 값으로 전달됩니다.
tabOrder[HH_MAX_TABS + 1]
탭 순서: 콘텐츠, 인덱스, 검색, 기록, 즐겨찾기, 예약 1-5, 사용자 지정 탭
cHistory
유지할 기록 항목의 수입니다. (기본값: 30)
pszJump1
Jump1 단추 아래에 표시할 텍스트를 지정합니다.
pszJump2
Jump2 단추 아래에 표시할 텍스트를 지정합니다.
pszUrlJump1
Jump1 단추를 클릭할 때 이동할 URL을 지정합니다.
pszUrlJump2
Jump2 단추를 클릭할 때 이동할 URL을 지정합니다.
rcMinSize
창의 최소 크기(버전 1에서는 무시됨).
cbInfoTypes
paInfoTypes의 크기
pszCustomTabs
탭 레이블로 사용할 0으로 끝나는 일련의 문자열입니다.
설명
창 형식은 프로젝트(.hhp) 파일의 작성자가 정의하거나 HTML 도움말 API를 사용하여 프로그래밍 방식으로 정의할 수 있습니다.
HH_SET_WIN_TYPE 명령을 사용하여 HH_WINTYPE 구조체가 HtmlHelp()에 전달되면 HTML 도움말 API는 구조체의 콘텐츠에 대한 프라이빗 복사본을 만듭니다. 따라서 도움말 개발자는 HH_WINTYPE 구조 또는 그 안에 있는 문자 배열에서 사용하는 메모리를 해제할 책임이 있습니다. 개발자는 HH_SET_WIN_TYPE 호출한 후 메모리를 해제할 수 있습니다.
사용 기준
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | htmlhelp.h |