^(코딩캣)^ = @"코딩"하는 고양이;
썸네일 이미지
HLP 형식의 윈도우 도움말 제작하기 #5 [完]
HLP 형식의 윈도우 도움말 제작하기 본 시리즈에서는 윈도우 도움말 형식 중 하나인 HLP 형식의 도움말을 생성하기 위한 방법에 대해 정리한다. 참고로 HLP 파일은 Windows XP까지만 열기가 지원된다. HLP 형식의 윈도우 도움말 제작하기 #1 HLP 형식의 윈도우 도움말 제작하기 #2 HLP 형식의 윈도우 도움말 제작하기 #3 HLP 형식의 윈도우 도움말 제작하기 #4 HLP 형식의 윈도우 도움말 제작하기 #5 [完] HLP 형식의 윈도우 도움말 제작하기 #5 (완결) HLP 도움말은 Windows 3.1부터 Windows XP까지 지원하던 도움말 형식으로서, 내부적으로는 여러개의 RTF 문서 파일로 이루어져 있다. Windows Vista 이후에 출시되는 Windows 운영체제(Vista, 2..
Microsoft Windows/Win32 도움말 연동
2018. 11. 19. 18:06

HLP 형식의 윈도우 도움말 제작하기 #5 [完]

Microsoft Windows/Win32 도움말 연동
2018. 11. 19. 18:06

HLP 형식의 윈도우 도움말 제작하기


본 시리즈에서는 윈도우 도움말 형식 중 하나인 HLP 형식의 도움말을 생성하기 위한 방법에 대해 정리한다. 참고로 HLP 파일은 Windows XP까지만 열기가 지원된다.

  1. HLP 형식의 윈도우 도움말 제작하기 #1
  2. HLP 형식의 윈도우 도움말 제작하기 #2
  3. HLP 형식의 윈도우 도움말 제작하기 #3
  4. HLP 형식의 윈도우 도움말 제작하기 #4
  5. HLP 형식의 윈도우 도움말 제작하기 #5 [完]

HLP 형식의 윈도우 도움말 제작하기 #5 (완결)


HLP 도움말은 Windows 3.1부터 Windows XP까지 지원하던 도움말 형식으로서, 내부적으로는 여러개의 RTF 문서 파일로 이루어져 있다. Windows Vista 이후에 출시되는 Windows 운영체제(Vista, 2008, 7, 2010, 8, 2012, 8.1, 10, ...)에서는 공식적으로 지원하지는 않는다. 이번 시리즈에서는 HLP 도움말을 제작하고, WinAPI에서 이를 불러오는 방법까지 알아보겠다.

준비물: 1. Windows XP 또는 그 이전 버전 운영체제, 2. Microsoft Word (아무 버전이나), 3. Microsoft Visual Studio 6.0

 

WinAPI에서 hlp 도움말 호출하기


WinAPI에서 .hlp 파일 내의 내용을 띄워주기 위해서는 .hlp 파일을 구성하는 각 파일마다 프로그램적으로 구분 가능한 일련번호가 부여되어야 한다. 프로젝트 화면에서 [Map...] 버튼을 누른다. "Map" 대화상자가 뜨면 [Add...] 버튼을 눌러 "App Map Entry" 대화상자를 연다.

"Topic ID:"에는 .rtf 파일에서 '#' 각주로 지정한 문서의 ID를 적고, "Mapped numeric value:"에는 .hlp 파일 내에서 중복되지 않는 유일한 값을 임의로 부여한다. "Comment:"에는 간단한 설명을 붙일 수 있다.

 

프로젝트 화면에 [MAP] 항목이 새로 나타나면서 위에서 적었던 내용들이 나타난다면 컴파일한다.

 

여기서부터는 코딩이 시작된다. Visual C++를 실행한다. Win32 Application을 선택하여 새로 만든다.

 

