isgraphics

有効なグラフィックス オブジェクト ハンドルの場合は True

構文

tf = isgraphics(H)

tf = isgraphics(H,type)

説明

tf = isgraphics(H) は、有効なグラフィックス オブジェクトである H の要素に対して true を返し、有効なグラフィックス オブジェクトでないか、削除されたグラフィックス オブジェクトである要素に対して false を返します。

tf = isgraphics(H,type) は、引数 type によって指定されたタイプの有効なグラフィックス オブジェクトである H の要素に対して true を返します。オブジェクト タイプは、オブジェクトの Type プロパティに含まれている値です。

例

有効なハンドルのテスト

プロットを作成して、ハンドル配列を返します。有効なハンドルであるかどうか配列をテストします。

H = plot(rand(5));

isgraphics(H)

ans = 5×1 logical array

   1
   1
   1
   1
   1

ハンドル タイプのテスト

プロットを作成して、ハンドル配列を返します。他のグラフィックス オブジェクトと連結して、ハンドルのタイプが Line であるかどうかをテストします。

H = plot(rand(5)); 

a = [H;gca;gcf]; 
isgraphics(a,'line')

ans = 7×1 logical array

   1
   1
   1
   1
   1
   0
   0

入力引数

H — 入力変数または式

グラフィックス オブジェクト配列

グラフィックス オブジェクト ハンドルを評価する入力変数または式。

type — オブジェクト タイプ

文字ベクトル | string スカラー

オブジェクトのタイプ。文字ベクトルまたは string スカラーとして指定します。オブジェクトのタイプはその Type プロパティの値です。

出力引数

tf — 結果

logical 配列

結果。logical 配列として返されます。値 1 は入力配列の有効な要素を示し、値 0 は無効な要素を示します。入力配列が空の場合、結果は空の配列となります。

バージョン履歴

R2014b で導入

R2024b: 多次元配列を入力として渡すと、同じサイズの出力が返される

3 次元以上の配列を入力として渡すと、同じサイズの配列が返されます。以前は、入力が 3 次元以上の場合、isgraphics では 2 次元配列が返されていました。2 次元より高い次元は、2 次元に縮小されていました。たとえば、入力が 2×4×5 の配列の場合、出力は 2 行 20 列の配列になっていました。

スカラー、1 次元、または 2 次元の配列をいずれかの関数に渡すと、出力は以前のリリースと同じサイズになります。

all または any 関数への入れ子になった呼び出しを使用する場合は、出力の形状を維持するために、入れ子関数呼び出しの代わりに "all" 引数を使用するようにコードを更新します。

たとえば、次のコードの場合、R2024a ではスカラー logical 値が返されます。R2024b では、logical 値の 1×1×4 の配列が返されます。

h = gobjects(2,3,4);
all(all(isgraphics(h)))

スカラー出力を保持するには、"all" 引数を指定して all 関数を 1 回呼び出します。結果はスカラー logical 値です。

h = gobjects(2,3,4);
all(isgraphics(h),"all")

参考

関数

• ishghandle | isa

トピック

• グラフィックス オブジェクト ハンドル