Core Graphics > CGWindowListCreateDescriptionFromArray(_:)
関数
CGWindowListCreateDescriptionFromArray(_:)
指定されたウィンドウ ID を持つウィンドウに関する情報を生成して返します。
宣言
パラメータ
| windowArray | CGWindowID 型の配列。それぞれが情報を取得したいウィンドウに対応します。 |
戻り値
現在のユーザーセッション内のウィンドウの 1 つに関する情報を含む CFDictionary 型の配列。目的の基準に一致するウィンドウがない場合、関数は空の配列を返します。GUI セキュリティセッションの外からこの関数を呼び出す場合、またはウィンドウサーバーが実行していない場合、この関数は NULL を返します。
議論
この関数は、存在しなくなったウィンドウを参照する windowArray パラメータ内のウィンドウ ID をすべて無視します。(これは、ID を取得してからこの関数を呼び出すまでの間にウィンドウをユーザーが閉じると発生する可能性があります。) したがって、返された辞書の配列には、このパラメータと同じ数のエントリが含まれていると仮定しないでください。ただし、ウィンドウ ID を正しい情報に関連付けるのを容易にするために、各辞書には対応するウィンドウ ID の値を持つ kCGWindowNumber キーが含まれています。辞書に存在する可能性のあるキー値のリストについては、 Required Window List Keys (必要なウィンドウリストキー) と Optional Window List Keys (オプションのウィンドウリストキー) を参照してください。