소스 파일이 있는 경로와 출력 파일(.exe 파일)이 있는 경로에 각각 Help Workshop에서 만든 .cnt 파일과 .hlp 파일을 붙여넣는다.

 

WinAPI로 버튼을 하나 만든 다음, 버튼을 클릭 시 메시지를 처리하는 부분에서 아래의 함수를 호출해본다.

WinHelp(소유주가 되는 창의 핸들, TEXT(".hlp파일명"), HELP_CONTEXT, 보여줄 문서의 일련번호);

 

이 함수의 원형은 다음과 같다. 성공하면 TRUE를 반환하고 그렇지 않으면 FALSE를 반환한다.

BOOL WinHelp(
    HWND      hWndMain,
    LPCTSTR   lpszHelp,
    UINT      uCommand,
    ULONG_PTR dwData
);

 

만일 이 함수를 C# 언어에서 사용하고자 하면, 다음과 같이 외부함수를 정의한다. 아래의 정의는 MS의 공식적인 변환은 아니며 소스코드의 특성에 따라 커스터마이징이 가능하다.

[DllImport("user32.dll", CharSet=CharSet.Auto)]
[return: MarshalAs(UnmanagedType.Bool)]
public static extern bool WinHelp(
    [MarshalAs(UnmanagedType.SysInt)] IntPtr hWndMain,
    [MarshalAs(UnmanagedType.LPTStr)] string lpszHelp,
    [MarshalAs(UnmanagedType.SysUInt)] int uCommand,
    [MarshalAs(UnmanagedType.SysInt)] IntPtr dwData
);

 

첫 번째 매개변수는 대체로 NULL을 쓰면 되고, 네 번째 매개변수는 Help Workshop의 Map 대화상자에서 부여된 일련번호를 입력한다.

 

버튼을 클릭 시 해당 내용이 보여지는 것을 확인할 수 있다.

 

네 번째 매개변수를 바꿈으로써 상황에 맞는 적절한 도움말을 보여줄 수 있다.

 

Epilogue


이것으로 HLP 형식의 도움말 파일을 생성하고 Windows API와 연동하는 방법에 대해 마친다.

 

카테고리 “Microsoft Windows/Win32 도움말 연동”
more...
썸네일 이미지
HLP 형식의 윈도우 도움말 제작하기 #4
HLP 형식의 윈도우 도움말 제작하기 본 시리즈에서는 윈도우 도움말 형식 중 하나인 HLP 형식의 도움말을 생성하기 위한 방법에 대해 정리한다. 참고로 HLP 파일은 Windows XP까지만 열기가 지원된다. HLP 형식의 윈도우 도움말 제작하기 #1 HLP 형식의 윈도우 도움말 제작하기 #2 HLP 형식의 윈도우 도움말 제작하기 #3 HLP 형식의 윈도우 도움말 제작하기 #4 HLP 형식의 윈도우 도움말 제작하기 #5 [完] HLP 형식의 윈도우 도움말 제작하기 #4 HLP 도움말은 Windows 3.1부터 Windows XP까지 지원하던 도움말 형식으로서, 내부적으로는 여러개의 RTF 문서 파일로 이루어져 있다. Windows Vista 이후에 출시되는 Windows 운영체제(Vista, 2008, ..
Microsoft Windows/Win32 도움말 연동
2018. 11. 18. 21:55

HLP 형식의 윈도우 도움말 제작하기 #4

Microsoft Windows/Win32 도움말 연동
2018. 11. 18. 21:55

HLP 형식의 윈도우 도움말 제작하기


본 시리즈에서는 윈도우 도움말 형식 중 하나인 HLP 형식의 도움말을 생성하기 위한 방법에 대해 정리한다. 참고로 HLP 파일은 Windows XP까지만 열기가 지원된다.

  1. HLP 형식의 윈도우 도움말 제작하기 #1
  2. HLP 형식의 윈도우 도움말 제작하기 #2
  3. HLP 형식의 윈도우 도움말 제작하기 #3
  4. HLP 형식의 윈도우 도움말 제작하기 #4
  5. HLP 형식의 윈도우 도움말 제작하기 #5 [完]

