ドキュメンテーション

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

iptcheckhandle

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

構文

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

説明

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

valid_types は、H がどこに属するのかを予測するためにハンドル グラフィックス オブジェクト タイプのセットを指定する文字列のセル配列です。たとえば、{'uipanel','figure'} として valid_types を指定した場合、H は 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 引数を使用してカスタマイズ可能な箇所を示します。

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