HTML Helpの作成方法(基本編)
ウインドウのボタンやサイズを変更する

HTML Helpウインドウ上部のボタンバーに表示されるボタンの種類や、ウインドウのサイズ、位置などを変更できます。また、[検索]タブ、[お気に入り]タブを追加できます。

ウインドウを変更するためには、まずウインドウタイプを追加し、ウインドウタイプごとに外観を設定します。最初に設定したウインドウタイプがデフォルトウインドウのタイプとなり、特に何も指定しないと、この設定でHTML Helpが表示されます。

  • 複数のウインドウタイプを設定し、目次やキーワードを選択したときに、デフォルトウインドウとは別のウインドウにトピックが表示されるように設定することもできます。詳しくは、「二次ウインドウを表示する」をご覧ください。

ウインドウタイプの設定

  1. [Project]タブの アイコン(Add/Modify window definitions)をクリックします。
    [Add a New Window Type]ダイアログが表示されます。
  2. 新しく作成するウインドウタイプ名(任意の名前)を入力し、[OK]ボタンをクリックします。
    [Window Types]ダイアログが表示されます。
  3. 各タブをクリックし、必要に応じて設定を変更します。
    詳しくは、次の項をご覧ください。
  4. [OK]ボタンをクリックします。
    [Navigation Pane]タブの[Search tab]にチェックを付けている場合は、[Resolve Window Definition]ダイアログが表示されます。
  5. [次へ]ボタンをクリックします。
  6. [Compile full-text information]にチェックを付け、[次へ]ボタンをクリックします。
  7. [完了]ボタンをクリックします。
    ウインドウタイプが定義され、現在のプロジェクトに設定されます。[Project]タブの[WINDOWS]セクションに、ウインドウタイプの設定内容が表示されます。

[Window Types]ダイアログでの設定

ウインドウのタイトルバーにタイトルを表示するには

  • [General]タブの[Title bar text]に、タイトルを入力します。
    入力したタイトルがHTML Helpウインドウのタイトルバーに表示されます。
  • ウインドウタイプを定義しないでも、[Project]タブの アイコン(Change project options)で[Options]ダイアログを表示し、[General]タブの[Title]に入力すれば、タイトルが設定されます。
  • [Add a New Window Type]ダイアログと[Options]ダイアログの両方でタイトルを設定している場合は、[Window Types]ダイアログの設定の方が優先されます。

ボタンの種類を変更するには

  • [Buttons]タブで、ウインドウに表示するボタンにチェックマークを付けます。
  • [Jump]にチェックを付けた場合は、ジャンプボタンに表示する文字を入力します。ジャンプ先のファイル名やURLは、[Files]タブで別に指定します。
  • [Home]にチェックを付けた場合も、[Files]タブでファイル名またはURLを指定します。

ウインドウの表示サイズと位置を変更するには

  • [Position]タブで、ウインドウの[Left][Top]の座標値(単位:ピクセル)を入力すると、指定した位置を左上としてウインドウが表示されます。
    [Width]と[Height]には、ウインドウの幅と高さを入力します。
    [Left][Top][Width][Height]を0にすると、初期設定の位置とサイズ(デフォルトウインドウは画面中央付近、二次ウインドウは画面右上)で表示されます。
  • [Autosizer]ボタンをクリックすると、サンプルウインドウが表示されます。このウインドウのサイズと位置をドラッグして変更し、[OK]ボタンをクリックすると、その座標値が自動的にテキストボックスに入力されます。

ウインドウの表示サイズと位置を固定するには

  • 初期設定では、ユーザがHTML Helpウインドウを表示し、サイズや位置を変更すると、その情報がhh.datファイルに保存されます。次回にHTML Helpウインドウ表示する時は、そのサイズと位置でウインドウが表示されます。このサイズと位置を最初の状態のまま固定するには、[Position]タブで、[Save user defined window position after first use]のチェックを外し、かつその下の[Left][Top][Width][Height]に0以外の数値を指定します。
  • 初期設定の状態で[Position]タブを表示しても[Save user defined window position after first use]のチェックが外れていますが、[Left][Top][Width][Height]に0以外を指定しないと、ユーザが変更した内容が保存されてしまいますので、ご注意ください。