HLP 형식의 윈도우 도움말 제작하기 #4


HLP 도움말은 Windows 3.1부터 Windows XP까지 지원하던 도움말 형식으로서, 내부적으로는 여러개의 RTF 문서 파일로 이루어져 있다. Windows Vista 이후에 출시되는 Windows 운영체제(Vista, 2008, 7, 2010, 8, 2012, 8.1, 10, ...)에서는 공식적으로 지원하지는 않는다. 이번 시리즈에서는 HLP 도움말을 제작하고, WinAPI에서 이를 불러오는 방법까지 알아보겠다.

준비물: 1. Windows XP 또는 그 이전 버전 운영체제, 2. Microsoft Word (아무 버전이나), 3. Microsoft Visual Studio 6.0

 

일반 링크 만들기


이번에는 도움말 본문에 링크를 만들어서 클릭하면 해당 문서로 이동하는 기능을 넣어보겠다. 먼저 도움말 파일의 개요를 보여 줄 예제 파일을 아래와 같이 작성한다.

 

파일 ID는 ID_HELP_ABSTRACT, 키워드는 '예제 도움말 파일의 개요 파일'로 지정한다.

 

파일명은 abstract, 파일형식은 서식 있는 텍스트(*.rtf)로 지정하여 저장한다.

 

이전 단계와 마찬가지로 [Files...] 버튼을 눌러 abstract.rtf 파일을 프로젝트에 추가한다.

 

색인 파일(project.cnt)도 함께 열어 이전 단계와 마찬가지로 abstract.rtf에 대한 항목을 추가한다.

 

도움말 생성 프로젝트에 파일 추가가 완료되면 index.rtf를 열어 링크를 삽입한다. 링크를 삽입하고 싶은 문단의 끝에 클릭 시 전환하게 될 문서의 ID를 "띄어쓰기 없이" 곧바로 적는다. 여기서는 클릭 시 ID_HELP_ABSTRACT의 ID가 붙은 문서가 보여져야 하므로 "1. 개요ID_HELP_ABSTRACT"와 같이 문단 끝에 곧바로 이 ID를 적어야 한다.

 

링크를 넣을 문구인 "1. 개요"까지만 선택한 후 마우스 오른쪽 버튼을 클릭한다. 다음 [단락(P)...] 메뉴를 클릭한다.

 

"효과" 영역 중 [취소선(K)] 버튼에 체크하여 선택한 문구가 "1. 개요"와 같이 취소선이 그어지게 설정한 다음 [확인] 버튼을 누른다.

 

이번에는 클릭 시 링크될 대상으로서 적은 ID_HELP_ABSTRACT에 대하여 블록을 지정하고 선택 후 마우스 오른쪽 버튼을 눌러 [단락(P)...] 메뉴를 클릭한다.

 

"효과" 영역 중 [숨김(H)] 버튼에 체크하고 [확인] 버튼을 누른다.

 

아래와 같이 ID가 사라지고, 링크할 텍스트에 취소선이 그어져있으면 된다.

 

숨겨진 텍스트로 된 링크 ID를 확인 또는 수정하고자 할 때는 [리본] 버튼 클릭 후 [Word 옵션(I)] 버튼을 클릭한다.

 

[표시] 버튼을 눌러 [숨겨진 텍스트(D)] 항목에 체크한 후 [확인] 버튼을 누른다.

 

아래와 같이 숨겨졌던 ID가 밑줄 표시된 채 보여질 것이다.

 

이제 프로젝트를 컴파일해보자. Help Workshop 컴파일러가 링크를 감지하여 "1 Jump"를 표시하는 것을 볼 수 있다.

 

.hlp 파일을 실행했을 때 취소선 서식을 넣었던 텍스트가 링크로 나타나는 것을 볼 수 있다.

 

