Core Graphics > CGWindowListCreateImage(_:_:_:_:)
関数
CGWindowListCreateImage(_:_:_:_:)
動的に生成されたウィンドウのリストに基づいて合成イメージを返します。
宣言
パラメータ
| screenBounds | キャプチャしたい長方形。 長方形の座標は、スクリーンの原点がメインディスプレイの左上隅にあり、y 軸値が下に向かって増加するスクリーン座標で指定しなければなりません。指定されたウィンドウを囲む最小の長方形を示すには、null を指定します。デスクトップ領域全体をキャプチャするには、infinite を指定します。 |
| windowOption | イメージに含めるウィンドウを説明するオプション。一般的なオプションでは、windowID パラメータで指定されたウィンドウの上または下のウインドウまたはすべてのウィンドウを選択できます。詳細については、Window List Option Constants (ウィンドウリストのオプション定数) を参照してください。 |
| windowID | イメージに他のどのウィンドウを含めるべきかを決定するときに参照ポイントとして使用するウィンドウ ID。参照ウィンドウを必要としないオプションの場合、このパラメーターは kCGNullWindowID です。 |
| imageOption | ウィンドウのどの部分をキャプチャすべきかを決定するオプション。screenBounds パラメータに null を指定した場合、これらのオプションはイメージに使用される結果の境界ボックスに影響します。たとえば、ウィンドウのスクリーン効果をイメージに含めると、その効果を受け入れるために境界ボックスを少し大きくする必要があります。可能なオプションのリストについては、Window Image Types (ウィンドウイメージ型) を参照してください。 |
戻り値
指定されたウィンドウセットの内容から形成される合成イメージ。ウィンドウが読めなくなったり、指定された条件を満たすウィンドウがない場合、この関数は、サイズが 0×0 ピクセルであるか、または指定されたサイズで透明な黒色で塗りつぶされたイメージを返します。GUI セキュリティセッションの外からこの関数を呼び出す場合、またはウィンドウサーバーが実行していない場合、この関数は NULL を返します。
議論
オンスクリーンに表示されている、共有設定が none に設定されている全てのウィンドウはスキップされ、結果のイメージには含まれません。この結果で、選択した範囲でウィンドウが使用できない場合、この関数は NULL を返します。