{{div_begin}}
[[←　7 章に戻る|C/C++ Sync Suite Reference601/7]]　[[↑トップへ|C/C++ Sync Suite Reference601]]　[[9 章に進む　→|C/C++ Sync Suite Reference601/9]]
{{div_end}}

{{div_begin style="margin-bottom:-10px"}}
!!!8 Palm OS 一般言語 API
{{div_end}}

{{div_begin "style='position:absolute;right:0px;font-size:70%;margin-right:15px;margin-top:15px;width:250px;'"}}
*{{goto Palm OS Common Language Constants,Palm OS 一般言語定数}}
*{{goto Palm OS Common Language Functions,Palm OS 一般言語関数}}
**{{goto PalmFreeLanguage,PalmFreeLanguage}}
**{{goto PalmGetResourceVersion,PalmGetResourceVersion}}
**{{goto PalmGetVersion,PalmGetVersion}}
**{{goto PalmLoadLanguage,PalmLoadLanguage}}
{{div_end}}

{{div_begin "style='position:relative;padding:0px;padding-right:5px;padding-left:10px;margin-right:250px;margin-top:20px;width:auto;border-right-style:dotted;border-right-width:2px;border-right-color:silver;'"}}
Palm OS 一般言語 API はあなたのコンジットが言語リソース DLL をロード、アンロードすることを可能にします。例えば、コンジットがフランス語バージョンのリソースを必要とする場合、そのコンジットはこれらの関数を呼び出してフランス語リソースだけを保持している DLL からフランス語リソースを表示することができます。コンジットがフランス語 DLL を見つけられない場合、デフォルトをコンジット DLL のリソースで使用されているベース言語にします。

::重要
:::あなたのコンジットが言語リソースを選択するこの手段を使用する場合、あなたの言語リソース DLL のために固有名を作成します。

Palm OS 一般言語関数は {{span style='color:blue;font-family:monospace;',PalmCmn.dll}} で利用可能であり、{{span style='color:blue;font-family:monospace;',PALM_CMN.H}} と {{span style='color:blue;font-family:monospace;',LANG_DLL.h}} で宣言されています。

この章は以下の節に分かれています:

*{{goto Palm OS Common Language Constants,Palm OS 一般言語定数}}
*{{goto Palm OS Common Language Functions,Palm OS 一般言語関数}}


!!{{anchor Palm OS Common Language Constants}}Palm OS 一般言語定数 {{goto top,^TOP^}}

'''目的'''

リソース DLL の言語を定義します。

'''宣言されている場所'''

{{span style='color:blue;font-family:monospace;',LANG_DLL.h}}

'''定数'''

*{{span style='color:blue;font-family:monospace;',define LANGUAGE_DUTCH 0x0200 }}
**オランダ語リソース。
*{{span style='color:blue;font-family:monospace;',define LANGUAGE_ENGLISH 0x0010 }}
**英語リソース。
*{{span style='color:blue;font-family:monospace;',define LANGUAGE_FRENCH 0x0020 }}
**フランス語リソース。
*{{span style='color:blue;font-family:monospace;',define LANGUAGE_GERMAN 0x0040 }}
**ドイツ語リソース。
*{{span style='color:blue;font-family:monospace;',define LANGUAGE_ITALIAN 0x0100 }}
**イタリア語リソース。
*{{span style='color:blue;font-family:monospace;',define LANGUAGE_JAPANESE 0x1000 }}
**日本語リソース。
*{{span style='color:blue;font-family:monospace;',define LANGUAGE_PORTUGUESE 0x0400 }}
**ポルトガル語リソース。
*{{span style='color:blue;font-family:monospace;',define LANGUAGE_SCHINESE 0x2000 }}
**中国語 (簡体) リソース。
*{{span style='color:blue;font-family:monospace;',define LANGUAGE_SPANISH 0x0080 }}
**スペイン語リソース。
*{{span style='color:blue;font-family:monospace;',define LANGUAGE_TCHINESE 0x4000 }}
**中国語 (繁体) リソース。

'''コメント'''

{{goto PalmGetResourceVersion,PalmGetResourceVersion()}} は指定された DLL の言語リソースを示すためにこれらの定数の 1 つを返します。

'''互換性'''

*Palm OS 一般言語 API バージョン: 1
*Palm OS バージョン: すべて


!!{{anchor Palm OS Common Language Functions}}Palm OS 一般言語関数 {{goto top,^TOP^}}

この節では以下の Palm OS 一般言語関数について説明します。

,関数,説明
,"{{goto PalmFreeLanguage,PalmFreeLanguage}}",指定された言語リソース DLL をアンロードします。
,"{{goto PalmGetResourceVersion,PalmGetResourceVersion}}",指定された DLL の言語リソースを返します。
,"{{goto PalmGetVersion,PalmGetVersion}}",Palm OS 一般言語 API のバージョンを返します。
,"{{goto PalmLoadLanguage,PalmLoadLanguage}}",指定された言語リソース DLL をロードします。


!{{anchor PalmFreeLanguage}}PalmFreeLanguage {{goto top,^TOP^}}

'''目的'''

指定された言語リソース DLL をアンロードします。

'''宣言されている場所'''

{{span style='color:blue;font-family:monospace;',PALM_CMN.H}}

'''Prototype'''

 BOOL PalmFreeLanguage (
    HINSTANCE hRscInst,
    HINSTANCE hAppInst
 )

'''パラメータ'''

*{{span style='color:blue;font-family:monospace;',→ hRscInst}}
**アンロードするリソースのインスタンス ハンドル。この値に {{goto PalmLoadLanguage,PalmLoadLanguage()}} の返り値をセットします。
*{{span style='color:blue;font-family:monospace;',→ hAppInst}}
**この関数を呼び出しているアプリケーションのインスタンス ハンドル。

