com_event_sink

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

com_event_sink — Conecta eventos de um objeto COM a um objeto PHP

Descrição

com_event_sink(variant $variant, object $sink_object, array|string|null $sink_interface = null): bool

Instrui o COM a coletar eventos gerados por variant no objeto PHP sink_object.

Deve-se ter cuidado ao usar este recurso; se algo semelhante ao exemplo abaixo estiver sendo feito, não faz sentido executar em um contexto de servidor web.

Parâmetros

variant
sink_object: sink_object deve ser uma instância de uma classe com métodos nomeados de acordo com aqueles da dispinterface desejada; pode-se usar com_print_typeinfo() para ajudar a gerar uma classe de modelo para esse propósito.
sink_interface: O PHP tentará usar o tipo de dispinterface padrão especificado pela biblioteca de tipos associada com variant, mas pode-se substituir esta escolha definindo sink_interface como o nome da dispinterface que será usada.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Registro de Alterações

Versão	Descrição
8.0.0	`sink_interface` agora pode ser nulo.

Exemplos

Exemplo #1 Exemplo de com_event_sink

<?php
class 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");
while(!$sink->terminated) {
  com_message_pump(4000);
}
$ie = null;
?>

Notas

Cuidado

Antes do PHP 8.0.0, chamar exit() de qualquer um dos manipuladores de eventos não era suportado e poderia fazer com que o PHP travasse. Isso poderia ser contornado lançando uma exceção a partir do manipulador de eventos, capturando a exceção no código principal e chamando exit() a partir daí.

Veja Também

com_print_typeinfo() - Mostra uma definição de classe PHP para uma interface despachável
com_message_pump() - Processa mensagens COM, aguardando por um tempo limite

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicione uma nota

Notas Enviadas por Usuários (em inglês) 2 notes

down

veggie ¶

7 years ago

I got voice recognition working. I'm not sure why the way I called the sink function made it work but I'm more about results right now. This small example had me rolling on the floor laughing.

<?php
/* 
 * Search this for more info on the voice stuff:
 * Automation Interfaces and Objects (SAPI 5.4)
 */

//directions: 
//php friend.php
//then fire up windows voice recognition and turn it on and say stuff

$voice = new COM("SAPI.SpVoice");

print "Hit control+c to end.\n";
print "Friend: Hello friend!\n";

$voice->Speak("Hello friend!");

class listen
{
    
    function Recognition($StreamNumber, $StreamPosition, $RecognitionType, $ISpeechRecoResult)
    {
        
        $phrase = $ISpeechRecoResult->PhraseInfo;
        $text = $phrase->GetText();
        
        print "\nYou:$text\n";
     
        
        global $voice;
        $say = array('oh', 'nice', 'humm', 'interesting', 'you dont say', 'uh huh', 'right', 'what', 'ha ha', 'you have got to be joking', 'right back at you buddy');
        $idx = rand(0, count($say)-1);
        
        print "Friend: " . $say[$idx] . "\n";
        $voice->Speak($say[$idx]);
        
    }
    
}

$recog = new COM("SAPI.SpSharedRecognizer");

$context = $recog->CreateRecoContext();

//SRERecognition = 16 (default)
//SREAllEvents = 393215
//$context->EventInterests = 393215;

//try to listen to events on context
$listen = new listen(); //event handler
if (!com_event_sink($context, $listen, "RecognizerStateChange"))
{
    print "Unable to sink events\n";
    exit;
}

$grammar = $context->CreateGrammar();

$i = $grammar->DictationLoad();

$s = $grammar->DictationSetState(1); //1=on, 0=off

while(true)
{
    
    if(!com_message_pump(1000))
    {
        print ".";
    }
    
}

?>

down

fjortiz ¶

19 years ago

In case someone needs a skeleton sink for ADODB.Connection events:

class ADOConnectionEventSink    {

    function BeginTransComplete( $translevel, $objerror, $status, $objconn )    {
        return 0;
    }

    function CommitTransComplete( $objerror, $status, $objconn )    {
        return 0;
    }

    function RolbackTransComplete( $objerror, $status, $objconn )    {
        return 0;
    }

    function WillConnect ( $ConnectionString, $userid, $psword, $options, $status, $objconn )    {
        return 0;
    }

    function ConnectComplete ( $objerror, $status, $objconn)    {
        return 0;
    }

    function Disconnect( $status, $objConn )    {
        return 0;
    }

    function WillExecute ( $src, $cursortyp, $locktyp, $options, $status, $objcomm, $objrs, $objconn )    {
        return 0;
    }

    function ExecuteComplete ( $recaffected, $objerror, $status, $objcomm, $objrs, $objconn )    {
        return 0;
    }

    function InfoMessage ( $objerror, $status, $objconn)    {
        return 0;
    }
}

// later on...
$db = new COM("ADODB.Connection", NULL, $charPage);
$sink = new ADOConnectionEventSink();
com_event_sink($db, $sink, "ConnectionEvents");
//...

＋adicione uma nota