コンポーネント用のヘルプの作成
独自の CHM ヘルプ ファイルを作成して RAD Studio に追加することができます。このトピックでは、新しいライブラリ ファイルのヘルプを作成する方法について説明します。
F1 キーを押したら、そのときにフォーカスがあるクラスやメンバに応じて適切なファイルが開くように、ヘルプを作成することができます。
このトピックでは、CHM ファイルを作成する方法と、RAD Studio にヘルプ ファイルをインストールする方法を示します。CHM ヘルプ ファイルの考えられる構造を説明するサンプルも示します。
CHM ヘルプ ファイルのインストール
ファイルをコンパイルすると、.chm ファイルが生成されます。使用する言語に応じて、RAD Studio は CHM ファイルを次のいずれかのパスに格納します。
- 英語:
C:\Program Files (x86)\Embarcadero\Studio\23.0\Help\Doc
- ドイツ語:
C:\Program Files (x86)\Embarcadero\Studio\23.0\Help\Doc\de
- フランス語:
C:\Program Files (x86)\Embarcadero\Studio\23.0\Help\Doc\fr
- 日本語:
C:\Program Files (x86)\Embarcadero\Studio\23.0\Help\Doc\ja
以下のような CHM ファイルの言語に応じた適切な言語フォルダに CHM ファイルを格納する場合は、上記パスを使用する必要はなく、任意のフォルダに CHM ヘルプ ファイルをコピーすることができます。
- 英語:
MyDirectory
- ドイツ語:
MyDirectory\de
- フランス語:
MyDirectory\fr
- 日本語:
MyDirectory\ja
レジストリ エディタで新しい値を作成する必要があります。
- 次のパスに移動します。
HKEY_CURRENT_USER\Software\Embarcadero\BDS\23.0\Help\HtmlHelp1Files\
- 右ペインで、右クリックしコンテキスト メニューから[新規|文字列値]を選択したあと、新しい値を分かりやすい名前に変更します。
- この新しいエントリをダブルクリックし、[値のデータ]に完全パスと CHM ファイル名を追加します。たとえば、CHM の格納に RAD Studio と同じパスを使用している場合、[値のデータ]に
%programfiles(x86)%\Embarcadero\Studio\23.0\Help\Doc\NameOfYourCHM.chm
を追加する必要があります。ここで、NameOfYourCHM.chm は、既にコンパイルし上記のディレクトリにコピーしてある .chm ファイルです。英語のヘルプを追加していない場合でも、CHM の英語版のパスのみ指定します。必ず正しい .chm ファイル名を追加します。RAD Studio では、言語に応じて異なる上記のヘルプ言語フォルダで CHM ファイルを自動的に探します。複数言語のヘルプを追加する場合は、同じ .chm ファイル名の同じ翻訳版コンテンツのファイルであるか確認してください。- メモ: マクロを使ったパスはサポートされていません。環境変数のみ使用可能です。
.chm ファイルごとに、新しいレジストリ値を追加する必要があります。
CHM ヘルプのサンプル
このサンプルは、考えられる CHM の例を示しています。このサンプルでは、TClockLabel
という新しいコンポーネントと、そのコンポーネントの新規定義プロパティ Format
を使用しています。この新しいコンポーネントは、ClockLabel.pas
という新しいユニットに定義されています。
このサンプルでは、Welcome.htm
ページを、デフォルトで最初に開くページとして使用しています。
<Title></Title>
HTML タグで囲まれた名前および[Index]エントリの[Keyword]フィールドは、次の表に示すように、完全修飾名でなければなりませんが、それ以外は必要に応じて自由に構成できることを覚えておいてください。
次の表に示しているのは、<Title></Title>
HTML タグで囲まれた必須テキストと[Index]エントリの[Keyword]フィールドのテキスト(どちらも完全修飾名です)を持つ 4 レベルの CHM ヘルプのサンプルです。
項目 | 意味 | <Title></Title> HTML タグ間および[Index]エントリの[Keyword]フィールド
|
推奨される .htm ファイル名 |
---|---|---|---|
Welcome | デフォルト ページ | Welcome | Welcome.htm |
ClockLabel | ClockLabel.pas ユニット | ClockLabel | ClockLabel.htm |
TClockLabel | ClockLabel ユニット内に定義されている TClockLabel クラス | ClockLabel.TClockLabel | ClockLabel.TClockLabel.htm |
Format | TClockLabel クラスの Format プロパティ | ClockLabel.TClockLabel.Format | ClockLabel.TClockLabel.Format.htm |
上記の表では、考えられるサンプルを示しただけですので、たとえば、さらにレベルを追加してメソッド/プロパティを 1 つにまとめることもできます。==IDE のヘルプ メニューから CHM ファイルへアクセスできるようにする==
IDE を拡張して、[ヘルプ|サードパーティ ヘルプ] メニューに、ユーザーの製品用の項目を表示し、その CHM ファイルを開くためのメニュー項目を用意することができます。「Tools API を使用した IDE の拡張」では、IDE を拡張するための必須ステップが説明されており、「IDE のメイン メニューへの項目の追加」では、メイン メニューを拡張する方法が示されています。
ヘルプを [ヘルプ|サードパーティ ヘルプ] メニューに追加する方法を示すサンプル コードについては、次を参照してください: