5.4.4 CControlPoint::ReloadCategory

書式

void ReloadCategory( int master , const CString & key , int search , int nonmatch )

throw( CSymNaviException )

パラメタ

master	（in）	検索の指定がラベルに対する検索か、コードに対する検索かを指定 NAVI_LABEL: ラベル NAVI_CODE: コード（マスタ型のみ有効）
key	（in）	検索する文字列
search	（in）	検索方法の指定 NAVI_ALL: すべてのカテゴリ NAVI_COMPLETE: 指定された文字列と完全に一致するカテゴリ NAVI_FROMSTART: 先頭が指定された文字列と一致するカテゴリ NAVI_PARTIAL: 指定された文字列とどこかが一致するカテゴリ NAVI_FROMEND:末尾が指定された文字列と一致するカテゴリ NAVI_NOLOAD:指定した文字列を読み込んだものとみなす
nonmatch	（in）	読み込むのは、一致するカテゴリか、一致しないカテゴリか NAVI_MATCH:一致するカテゴリを読み込む NAVI_NONMATCH:一致しないカテゴリを読み込む

例外

エラーが発生した場合、CSymNaviExceptionオブジェクトを返却します。

例外詳細コード

説明

すでに読み込まれているカテゴリを一度破棄し、検索条件を指定して、サーバ（辞書）からカテゴリを読み込み直します。パラメタsearch にNAVI_NOLOADを指定した場合は、サーバ（辞書）にアクセスしません。

本関数は、マスタ型、カテゴリ型、全値型、および範囲型の管理ポイントに対してのみ有効です。これ以外を指定した場合、本関数はエラーとなります。

パラメタkey に複数の文字列を指定する場合は、カンマで区切って指定してください。

再読み込みするカテゴリがコードで数値型の場合、パラメタsearch に指定できるのは、NAVI_ALL とNAVI_COMPLETE だけです。それ以外を指定するとエラーとなります。

パラメタsearch にNAVI_NOLOAD が指定できるのは全値型管理ポイントの場合だけです。それ以外の管理ポイントに対して指定するとエラーになります。

範囲型、およびカテゴリ型の管理ポイントに対しては、パラメタsearch にNAVI_ALL を指定してください。範囲型の管理ポイントの場合、NAVI_ALL 以外を指定するとエラーとなります。カテゴリ型の管理ポイントの場合、NAVI_ALL 以外の指定は無効になります。

パラメタsearch にNAVI_ALL が指定された場合、パラメタkey、およびパラメタnonmatch の値は無視されます。

パラメタsearch にNAVI_NOLOAD が指定された場合、パラメタnonmatch の値は無視されます。

問い合わせが複数のレポートを含み、操作対象の管理ポイントが表側にある場合は、本関数はすべてのページの管理ポイントを対象として動作します。

カテゴリの数が0個の場合、および8000個を超えた場合はエラーとなります。

エラーメッセージは、CSymNaviException::GetErrorMessage を用いて取得できます。

エラー例外詳細コードは、CSymNaviException::GetReturnCode を用いて取得できます。

『CSVファイル、またはShunsaku利用時の注意事項』

以下の条件を満たすときに、searchにNAVI_FROMSTART、またはNAVI_FROMENDを指定するとエラーとなります。詳細コードには、NAVI_ERROR_NOSUPPORTが返却されます。

※旧バージョンの詳細コード「NAVI_ERROR_SHUNSAKU」は、Shunsakuを利用する場合に、互換用コードとして利用できます。