ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

iptcheckhandle

ハンドルの有効性をチェック

構文

iptcheckhandle(obj, valid_types, func_name, var_name, arg_pos)

説明

iptcheckhandle(obj, valid_types, func_name, var_name, arg_pos) は、オブジェクト obj の有効性をチェックし、ハンドルが有効でない場合、書式化されたエラー メッセージを返します。obj は、1 つの figure、uipanel、hggroup、axes または image オブジェクトでなければなりません。

valid_types は、obj が属するべき MATLAB® グラフィックス オブジェクト タイプのセットを指定する文字ベクトルのセル配列です。たとえば、{'uipanel','figure'} を指定した場合、obj は uipanel オブジェクトまたは figure オブジェクトのいずれかのハンドルになります。

func_name は、チェックを実行する関数を識別するために書式化されたエラー メッセージで使われる名前を指定します。

var_name は、チェックされる引数を識別するために、書式化されたエラー メッセージで使用される名前を指定します。

arg_pos は、関数の引数リストでチェックされる引数の位置を示す正の整数です。iptcheckhandle は、この値を序数に変換し、書式化されたエラー メッセージにこの情報を含めます。

エラー メッセージをトリガーするために、axes オブジェクトを含まない figure を作成し、次に、有効な axes のハンドルをチェックします。

fig = figure; % create figure without an axes
iptcheckhandle(fig,{'axes'},'my_function','my_variable',2)

次の図では、エラー メッセージの形式と、iptcheckhandle 引数を使用してカスタマイズ可能な箇所を示します。

R2006a より前に導入

この情報は役に立ちましたか?