방법: 사용자 도움말 표시

아티클
08/20/2008

업데이트: 2007년 11월

.NET Compact Framework에서는 Windows CE 도움말 프로그램인 peghelp.exe에 대한 액세스를 제공하여 Pocket PC 응용 프로그램에 대한 도움말 항목을 표시합니다. HelpRequested 이벤트에 응답하는 Windows Forms Help 클래스의 ShowHelp 메서드를 사용하여 도움말 항목을 표시하고 HelpEventArgs를 사용할 수 있습니다. .NET Compact Framework에서는 HelpNavigator 열거형이나 HelpProvider 클래스를 지원하지 않습니다.

도움말 항목은 하나 이상의 .htm 파일에 있을 수 있습니다. 컴파일된 HTML(또는 .chm 파일)은 Pocket PC에서 지원되지 않습니다. 사용자가 시작 메뉴로 이동하여 도움말을 선택하면 현재 활성 폼에서 HelpRequested 이벤트를 수신합니다. 이 이벤트는 폼의 컨트롤에서 발생되지 않습니다.

Smartphone 응용 프로그램은 간단해야 하므로 도움말은 Smartphone 운영 체제에 통합되어 있지 않습니다.

다음 표에서는 각 항목에 대해 표시되는 시스템 도움말 기능을 보여 줍니다.

메뉴 항목	기능
보기	현재 도움말 파일의 첫 번째 목차 수준을 표시하는 목차 명령과 설치된 도움말 파일 목록을 표시하는 설치된 전체 도움말 명령에 대한 액세스를 제공합니다.
뒤로	현재 세션에서 이전에 본 항목을 표시합니다.
앞으로	기록 목록의 다음 항목을 표시합니다.
찾기	키워드로 도움말 항목을 검색할 수 있도록 찾기 대화 상자를 엽니다. .htm 파일에 키워드를 지정할 수 있습니다.

아래 절차에서는 다음 작업을 수행하는 방법을 보여 줍니다.

도움말 항목의 .htm 파일 만들기
응용 프로그램의 도움말 표시
장치에 도움말 파일 설치

도움말 항목의 .htm 파일 만들기

해당 도움말 항목과 관련된 이름 및 .htm 확장명을 사용하여 텍스트 파일을 만듭니다. 이 절차에서는 예로 Critters라는 게임에 대한 도움말을 만듭니다. 이 파일의 헤더에는 다음과 같이 META 태그가 있어야 합니다.
```
<HTML>
<HEAD>
<META HTTP-EQUIV="Htm-Help" Content="Critters.htm#main_contents">
```
각 도움말 파일의 첫 번째 항목은 "main_contents"로 명명됩니다.
찾기 프로그램에 키워드를 추가합니다. 키워드는 세미콜론을 사용하여 구분합니다. 특정 항목에 대한 링크에 키워드 태그를 필요한 만큼 추가합니다.
```
<KEYWORD VALUE="Critters;Games" TITLE="Critters Help" 
 HREF="Critters.htm#main_contents">
<KEYWORD VALUE="Critters overview" TITLE="Critters Help" 
 HREF="Critters.htm#overview">
<KEYWORD VALUE="Critters options" TITLE="Critters Help" 
 HREF="Critters.htm#options">
```
한 항목에 사용할 수 있는 키워드 수는 제한이 없습니다.
main_contents 항목을 만듭니다. main_contents를 포함하여 각 항목 앞에는 다음과 같은 주석 태그가 있어야 합니다.
```

```
main_contents 항목에는 일반적으로 하위 항목에 대한 링크가 포함되어 있습니다. 링크에는 앵커 이름 외에도 파일 이름이 있어야 합니다.
```
</head>
<body>

<a name="Main_Contents"></a>
Critters Help

<a href="critters.htm#overview">Game Overview</a> 
<a href="critters.htm#options">Options</a> 
```
그래픽을 추가할 수 있으나 "2bp" 확장명을 갖도록 이름 변경이 가능한 비트맵만 추가할 수 있습니다.
```
<img src="critter.2bp">
```

추가 항목을 만듭니다.

다음은 두 항목 사이의 HTML 예입니다.

</p>
<!-- PegHelp -->
<!-- ******* TOPIC BREAK ******* -->
<hr>
<a name="overview">

파일을 저장하고 Pocket PC의 Windows 디렉터리에 복사합니다.

이 예제의 완성된 HTML은 다음과 같습니다.

<html>
<head>
<META HTTP-EQUIV="Htm-Help" Content="critters.htm#Main_Contents">
<KEYWORD VALUE="Critters;Games" TITLE="Critters Help" 
  HREF="Critters.htm#main_contents">
<KEYWORD VALUE="Critters overview" TITLE="Critters Help" 
  HREF="Critters.htm#overview">
<KEYWORD VALUE="Critters options" TITLE="Critters Help" 
  HREF="Critters.htm#options">