最初に表示するタブを指定するには

  • [Navigation Pane]タブの[Default tab]で、[Contents(目次)][Index(キーワード)][Favorites(お気に入り)] [Search(検索)] のいずれかを選択します。(現在設定されているタブのみ選択可能。)
  • この設定は、ユーザが最初にヘルプを指定した場合のみ有効です。ユーザが他のタブを指定してヘルプを閉じると、その情報がhh.datファイルに保存され、次回は最後に表示したタブが上に表示されます。[Save user defined window position after first use]のチェックが外れていても、タブの情報は保存されます。
  • プログラムからHTML Helpを呼び出す場合は、[目次] [キーワード]タブのいずれかを常に上にした状態で表示するように設定できます。

ナビゲーションペインの横幅を指定するには

  • ウインドウ左側のナビゲーションペイン(目次やキーワードが表示される部分)の横幅を指定するには、[Navigation Pane]タブの[Window with navigation pane, topic, and button bar]にチェックを付け、[Navigation pane width]の右の数値入力欄に横幅を入力します。
  • [Position]タブの[Save user defined window position after first use]にチェックを付けている場合、ユーザがナビゲーションペインの幅を変更してヘルプを閉じると、その情報がhh.datファイルに保存され、次回はその幅で表示されます。
    [Save user defined window position after first use]のチェックを外している場合は、 [Navigation pane width]で指定した幅で常に表示されます。

[検索]タブを追加するには

  • 全文検索を行う[検索]タブは、初期設定ではHTML Helpウインドウに表示されません。
    [検索]タブを追加するには、[Navigation Pane]タブの[Window with navigation pane, topic, and button bar]にチェックを付けた後、ダイアログ右下の[Tabs]の[Search tab]にチェックを付けます。
  • [Search tab]の下の[Advanced]はHTML Help 1.2からの機能です。チェックを付けると、[検索]タブにAND、OR、NOT、NEAR検索や絞り込み検索の項目が追加されます。チェックを外すと語句を入力しての全文検索のみになります。通常はチェックを付ける方がよいでしょう。
  • [検索]タブについて詳しくは、「検索タブの使い方」をご覧ください。

[お気に入り]タブを追加するには

  • [お気に入り]タブでは、任意のヘルプトピックを「お気に入り」のリストに登録しておき、リストから選択して表示できます。
    [お気に入り]タブを追加するには、 [Navigation Pane]タブの[Tabs]の[Favorites Tab]にチェックを付けます。
  • [お気に入り]タブの情報は、hh.datファイルに保存されます。このファイルを削除すると、[お気に入り]のリストは空白に戻ります。hh.datファイルには、HTML Helpウインドウの位置やサイズの情報も登録されます。

[キーワード]タブを削除するには

  • 最初から[キーワード]タブを付けたくないと考えている場合は、索引ファイル(*.hhk)を作成しなければそれでOKです。HTML Help Workshopの[Index]タブをクリックして[Create a new index file]を選択すると索引ファイルが作成されてしまいますので、[Index]タブをクリックしないようにしてください。
  • 索引ファイルを作成した後で、[キーワード]タブを削除したくなった場合は、[Window Types]ダイアログの[Files]タブを表示し、[Index]の索引ファイル名を消去してください。
  • ウインドウタイプを定義していない場合は、[Project]タブの アイコン(Change project options)で[Options]ダイアログを表示し、[Files]タブの[Index File]のファイル名を消去します。

タブとボタンバーを非表示にするには

  • [Navigation Pane]タブの[Window with navigation pane, topic, and button bar]のチェックを外します。