array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'function.com-event-sink.php', 1 => 'com_event_sink', ), 'up' => array ( 0 => 'ref.com.php', 1 => 'COM関数', ), 'prev' => array ( 0 => 'function.com-create-guid.php', 1 => 'com_create_guid', ), 'next' => array ( 0 => 'function.com-get-active-object.php', 1 => 'com_get_active_object', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/com/functions/com-event-sink.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
com_event_sink — COM オブジェクトのイベントを PHP オブジェクトに接続する
$variant
, object $sink_object
, array|string|null $sink_interface
= null
): bool
variant
が生成したイベントを PHP オブジェクト
sink_object
に通知するよう、COM に指示します。
この機能を利用する際には注意しましょう。もし以下の例のようなことを 行いたいのであれば、Web サーバー上でそれを行うことには まったく意味がありません。
variant
sink_object
sink_object
には、要求されるディスパッチ
インターフェイスと同じ名前のメソッドを持つクラスのインスタンスを
指定する必要があります。この要求を満たすクラスを作成するために、
com_print_typeinfo() を使用することができます。
sink_interface
PHP は variant
に関連するタイプライブラリで
指定されたデフォルトのディスパッチインターフェイスを使用しようと
しますが、使用させたいインターフェイス名を
sink_interface
に指定することで、それを
上書きすることが可能です。
バージョン | 説明 |
---|---|
8.0.0 |
sink_interface は、nullable になりました。
|
例1 COM イベントシンクの例
<?php
class IEEventSinker {
var $terminated = false;
function ProgressChange($progress, $progressmax) {
echo "ダウンロードの進行状況: $progress / $progressmax\n";
}
function DocumentComplete(&$dom, $url) {
echo "ドキュメント $url 完了\n";
}
function OnQuit() {
echo "終了!\n";
$this->terminated = true;
}
}
$ie = new COM("InternetExplorer.Application");
$sink = new IEEventSinker();
com_event_sink($ie, $sink, "DWebBrowserEvents2");
$ie->Visible = true;
$ie->Navigate("http://www.example.org");
while(!$sink->terminated) {
com_message_pump(4000);
}
$ie = null;
?>