Php/docs/function.com-event-sink
com_event_sink
(PHP 4 >= 4.2.0, PHP 5, PHP 7)
com_event_sink — Connect events from a COM object to a PHP object
说明
com_event_sink
( variant $variant
, object $sink_object
[, array|string|null $sink_interface
= null
] ) : bool
Instructs COM to sink events generated by
variant
into the PHP object
sink_object
.
Be careful how you use this feature; if you are doing something similar to the example below, then it doesn't really make sense to run it in a web server context.
参数
variant
sink_object
sink_object
should be an instance of a class with methods named after those of the desired dispinterface; you may use com_print_typeinfo() to help generate a template class for this purpose.sink_interface
- PHP will attempt to use the default dispinterface type specified by the typelibrary associated with
variant
, but you may override this choice by settingsink_interface
to the name of the dispinterface that you want to use.
返回值
成功时返回 true
, 或者在失败时返回 false
。
更新日志
版本 | 说明 |
---|---|
8.0.0 | sink_interface is nullable now.
|
范例
Example #1 COM event sink example
<?phpclass IEEventSinker { var $terminated = false; function ProgressChange($progress, $progressmax) { echo "Download progress: $progress / $progressmax\n"; } function DocumentComplete(&$dom, $url) { echo "Document $url complete\n"; } function OnQuit() { echo "Quit!\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%22);while(!$sink->terminated) { com_message_pump(4000);}$ie = null;?>
注释
参见
- com_print_typeinfo() - Print out a PHP class definition for a dispatchable interface
- com_message_pump() - Process COM messages, sleeping for up to timeoutms milliseconds