이 링크를 클릭 시 해당 ID의 RTF 문서가 보여지고 [뒤로(B)] 버튼이 활성화 됨을 확인할 수 있다.

 

팝업 링크 만들기


이번에는 copyright.rtf 로 저작권 관련 내용을 적어서 도움말에 팝업 형태로 띄워보겠다. 예시 파일을 작성해본다.

 

'#' 각주에는 이 문서의 ID로 ID_HELP_COPYRIGHT를 부여하고, 'K' 각주에는 "이 예제 도움말 파일의 저작권"이라는 문구를 적어보겠다.

 

프로젝트로 가서 [Files...] 버튼을 눌러 copyright.rtf를 추가하고...

 

목차 파일에도 [Add Below...] 버튼을 눌러 저작권 항목을 추가한다.

 

링크를 삽입할 index.rtf를 열어 "5. 저작권" 글자 뒤에 띄어쓰기 없이 copyright.rtf의 ID인 ID_HELP_COPYRIGHT를 적는다.

 

링크를 넣을 텍스트만 블록을 설정한 후 마우스 오른쪽 버튼을 눌러 [글꼴(F)...] 메뉴를 클릭하고,

 

"밑줄 스타일(U):"의 옵션 중 실선을 클릭하여 평범한 밑줄을 넣는다. 그 다음 [확인] 버튼을 누른다.

 

마찬가지로 ID도 블록을 정해 글꼴 옵션에서 숨겨진 텍스트를 클릭한다.

 

아래와 같이 만들면 완성이다.

 

프로젝트로 돌아가 도움말 파일을 컴파일 해 본다. 앞서 만든 링크와 함께, Help Workshop 컴파일러가 두 개의 링크를 감지하여 "2 Jumps"가 뜨는 것을 볼 수 있다.

 

생성된 .hlp 파일을 실행하면 "5. 저작권"에 밑줄이 그어진 것을 볼 수 있다. 이를 클릭해보면...

아래와 같이 팝업 형태로 내용이 보여지게 된다.

 

Epilogue


다음 포스트에서는 만들어진 .hlp 파일을 이용해 WinAPI에서 불러올 수 있도록 해보겠다.

 

카테고리 “Microsoft Windows/Win32 도움말 연동”
more...
썸네일 이미지
HLP 형식의 윈도우 도움말 제작하기 #3
HLP 형식의 윈도우 도움말 제작하기 본 시리즈에서는 윈도우 도움말 형식 중 하나인 HLP 형식의 도움말을 생성하기 위한 방법에 대해 정리한다. 참고로 HLP 파일은 Windows XP까지만 열기가 지원된다. HLP 형식의 윈도우 도움말 제작하기 #1 HLP 형식의 윈도우 도움말 제작하기 #2 HLP 형식의 윈도우 도움말 제작하기 #3 HLP 형식의 윈도우 도움말 제작하기 #4 HLP 형식의 윈도우 도움말 제작하기 #5 [完] HLP 형식의 윈도우 도움말 제작하기 #3 HLP 도움말은 Windows 3.1부터 Windows XP까지 지원하던 도움말 형식으로서, 내부적으로는 여러개의 RTF 문서 파일로 이루어져 있다. Windows Vista 이후에 출시되는 Windows 운영체제(Vista, 2008, ..
Microsoft Windows/Win32 도움말 연동
2018. 11. 18. 21:41

HLP 형식의 윈도우 도움말 제작하기 #3

Microsoft Windows/Win32 도움말 연동
2018. 11. 18. 21:41

HLP 형식의 윈도우 도움말 제작하기


본 시리즈에서는 윈도우 도움말 형식 중 하나인 HLP 형식의 도움말을 생성하기 위한 방법에 대해 정리한다. 참고로 HLP 파일은 Windows XP까지만 열기가 지원된다.

  1. HLP 형식의 윈도우 도움말 제작하기 #1
  2. HLP 형식의 윈도우 도움말 제작하기 #2
  3. HLP 형식의 윈도우 도움말 제작하기 #3
  4. HLP 형식의 윈도우 도움말 제작하기 #4
  5. HLP 형식의 윈도우 도움말 제작하기 #5 [完]

