LMS_GetTextByLabel

この関数は、関数の呼び出しを単純化する目的で設けられたヘルパ関数です。内部的にはLMS_GetTextIndexByLabel関数とLMS_GetText関数の二つの関数を順番に呼び出しているだけです。

構文

const void* LMS_GetTextByLabel( LMSMsgFile *pFile, const char* pLabel );

引数

引数名	型	意味
pFile	LMSMsgFile*	インデックス番号を検索する対象のメッセージファイルオブジェクトを指定してください(LMS_InitMessage関数で返ってきた値)。
pLabel	const char*	検索したいラベル文字列へのポインタを指定してください。NULL終端のASCII文字列である必要があります。

戻り値

実際のテキスト情報が返ります。この値はconst void*型になっていますのでキャストして使用してください (テキストのエンコーディング形式を設定できるのでこのような形になっています)。 入力されたテキスト情報は、タグを含む場合があります。 このタグはアプリケーション側でハンドリングする必要があります。 詳しくはタグの入ったテキストフォーマットの項をご覧ください。

注意事項

この関数を利用する場合、データの出力設定で「テキストラベルの対応情報ブロック(LBL1)を埋め込む」にチェックを入れておく必要があります(規定値は出力する設定になっています)。