HelpProvider 구성 요소 개요(Windows Forms)
Windows Forms HelpProvider구성 요소를 사용하여 HTML Help 1.x 도움말 파일(HTML Help Workshop으로 만든 .chm 또는 .htm 파일)을 Windows 응용 프로그램에 연결할 수 있습니다. 다음과 같은 다양한 방식으로 도움말을 제공할 수 있습니다.
Windows Forms의 컨트롤에 대한 상황에 맞는 도움말을 제공합니다.
특정 대화 상자나 대화 상자의 특정 컨트롤에 대한 상황에 맞는 도움말을 제공합니다.
목차의 기본 페이지, 색인, 검색 기능 등의 특정 영역에서 도움말 파일을 엽니다.
Help Provider 사용
Windows Form에 HelpProvider 구성 요소를 추가하면 폼의 다른 컨트롤에서 HelpProvider 구성 요소의 도움말 속성을 노출할 수 있습니다. 따라서 Windows Form의 컨트롤에 대한 도움말을 제공할 수 있습니다. HelpNamespace 속성을 사용하여 HelpProvider 구성 요소를 도움말 파일과 연결할 수 있습니다. SetHelpNavigator를 호출하고 지정한 컨트롤에 대한 HelpNavigator 열거형의 값을 ㅈ공하여 도움말 형식을 지정합니다. SetHelpKeyword 메서드를 호출하여 도움말에 대한 키워드 또는 항목을 제공합니다.
필요에 따라 특정 도움말 문자열을 다른 컨트롤과 연결하려면 SetHelpString 메서드를 사용합니다. 컨트롤에 포커스가 있을 때 F1 키를 누르면 이 메서드를 사용하여 컨트롤과 연결한 문자열이 팝업 창에 표시됩니다.
HelpNamespace를 설정하지 않았으면 SetHelpString을 사용하여 도움말 텍스트를 제공해야 합니다. HelpNamespace와 도움말 문자열을 모두 설정한 경우에는 HelpNamespace를 사용하는 도움말이 우선합니다.
참고
HelpProvider 컨트롤의 HelpNamespace 속성 또는 ShowHelp 메서드에 도움말 파일에 대한 경로를 지정할 때 상대 경로를 사용하면 문제가 발생할 수 있습니다. 그러므로 도움말 파일을 지정할 때는 절대 파일 경로를 사용해야 합니다.