HLP 형식의 윈도우 도움말 제작하기 #3


HLP 도움말은 Windows 3.1부터 Windows XP까지 지원하던 도움말 형식으로서, 내부적으로는 여러개의 RTF 문서 파일로 이루어져 있다. Windows Vista 이후에 출시되는 Windows 운영체제(Vista, 2008, 7, 2010, 8, 2012, 8.1, 10, ...)에서는 공식적으로 지원하지는 않는다. 이번 시리즈에서는 HLP 도움말을 제작하고, WinAPI에서 이를 불러오는 방법까지 알아보겠다.

준비물: 1. Windows XP 또는 그 이전 버전 운영체제, 2. Microsoft Word (아무 버전이나), 3. Microsoft Visual Studio 6.0

 

문서에 식별 ID 부여하기


먼저, 각 문서별로 hlp 파일 내에서 식별할 수 있는 ID를 부여한다. [참조]-[각주] 카테고리 옆에 달린 작은 단추를 클릭한다.

 

[각주 및 미주] 대화상자가 뜬다. "위치"는 "각주(F):"를 선택하고, "서식"에는 "사용자 지정 표시(U):" 옆의 텍스트상자에 '#'을 입력한다. 그리고 [삽입(I)] 버튼을 누른다.

 

페이지 하단 각주 편집창으로 화면이 이동하는데, 여기에 이 문서의 고유 ID를 각자 알아서 지정하면 된다. 예를 들면, 이 문서에 ID_HELP_INDEX라는 ID를 부여할 수 있다.

 

Help Workshop으로 돌아가 우선 컴파일을 한다. 생성 결과에는 아직 아무런 차이도 보이지 않음을 확인할 수 있다.

 

문서에 색인 정보 추가하기


도움말의 '색인' 창을 통해 이 문서로 접근해오려면, 어떤 단어를 검색했을 때 이 문서가 나타나게 할 지를 지정하는 방법이 필요하다. 이를 위해 [참조]-[각주] 카테고리 옆에 달린 작은 단추를 다시 클릭하여 또 다른 각주를 추가한다.

 

이번에는 "사용자 지정 표시(U):" 텍스트 입력창에 Keyword의 약자인 'K'를 입력하고 [삽입(I)]를 클릭한다.

 

각주 편집으로 화면이 이동하면 이 페이지의 목적을 묘사할 수 있는 적절한 문구를 삽입한다.

 

Help Workshop에서 컴파일을 해 본다. 'K' 각주에 의해 아래 표시와 같이 "1 Keyword"가 뜸을 확인할 수 있다.

 

결과물을 확인한다. 전에는 비활성화 상태였던 [색인(I)] 단추가 활성화되어있음을 확인할 수 있다. 이를 클릭한다. [색인] 탭에서 'K' 각주에 적은 문구가 나타날 것이다.

 

목차 삽입하기


이번에는 목차를 삽입한다. Help Workshop 화면에서 [File]-[New] 메뉴를 클릭한다. 대화상자가 뜨면 [Help Contents]를 선택하고 [OK] 버튼을 누른다.

 

목차를 편집할 수 있는 화면으로 바뀌면서 새 목차 파일이 생성됨을 확인할 수 있다.

 

먼저 "Default filename (and window):" 칸에는 지금 컴파일에 의해 생성되고 있는 hlp 파일 이름을 적는다. "Default title:"에는 목차 및 색인 화면 상단 타이틀 바에서 보여질 제목을 적는다.

 

그 다음 [Add Above...] 버튼을 누른다. "Edit Contents Tab Entry" 대화상자가 뜬다. 대주제를 삽입하기 위해 Heading을 선택 후 "Title:" 텍스트박스에 대주제를 적는다. [OK] 버튼을 누른다.

 

