Core Graphics > CGWindowListCopyWindowInfo(_:_:)
関数
CGWindowListCopyWindowInfo(_:_:)
現在のユーザーセッションで選択されたウィンドウに関する情報を生成して返します。
宣言
パラメータ
| option | どのウィンドウ辞書が返されるかを記述するオプション。典型的なオプションでは、 relativeToWindow パラメータで指定されたウィンドウの上または下のウィンドウまたは全てのウィンドウの辞書を返すことができます。詳細については、Window List Option Constants を参照してください。 |
| relativeToWindow | 他のどのウィンドウ辞書を返すかを判断するときに、参照ポイントとして使用するウィンドウの ID。参照ウィンドウを必要としないオプションの場合、このパラメーターは kCGNullWindowID です。 |
戻り値
現在のユーザーセッションのウィンドウの 1 つに関する情報を含む CFDictionary 型の配列。目的の基準に一致するウィンドウがない場合、関数は空の配列を返します。GUI セキュリティセッションの外からこの関数を呼び出す場合、またはウィンドウサーバーが実行されていない場合、この関数は NULL を返します。
議論
この関数を使用して、現在のユーザーセッション内の 1 つ以上のウィンドウの構成に関する詳細情報を取得できます。たとえば、この関数を使用すると、ウィンドウの境界、そのウィンドウの ID、およびウィンドウサーバーによってどのように管理されているかに関する情報を取得できます。辞書に存在する可能性のあるキー値のリストについては、Required Window List Keys と Optional Window List Keys を参照してください。
システムウィンドウ用の辞書を生成することは、比較的高価な操作です。いつものように、あなたのコードをプロファイルし、必要に応じてこの関数の使い方を適切に調整する必要があります。