Core Graphics > CGEvent > tapCreateForPSN(processSerialNumber:place:options:eventsOfInterest:callback:userInfo:)
型メソッド
tapCreateForPSN(processSerialNumber:place:options:
eventsOfInterest:callback:userInfo:)
指定したプロセスのイベントタップを作成します。
宣言
パラメータ
| processSerialNumber | 監視すべきプロセス。 |
| place | アクティブなイベントタップのリスト内の新しいイベントタップの位置。 CGEventTapPlacement にリストされている定数の 1 つを渡します。 |
| options | 新しいイベントタップが受動的リスナーかアクティブフィルタであるかを指定する定数。 |
| eventsOfInterest | 観察されるべきイベントのセットを指定するビットマスク。可能なイベントのリストについては、CGEventType を参照してください。マスクの指定方法については、CGEventMask を参照してください。イベントタップが eventsOfInterest パラメータで指定された 1 つ以上のイベントを監視することを許可されていない場合、マスク内の適切なビットはクリアされます。そのアクションの結果、マスクが空の場合、この関数は NULL を返します。 |
| callback | あなたが提供するイベントタップ呼び出し関数。呼び出し関数は、イベントタップがソースとして追加された実行ループから呼び出されます。呼び出し関数のスレッド安全性は、実行ループの環境によって定義されます。イベントタップ呼び出し関数の詳細については、CGEventTapCallBack を参照してください。 |
| refcon | ユーザー定義データへのポインタ。このポインタは、callback パラメータで指定された呼び出し関数に渡されます。 |
戻り値
新しいイベントタップを表す Core Foundation マザーポート、またはイベントタップを作成できなかった場合は NULL。イベントタップの使用が終了したら、CFRelease 関数を使用して Mach ポートを解放する必要があります。Mach ポートを解放するとタップも解除されます。
議論
この関数は、ウィンドウサーバーによって指定されたプロセスにルーティングされるイベントを受け取るイベントタップを作成します。イベントタップの作成の詳細については、 tapCreate(tap:place:options:eventsOfInterest:callback:userInfo:) を参照して下さい。