아래와 같이 대주제가 삽입되었다.

 

소주제를 삽입하고 싶은 위치에 항목을 선택한 후 [Add Above] 또는 [Add Below]를 눌러 소주제를 삽입할 수 있다. 이 소주제가 우리가 작성하고 있는 RTF 파일로 연결될 것이다. "Edit Contents Tab Entry" 대화상자에서 Topic을 선택한 다음, "Title:"에는 소주제의 명칭을 적고, "Topic ID:"에는 RTF 파일에서 '#' 각주로 지정한 문서의 식별 ID를 적는다. 그리고 OK를 누른다.

 

아래와 같이 대주제 아래 소주제가 삽입되었음을 확인할 수 있다.

 

이제 이 목차를 저장한다. 파일명은 반드시 .hlp 파일과 같게 적고, 확장자는 .cnt여야 한다. 나중에 이 파일은 .hlp파일과 함께 배포되어야 한다.

 

목차 파일이 생성된 후에는 hlp 파일을 더블클릭하였을 때, RTF 문서의 내용이 그대로 출력되지 않고 아래와 같이 목차 및 색인 대화상자가 우선 뜨게 된다.

 

 

목차(C) 버튼을 눌렀을 때 아래와 같이 목차 화면이 뜬다면 성공이다.

 

카테고리 “Microsoft Windows/Win32 도움말 연동”
more...
썸네일 이미지
HLP 형식의 윈도우 도움말 제작하기 #2
HLP 형식의 윈도우 도움말 제작하기 본 시리즈에서는 윈도우 도움말 형식 중 하나인 HLP 형식의 도움말을 생성하기 위한 방법에 대해 정리한다. 참고로 HLP 파일은 Windows XP까지만 열기가 지원된다. HLP 형식의 윈도우 도움말 제작하기 #1 HLP 형식의 윈도우 도움말 제작하기 #2 HLP 형식의 윈도우 도움말 제작하기 #3 HLP 형식의 윈도우 도움말 제작하기 #4 HLP 형식의 윈도우 도움말 제작하기 #5 [完] HLP 형식의 윈도우 도움말 제작하기 #2 HLP 도움말은 Windows 3.1부터 Windows XP까지 지원하던 도움말 형식으로서, 내부적으로는 여러개의 RTF 문서 파일로 이루어져 있다. Windows Vista 이후에 출시되는 Windows 운영체제(Vista, 2008, ..
Microsoft Windows/Win32 도움말 연동
2018. 11. 18. 19:43

HLP 형식의 윈도우 도움말 제작하기 #2

Microsoft Windows/Win32 도움말 연동
2018. 11. 18. 19:43

HLP 형식의 윈도우 도움말 제작하기


본 시리즈에서는 윈도우 도움말 형식 중 하나인 HLP 형식의 도움말을 생성하기 위한 방법에 대해 정리한다. 참고로 HLP 파일은 Windows XP까지만 열기가 지원된다.

  1. HLP 형식의 윈도우 도움말 제작하기 #1
  2. HLP 형식의 윈도우 도움말 제작하기 #2
  3. HLP 형식의 윈도우 도움말 제작하기 #3
  4. HLP 형식의 윈도우 도움말 제작하기 #4
  5. HLP 형식의 윈도우 도움말 제작하기 #5 [完]

HLP 형식의 윈도우 도움말 제작하기 #2


HLP 도움말은 Windows 3.1부터 Windows XP까지 지원하던 도움말 형식으로서, 내부적으로는 여러개의 RTF 문서 파일로 이루어져 있다. Windows Vista 이후에 출시되는 Windows 운영체제(Vista, 2008, 7, 2010, 8, 2012, 8.1, 10, ...)에서는 공식적으로 지원하지는 않는다. 이번 시리즈에서는 HLP 도움말을 제작하고, WinAPI에서 이를 불러오는 방법까지 알아보겠다.