'''返り値'''

成功した場合、{{span style='color:blue;font-family:monospace;',true}} を返します。

失敗した場合、{{span style='color:blue;font-family:monospace;',false}} を返します。

'''コメント'''

{{span style='color:blue;font-family:monospace;',PalmLoadLanguage}} によってロードされた言語リソース DLL を解放するには、{{span style='color:blue;font-family:monospace;',PalmFreeLanguage}} に {{span style='color:blue;font-family:monospace;',PalmLoadLanguage}} によって返された値を渡します。これはロードされた言語リソース DLL のハンドルです。{{span style='color:blue;font-family:monospace;',hRscInst}} ハンドルと {{span style='color:blue;font-family:monospace;',hAppInst}} ハンドルが同じである場合、この関数は何もせず (なぜなら解放するものが無いからです)、{{span style='color:blue;font-family:monospace;',true}} を返します。

'''互換性'''

*Palm OS 一般言語 API バージョン: 1
*Palm OS バージョン: すべて


!{{anchor PalmGetResourceVersion}}PalmGetResourceVersion {{goto top,^TOP^}}

'''目的'''

指定された DLL の言語リソースを返します。

'''宣言されている場所'''

{{span style='color:blue;font-family:monospace;',PALM_CMN.H}}

'''Prototype'''

 DWORD PalmGetResourceVersion (
    HINSTANCE hLangInstance
 )

'''パラメータ'''

*{{span style='color:blue;font-family:monospace;',→ hLangInstance}}
**言語リソース DLL のインスタンス ハンドル。

'''返り値'''

指定された DLL の言語を示す定数の 1 つを返します ({{goto Palm OS Common Language Constants,「Palm OS 一般言語定数」}} を参照してください)。

'''互換性'''

*Palm OS 一般言語 API バージョン: 1
*Palm OS バージョン: すべて


!{{anchor PalmGetVersion}}PalmGetVersion {{goto top,^TOP^}}

'''目的'''

Palm OS 一般言語 API のバージョンを返します。

'''宣言されている場所'''

{{span style='color:blue;font-family:monospace;',PALM_CMN.H}}

'''Prototype'''

 DWORD PalmGetVersion (
    void
 )

'''パラメータ'''

ありません。

'''返り値'''

Palm OS 一般言語 API のバージョン番号を返します。

'''互換性'''

*Palm OS 一般言語 API バージョン: 1
*Palm OS バージョン: すべて


!{{anchor PalmLoadLanguage}}PalmLoadLanguage {{goto top,^TOP^}}

'''目的'''

指定された言語リソース DLL をロードします。

'''宣言されている場所'''

{{span style='color:blue;font-family:monospace;',PALM_CMN.H}}

'''Prototype'''

 HINSTANCE PalmLoadLanguage (
    LPCTSTR pFileName,
    HINSTANCE hAppInst,
    DWORD *pdwVersion
 )

'''パラメータ'''

*{{span style='color:blue;font-family:monospace;',→ pFileName}}
**ロードする DLL のファイル名へのポインタ。
*{{span style='color:blue;font-family:monospace;',→ hAppInst}}
**この関数を呼び出しているアプリケーションのインスタンス ハンドル。
*{{span style='color:blue;font-family:monospace;',← pdwVersion}}
**この関数によってロードされた DLL の言語を示す定数の 1 つへのポインタ ({{goto Palm OS Common Language Constants,「Palm OS 一般言語定数」}} を参照してください)。

'''返り値'''

この関数が指定された DLL を見つけた場合、関数がロードした言語リソース DLL へのインスタンス ハンドルを返します。

この関数が指定された DLL を見つけられなかった場合、{{span style='color:blue;font-family:monospace;',hAppInst}} に渡されたインスタンス ハンドル - つまり、この関数を呼び出した何ものかのハンドル - を返します。

'''コメント'''

返り値はこの関数がロードした言語リソース DLL のハンドルです。例えば、あなたのコンジットに以下の記述が含まれている場合、

   hRscInstance = PalmLoadLanguage("MYCLANG.DLL",
                  hDLLInstance, &dwVersion);

{{span style='color:blue;font-family:monospace;',PalmLoadLanguage}} は {{span style='color:blue;font-family:monospace;',MYCLANG.DLL}} を探します (そしてそれをロードしようとします)。{{span style='color:blue;font-family:monospace;',MYCLANG.DLL}} はあなたのコンジットのためのローカライズされているリソースを保持しています。リソースのロードに成功した場合、この関数はそのリソースのインスタンス ハンドルを返します。この関数が DLL を見つけられなかったり何らかの理由でロードに失敗した場合、{{span style='color:blue;font-family:monospace;',PalmLoadLanguage}} はあなたのコンジット DLL のインスタンス ハンドルを返すので、あなたのコンジットはそのコンジット DLL 自体の中にコンパイルされているリソースを使用します。

{{goto PalmFreeLanguage,PalmFreeLanguage()}} 関数の中の {{span style='color:blue;font-family:monospace;',hRscInst}} にはこの関数の返り値をセットします。

'''互換性'''

*Palm OS 一般言語 API バージョン: 1
*Palm OS バージョン: すべて

{{div_end}}

{{div_begin "style='border-top-style:solid;border-top-width:1px;border-top-color:silver;'"}}
[[←　7 章に戻る|C/C++ Sync Suite Reference601/7]]　[[↑トップへ|C/C++ Sync Suite Reference601]]　[[9 章に進む　→|C/C++ Sync Suite Reference601/9]]
{{div_end}}