</head>
<body>
<!-- PegHelp -->
<p>
<a name="Main_Contents"></a>
</p>
<b>Critters Help</b>
</p>
<p>
<a href="critters.htm#overview">Game Overview</a><br>
<a href="critters.htm#options">Game Options</a><br>
<img src="critter.2bp">
</p>
<!-- PegHelp -->
<!-- ******* TOPIC BREAK ******* -->
<hr>
<a name="overview"></a>
<p><b>Game Overview</b></p>
<p>Critters are small round creatures that you can adopt and raise.  
  They have various moods and characteristics and each one has its own 
  personality and appearance that will change over time.</p>
<!-- PegHelp -->
<!-- ******* TOPIC BREAK ******* -->
<hr>
<a name="options"></a>
<p><b>Options</b></p>
<ul>
<li><i>Sound</i> – Turn sound on / off</li>
<li><i>Sub-Games</i> – Turn sub-games on / off.  When a caretaker 
  attempts to play with a critter or teach a critter, sub-games are 
  presented such as ‘Guess my number’ and ‘Trivia’ if this option is 
  checked.</li>
<li><i>Animation</i> – Turn animation on / off.  Turning this off will 
  cause the critter to remain still.</li>
<li><i>Notifications</i> – Choose icon / text / none.  Notifications 
  appear to inform you when your critter is in danger of dying due to 
  a particular need not being met.</li>
<li><i>Speed</i> – This is the rate at which the game engine operates.
  It affects how fast feelings develop and statistics are 
  modified.</li>
</ul>
</p>
</body>
</html>

참고:
도움말 파일로 작업할 때 이전 버전의 도움말이 캐시에 있어서 사용자가 최신 업데이트를 보지 못하는 경우도 있습니다. 새로 고치려면 작업하고 있던 도움말 항목이 아닌 다른 항목을 표시한 다음 사용자의 도움말을 다시 표시합니다.

응용 프로그램에 대한 도움말을 표시하려면

Pocket PC에서 도움말을 표시하려면 시작 메뉴에서 도움말 명령을 누릅니다. 사용자가 HelpRequested 이벤트에 대한 응답으로 ShowHelp 메서드를 호출한 경우, Windows CE는 현재 표시된 응용 프로그램에 대한 도움말 항목을 표시합니다.

또한 ShowHelp를 사용하면 응용 프로그램 내에서 단추 클릭 등으로 도움말을 호출할 수도 있습니다. 다음 코드 예제에서는 두 경우 모두에 대해 도움말을 호출하는 방법을 보여 줍니다. ShowHelp 메서드의 첫 번째 매개 변수는 부모 컨트롤입니다. 이 매개 변수는 Pocket PC와 관련이 없지만 전체 .NET Framework와의 호환성을 위해 제공됩니다.

Protected Overrides Sub OnHelpRequested(ByVal hlpevent As HelpEventArgs) 
    ' The HelpRequested event occurs when
    ' the user taps Help on the Start menu.
    Help.ShowHelp(Me, "\windows\myAppHelp.htm#Main_Contents")
    MyBase.OnHelpRequested(hlpevent)

End Sub
Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles button1.Click
    ' You can also show Help
    ' for a subtopic
    ' by clicking a button.
    Try
        Help.ShowHelp(Me, "\windows\myappHelp.htm#overview")
    Catch ex As Exception
        MessageBox.Show(ex.Message)
    End Try
End Sub

protected override void OnHelpRequested(HelpEventArgs hlpevent)
{
    // The HelpRequested event occurs when
    // the user taps Help on the Start menu.
    Help.ShowHelp(this,@"\windows\myAppHelp.htm#Main_Contents");
    base.OnHelpRequested(hlpevent);
}

private void button1_Click(object sender, System.EventArgs e)
{
    // You can also show Help
    // for a subtopic
    // by clicking a button.
    try
    {
        Help.ShowHelp(this,@"\windows\myappHelp.htm#overview");
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message);
    }
}

장치에 도움말 파일을 설치하려면

도움말 시스템에 대한 바로 가기 파일을 만들어 시스템에 설치된 다른 도움말과 함께 사용자의 도움말을 나열합니다. 텍스트 편집기에서 다음 구문을 사용하여 사용자의 도움말에 대한 경로가 있는 파일을 만듭니다.
```
14#\windows\critters.htm
```
경로 앞에는 경로의 문자 수와 숫자 기호(#)가 나옵니다. 이것은 파일에서 한 줄에 지정해야 합니다. 이 예제에서는 Critters 게임에 대한 도움말이 표시됩니다.
사용자의 도움말과 같은 이름을 사용하고 확장명이 .lnk인 파일을 \Windows\Help 폴더에 저장합니다.
시작 메뉴에서 도움말을 누릅니다. 도움말이 표시되어 있지 않으면 보기 메뉴에서 설치된 전체 도움말을 선택합니다. 도움말은 목록에 사전순으로 포함되어 있어야 합니다.

다음을 통해 공유

방법: 사용자 도움말 표시

도움말 항목의 .htm 파일 만들기

응용 프로그램에 대한 도움말을 표시하려면

장치에 도움말 파일을 설치하려면

참고 항목

개념

기타 리소스

추가 리소스