준비물: 1. Windows XP 또는 그 이전 버전 운영체제, 2. Microsoft Word (아무 버전이나), 3. Microsoft Visual Studio 6.0

 

1. 미디어 삽입


이전 포스트에 이어서 이번에는 rtf 파일에 표와 그림을 삽입하여 도움말 파일을 제작한다.

1-1. 표 삽입


Microsoft Word의 [삽입]-[표]-[표] 메뉴를 클릭하여 표를 삽입한다.

 

아래와 같이 표에 적절한 내용을 채운다.

 

Help Workshop으로 돌아가 컴파일한 후 결과를 확인한다. 표의 테두리가 사라져 있음을 확인할 수 있다. hlp 형식의 도움말 파일은 표의 테두리 모양까지 지원하지는 않기 때문에 이렇게 보인다.

 

1-2. 그림 삽입


이번에는 그림을 삽입한다. 그림을 복사하여 워드에 직접 붙여넣기하면 된다. 일반적인 문서 작성과 다르지 않다.

 

만일 구 버전의 Microsoft Word(2007 버전 미만)를 사용중이라면 컴파일된 hlp 파일에서 이와 같이 붙여넣기로 삽입된 그림이 보이지 않을 수 있다. 이 때는 rtf 파일과 같은 폴더 안에 그림 파일을 생성한 후...

 

[삽입]-[일러스트레이션]-[그림] 메뉴를 클릭하여 그림 파일을 삽입한다.

 

컴파일한 hlp 결과이다.

 

Epilogue


이번 포스트에서는 매우 간단한 내용을 다루어보았다. 다음 포스트에서는 "색인과 목차" 기능에 대해 알아보겠다.

카테고리 “Microsoft Windows/Win32 도움말 연동”
more...
썸네일 이미지
HLP 형식의 윈도우 도움말 제작하기 #1
HLP 형식의 윈도우 도움말 제작하기 본 시리즈에서는 윈도우 도움말 형식 중 하나인 HLP 형식의 도움말을 생성하기 위한 방법에 대해 정리한다. 참고로 HLP 파일은 Windows XP까지만 열기가 지원된다. HLP 형식의 윈도우 도움말 제작하기 #1 HLP 형식의 윈도우 도움말 제작하기 #2 HLP 형식의 윈도우 도움말 제작하기 #3 HLP 형식의 윈도우 도움말 제작하기 #4 HLP 형식의 윈도우 도움말 제작하기 #5 [完] HLP 형식의 윈도우 도움말 제작하기 #1 HLP 도움말은 Windows 3.1부터 Windows XP까지 지원하던 도움말 형식으로서, 내부적으로는 여러개의 RTF 문서 파일로 이루어져 있다. Windows Vista 이후에 출시되는 Windows 운영체제(Vista, 2008, ..
Microsoft Windows/Win32 도움말 연동
2018. 11. 18. 17:47

HLP 형식의 윈도우 도움말 제작하기 #1

Microsoft Windows/Win32 도움말 연동
2018. 11. 18. 17:47

HLP 형식의 윈도우 도움말 제작하기


본 시리즈에서는 윈도우 도움말 형식 중 하나인 HLP 형식의 도움말을 생성하기 위한 방법에 대해 정리한다. 참고로 HLP 파일은 Windows XP까지만 열기가 지원된다.

  1. HLP 형식의 윈도우 도움말 제작하기 #1
  2. HLP 형식의 윈도우 도움말 제작하기 #2
  3. HLP 형식의 윈도우 도움말 제작하기 #3
  4. HLP 형식의 윈도우 도움말 제작하기 #4
  5. HLP 형식의 윈도우 도움말 제작하기 #5 [完]

HLP 형식의 윈도우 도움말 제작하기 #1


