Ruby 1.9.2 リファレンスマニュアル > ライブラリ一覧 > win32oleライブラリ > WIN32OLE_EVENTクラス

class WIN32OLE_EVENT

クラスの継承リスト: WIN32OLE_EVENT < Object < Kernel < BasicObject

要約

OLEオートメーションサーバからのイベント通知を制御するクラスです。

OLEオートメーションサーバによっては、サーバの処理の過程でクライアントがあらかじめ登録したメソッドを呼び出すものがあります。このサーバが登録したメソッドを呼び出す動作を「イベント」と呼びます。 WIN32OLE_EVENTを利用すると、ブロックの形式でイベントを受け取るメソッドをサーバへ登録できます。

サンプルコード

ie = WIN32OLE.new('InternetExplorer.Application.1')
event = WIN32OLE_EVENT.new(ie, 'DWebBrowserEvents2')
b = false
event.on_event('DocumentComplete') do |disp, uri|
  disp.document.getElementsByTagName('a').each do |e|
    puts "#{e.innerHTML}=#{e.href}"   #=> ダウンロード=http://www.ruby-lang.org/ja/downloads/ など
  end
  disp.quit
  b = true
end
ie.Navigate2 'http://www.ruby-lang.org/ja/'
loop do
  break if b
  WIN32OLE_EVENT.message_loop
end

特異メソッド

定義	説明
`message_loop -> ()`	Windowsのメッセージポンプを実行します。
`new(ole, event = nil) -> WIN32OLE_EVENT`	OLEオートメーションサーバのイベント受信機構をオブジェクト化して返します。

インスタンスメソッド

定義	説明
`handler -> object`	WIN32OLE_EVENT#handler=メソッドで登録したイベントハンドラオブジェクトを返します。
`handler=(obj) -> ()`	イベント処理を実行するオブジェクトを登録します。
`off_event(event = nil) -> ()`	WIN32OLE_EVENT#on_eventで登録したブロックを解除します。
`on_event(event = nil) {\|*args\| ... } -> ()`	イベント通知を受けるブロックを登録します。
`on_event_with_outargs(event = nil) {\|*args\| ... } -> ()`	イベント通知を受けて結果を呼び出し元へ返すブロックを登録します。
`unadvise -> ()`	イベント通知元をオブジェクトから切断します。

継承したメソッド

! != == === =~ __id__ __send__ _dump class clone dclone display enum_for eql? equal? extend freeze frozen? hash initialize initialize_copy inspect instance_eval instance_exec instance_of? instance_variable_defined? instance_variable_get instance_variable_set instance_variables is_a? marshal_dump marshal_load method method_missing methods must_be must_be_close_to must_be_empty must_be_instance_of must_be_kind_of must_be_nil must_be_same_as must_be_within_epsilon must_equal must_include must_match must_raise must_respond_to must_send must_throw nil? pretty_inspect pretty_print pretty_print_cycle pretty_print_inspect pretty_print_instance_variables private_methods protected_methods public_methods remove_instance_variable respond_to? respond_to_missing? singleton_class singleton_method_added singleton_method_removed singleton_method_undefined singleton_methods taint tainted? tap to_a to_ary to_hash to_int to_io to_proc to_regexp to_s to_str to_yaml to_yaml_properties to_yaml_style trust untaint untrust untrusted? wont_be wont_be_close_to wont_be_empty wont_be_instance_of wont_be_kind_of wont_be_nil wont_be_same_as wont_be_within_epsilon wont_equal wont_include wont_match wont_respond_to