HLP 도움말은 Windows 3.1부터 Windows XP까지 지원하던 도움말 형식으로서, 내부적으로는 여러개의 RTF 문서 파일로 이루어져 있다. Windows Vista 이후에 출시되는 Windows 운영체제(Vista, 2008, 7, 2010, 8, 2012, 8.1, 10, ...)에서는 공식적으로 지원하지는 않는다. 이번 시리즈에서는 HLP 도움말을 제작하고, WinAPI에서 이를 불러오는 방법까지 알아보겠다.

준비물: 1. Windows XP 또는 그 이전 버전 운영체제, 2. Microsoft Word (아무 버전이나), 3. Microsoft Visual Studio 6.0

 

RTF 문서 준비하기


Microsoft Word를 켜고 아래와 같이 예제 문서를 작성해본다. 예제 문서니까 이것저것 서식도 마음대로 넣어보는 것이 가능하다.

 

저장할 때 파일 형식은 반드시 서식 있는 텍스트 또는 서식 있는 텍스트 (*.rtf)으로 지정한다.

 

HLP 문서 생성하기


[시작] 버튼-[모든 프로그램]-[Microsoft Visual Studio 6.0]-[Microsoft Visual Studio 6.0 도구들]-[Help Workshop]을 클릭한다.

 

프로젝트 생성하기


[File]-[New]를 눌러 [Help Project]를 선택한 후 [OK]를 누른다. 파일 저장 대화상자가 뜨면 적당한 경로에 프로젝트 파일 이름을 지정한 후 [저장(S)] 버튼을 누른다. 이 때, 확장자는 .hpj이다. 주의할 것은, 경로명에 한글이 들어갈 경우 hlp 파일이 제대로 생성되지 않을 수 있다는 것이다. 경로에 한글이 들어가지 않도록 주의해야 한다.

예) C:\프로젝트\project.hpj (X) -> C:\project\project.hpj (O)

 

프로젝트에 RTF 문서 추가하기


프로젝트 파일이 생성되며 화면이 아래와 같이 변한다. [Options...] 버튼을 누른다. 이 도움말 파일의 이름이나 내용 등을 적을 수 있는 부분이다.

'Help title:'에는 이 도움말 파일의 제목을 적는다. 'Copyright Information'에는 저작권 관련 문구를 적어넣을 수 있다. 'Display this text in the Version dialog box:'에는 버전 정보 대화상자에 보여줄 문구를 지정하고, 'If users paste or print Help text, display:'에는 사용자가 도움말의 일부를 복사/붙여넣기하거나 인쇄를 할 때 딸려오는 저작권 관련 문구를 적을 수 있다.

 

대화상자에 입력한 내용이 프로젝트 파일에 반영되었음을 확인할 수 있다.

 

이번에는 [Files...]를 누른다. 'Topic Files'이라는 대화상자는 이 도움말에 포함된 .rtf 파일들의 목록들을 보여주는 창인데, 아무것도 없으므로 [Add...]를 눌러 파일을 하나 추가한다.

 

프로젝트 컴파일


아래와 같이 Microsoft Word에서 작성했던 rtf 파일이 추가되었다. 우선 결과를 보기위해 우측 하단의 [Save and Compile] 버튼을 클릭한다.

아무 문제없이 .hlp 형식 도움말 파일이 생성완료 되었다면 hlp 파일의 경로가 뜨면서 생성 완료되었다는 메시지가 출력될 것이다.

 

아래와 같이 .hlp 도움말 파일이 생성되었음을 확인할 수 있다. 더블클릭하여 열었을 때, Microsoft Word에서 작성했던 .rtf 파일과 같은 내용이 보인다면 성공한 것이다.

 

Epilogue


그럼 이어서 다음 글에서는 rtf 파일에 이미지와 표를 넣어보도록 한다.

 

카테고리 “Microsoft Windows/Win32 도움말 연동”
more...

“hlp” (5건)

개발괴발로 작성하는 개발자 블로그.