検索結果

WIN32OLE (114163.0)

• 2.3.0

• クラス

OLEオートメーションサーバをRubyで操作するためのクラスです。

OLEオートメーションサーバをRubyで操作するためのクラスです。

Windowsの多くのアプリケーションやライブラリは、COMと呼ばれるAPI群を利用
して他のプログラムから操作できます。WIN32OLEがサポートしているのは、
COMのAPIのうち、特にインタープリタ用のインターフェイスであるOLEオートメー
ション（IDispatchインターフェイス）とそれに付随するリフレクション用のイ
ンターフェイスです。

これらのインターフェイスをサポートしている代表的なWindowsアプリケーショ
ンに、Office、IE、iTunes、Illustratorがあります。また、WMI、WshS...

WIN32OLE#ole_func_methods -> [WIN32OLE_METHOD] (63460.0)

• 2.3.0

• インスタンスメソッド

オブジェクトのファンクション情報をWIN32OLE_METHODの配列として返し ます。

オブジェクトのファンクション情報をWIN32OLE_METHODの配列として返し
ます。

ole_func_methodsメソッドは、OLEオートメーションサーバのメソッドのうちファ
ンクション（何らかの機能的な操作）に属するものをWIN32OLE_METHODの
配列として返します。

@return WIN32OLE_METHODの配列。
@raise WIN32OLERuntimeError オートメーションサーバの呼び出しに失敗しました。
型情報ライブラリ(TypeLib)が提供されていない場合などに発生します。

exc...

• WIN32OLE
• WIN32OLE_METHOD

WIN32OLE#ole_get_methods -> [WIN32OLE_METHOD] (63460.0)

• 2.3.0

• インスタンスメソッド

オブジェクトの参照可能プロパティ情報をWIN32OLE_METHODの配列として 返します。

オブジェクトの参照可能プロパティ情報をWIN32OLE_METHODの配列として
返します。

ole_get_methodsメソッドは、OLEオートメーションサーバのメソッドのうち読
み取り可能なプロパティをWIN32OLE_METHODの配列として返します。

@return WIN32OLE_METHODの配列。
@raise WIN32OLERuntimeError オートメーションサーバの呼び出しに失敗しました。
型情報ライブラリ(TypeLib)が提供されていない場合などに発生します。

excel = WIN32OLE...

• WIN32OLE
• WIN32OLE_METHOD

WIN32OLE#ole_put_methods -> [WIN32OLE_METHOD] (63460.0)

• 2.3.0

• インスタンスメソッド

オブジェクトの設定可能プロパティ情報をWIN32OLE_METHODの配列として 返します。

オブジェクトの設定可能プロパティ情報をWIN32OLE_METHODの配列として
返します。

ole_put_methodsメソッドは、OLEオートメーションサーバのメソッドのうちプ
ロパティ設定メソッドに属するものをWIN32OLE_METHODの配列として返し
ます。

@return WIN32OLE_METHODの配列。
@raise WIN32OLERuntimeError オートメーションサーバの呼び出しに失敗しました。
型情報ライブラリ(TypeLib)が提供されていない場合などに発生します。

excel = W...

• WIN32OLE
• WIN32OLE_METHOD

WIN32OLE.const_load(ole, mod = WIN32OLE) -> () (63448.0)

• 2.3.0

• 特異メソッド

OLEオートメーションサーバが保持する定数を読み込み、指定されたモジュール に組み込みます。

OLEオートメーションサーバが保持する定数を読み込み、指定されたモジュール
に組み込みます。

OLEオートメーションサーバは、定数をクライアントへ提供できます。

const_loadメソッドはこれらの定数を読み込み、指定したモジュールに組み込
むことで参照可能とします。

@param ole 定数を読み込む対象のWIN32OLEオブジェクトまたはタイプライブラ
リ名（文字列）を指定します。

@param mod 定数を定義する対象のモジュールを指定します。省略時は
WIN32OLEに組み込まれます。

@raise WIN32OLERunt...

• WIN32OLE

絞り込み条件を変える

WIN32OLE#ole_obj_help -> WIN32OLE_TYPE | nil (63445.0)

• 2.3.0

• インスタンスメソッド

WIN32OLE_TYPEオブジェクトを返します。

WIN32OLE_TYPEオブジェクトを返します。

WIN32OLE_TYPEオブジェクトは、WIN32OLEオブジェクトの文書情報と型情
報を保持するオブジェクトです。

@return オブジェクトに関連するWIN32OLE_TYPEオブジェクトを返します。
オブジェクトがドキュメント情報を持たない場合はnilを返します。

excel = WIN32OLE.new('Excel.Application')
tobj = excel.ole_obj_help

@see WIN32OLE_TYPE

• WIN32OLE
• WIN32OLE_TYPE

WIN32OLE#ole_type -> WIN32OLE_TYPE | nil (63445.0)

• 2.3.0

• インスタンスメソッド

WIN32OLE_TYPEオブジェクトを返します。

WIN32OLE_TYPEオブジェクトを返します。

WIN32OLE_TYPEオブジェクトは、WIN32OLEオブジェクトの文書情報と型情
報を保持するオブジェクトです。

@return オブジェクトに関連するWIN32OLE_TYPEオブジェクトを返します。
オブジェクトがドキュメント情報を持たない場合はnilを返します。

excel = WIN32OLE.new('Excel.Application')
tobj = excel.ole_obj_help

@see WIN32OLE_TYPE

• WIN32OLE
• WIN32OLE_TYPE

WIN32OLE#ole_methods -> [WIN32OLE_METHOD] (63442.0)

• 2.3.0

• インスタンスメソッド

オブジェクトのメソッド情報をWIN32OLE_METHODの配列として返します。

オブジェクトのメソッド情報をWIN32OLE_METHODの配列として返します。

ole_methodsメソッドは、OLEオートメーションサーバが提供するすべてのメソッ
ドをWIN32OLE_METHODの配列として返します。

@return WIN32OLE_METHODの配列。
@raise WIN32OLERuntimeError オートメーションサーバの呼び出しに失敗しました。
型情報ライブラリ(TypeLib)が提供されていない場合などに発生します。

excel = WIN32OLE.new('Excel.Appli...

• WIN32OLE
• WIN32OLE_METHOD

WIN32OLE.new(server, host=nil) -> WIN32OLE (63430.0)

• 2.3.0

• 特異メソッド

OLEオートメーションサーバを生成します。

OLEオートメーションサーバを生成します。

引数で指定したCLSIDまたはPROGIDを持つOLEオートメーションサーバを生成し
ます。生成に成功した場合、該当サーバを操作可能なWIN32OLEオブジェクトが
返ります。

CLSIDおよびPROGIDについてはWIN32OLE.connectを参照してください。

@param server OLEオートメーションサーバを示すPROGIDまたはCLSIDを文字列
で指定します。

@param host サーバを生成するホストのホスト名またはIPアドレスを文字列で
指定します。省略時は現在...

• WIN32OLE

WIN32OLE#ole_typelib -> WIN32OLE_TYPELIB (63424.0)

• 2.3.0

• インスタンスメソッド

オブジェクトに対応する型情報ライブラリ（TypeLib）を WIN32OLE_TYPELIBとして返します。

オブジェクトに対応する型情報ライブラリ（TypeLib）を
WIN32OLE_TYPELIBとして返します。

OLEオートメーションではクラス、インターフェイス、メソッド、引数などの型
情報と文書情報を型情報ライブラリとして利用します。型情報ライブラリは独
立したファイル（拡張子tlb）の場合もあれば、オブジェクトのバイナリへリソー
スとして埋め込まれている場合があります。

OLEオートメーションでは型情報ライブラリの提供方法を問わずに統一したイン
ターフェイスでアプリケーションが参照できるように、オブジェクトの形式
（ITypeInfoインターフェイス）で提供します。WIN32OLEは...

• WIN32OLE
• WIN32OLE_TYPELIB

絞り込み条件を変える

WIN32OLE#ole_query_interface(iid) -> WIN32OLE (63412.0)

• 2.3.0

• インスタンスメソッド

IID（インターフェイスID）を指定してオブジェクトの別のインターフェイスを 持つオブジェクトを取得します。

IID（インターフェイスID）を指定してオブジェクトの別のインターフェイスを
持つオブジェクトを取得します。

オブジェクトが複数のオートメーション用インターフェイスを持つ場合に、当
メソッドを利用して既定のインターフェイスとは異なるインターフェイスを取
得します。

@param iid 取得するインターフェイスのIIDを文字列で指定します。
@return iidパラメータで指定したインターフェイスを持つWIN32OLEオブジェクト
@raise WIN32OLERuntimeError 指定したIIDをオブジェクトが持たない場合に通知されます。

ie = WIN32OLE.n...

• WIN32OLE

WIN32OLE#ole_method(method) -> WIN32OLE_METHOD (63391.0)

• 2.3.0

• インスタンスメソッド

メソッド名を指定して対応するWIN32OLE_METHODオブジェクトを取得しま す。

メソッド名を指定して対応するWIN32OLE_METHODオブジェクトを取得しま
す。

OLEオートメーションの仕様により、メソッド名の大文字、小文字は区別されま
せん。

@param method メソッド情報を取り出す対象のメソッド名を文字列で指定します。
@return WIN32OLE_METHODオブジェクト。
@raise WIN32OLERuntimeError 指定したメソッド名が未定義あるいは型情報ラ
イブラリ(TypeLib)が提供されていない場合など
に発...

• WIN32OLE
• WIN32OLE_METHOD

WIN32OLE#ole_method_help(method) -> WIN32OLE_METHOD (63391.0)

• 2.3.0

• インスタンスメソッド

メソッド名を指定して対応するWIN32OLE_METHODオブジェクトを取得しま す。

メソッド名を指定して対応するWIN32OLE_METHODオブジェクトを取得しま
す。

OLEオートメーションの仕様により、メソッド名の大文字、小文字は区別されま
せん。

@param method メソッド情報を取り出す対象のメソッド名を文字列で指定します。
@return WIN32OLE_METHODオブジェクト。
@raise WIN32OLERuntimeError 指定したメソッド名が未定義あるいは型情報ラ
イブラリ(TypeLib)が提供されていない場合など
に発...

• WIN32OLE
• WIN32OLE_METHOD

WIN32OLE.connect(ole) -> WIN32OLE (63376.0)

• 2.3.0

• 特異メソッド

現在実行中のOLEオートメーションサーバに接続します。

現在実行中のOLEオートメーションサーバに接続します。

connectメソッドは、COMのモニカを利用して、現在実行中のOLEオートメーショ
ンサーバを検索し、接続します。接続に成功した場合、該当サーバを操作可能
なWIN32OLEオブジェクトが返ります。

@param ole 接続対象のサーバを示すPROGID、CLSIDまたはモニカ（別名）を指定します。

@return ole引数で特定されるWIN32OLEオブジェクトを返します。
@raise WIN32OLERuntimeError オートメーションサーバの呼び出しに失敗しました。
...

• WIN32OLE

WIN32OLE.ole_free(aWIN32OLE) -> Integer (63373.0)

• 2.3.0

• 特異メソッド

引数で指定したオブジェクトを解放します。

引数で指定したオブジェクトを解放します。

このメソッドは主にWIN32OLEのデバッグおよびWIN32OLEを利用するミドルウェ
アの実装のために用意されています。このため、メソッドの内部動作は不定で
す。COMの仕様とWIN32OLEの内部処理に熟知していない場合は使用しないでくだ
さい。

@param aWIN32OLE 解放するWIN32OLEオブジェクト。

@return Releaseの戻り値。COMの仕様上は現在のオブジェクトの参照カウント
値を示します。

• WIN32OLE

絞り込み条件を変える

WIN32OLE.ole_reference_count(aWIN32OLE) -> Integer (63373.0)

• 2.3.0

• 特異メソッド

引数で指定したオブジェクトの現在の参照カウント値を返します。

引数で指定したオブジェクトの現在の参照カウント値を返します。

このメソッドは主にWIN32OLEのデバッグおよびWIN32OLEを利用するミドルウェ
アの実装のために用意されています。このため、メソッドの内部動作は不定で
す。COMの仕様とWIN32OLEの内部処理に熟知していない場合は使用しないでくだ
さい。

@param aWIN32OLE 参照カウント値を求めるWIN32OLEオブジェクト。

@return AddRef呼び出し後のReleaseの戻り値。COMの仕様上は現在のオブジェ
クトの参照カウント値を示します。

• WIN32OLE

WIN32OLE.codepage=(cp) -> nil (63157.0)

• 2.3.0

• 特異メソッド

WIN32OLEがOLEオートメーションのインターフェイスに利用するコードページを 設定します。

WIN32OLEがOLEオートメーションのインターフェイスに利用するコードページを
設定します。

WIN32OLEは、OLEオートメーション呼び出しに利用する文字列のUnicode変換に
ここで設定したコードページを利用します。通常、WIN32OLEはロード時の
Encoding.default_internalまたはEncoding.default_externalから適切なコー
ドページを判断し、それを利用します。したがって、当メソッドを呼び出す必
要があるのは、WIN32OLEをrequireしたスクリプトと異なるエンコーディングを
利用しているスクリプトや、異なるエンコーディングを...

• WIN32OLE

WIN32OLE.ole_show_help(obj, helpcontext = nil) -> () (63157.0)

• 2.3.0

• 特異メソッド

WIN32OLEオブジェクトのヘルプファイルを表示します。

WIN32OLEオブジェクトのヘルプファイルを表示します。

Windows標準のヘルプ表示コンポーネントのHHCtrl.OCXを利用して、オブジェク
トに関連付けられたヘルプファイル（chmファイル）を表示します。

また、chmファイルのフルパス名を指定して表示させることも可能です。

@param obj WIN32OLE_TYPEオブジェクトまたはWIN32OLE_METHODオ
ブジェクト。直接ヘルプファイルのフルパス名を指定することも可
能です。

@param helpcontext obj引数にWIN32OLE_TYPEオブジェクト...

• WIN32OLE
• WIN32OLE_METHOD
• WIN32OLE_TYPE

WIN32OLE#_invoke(dispid, args, types) -> object | nil (63145.0)

• 2.3.0

• インスタンスメソッド

DISPIDとパラメータの型を指定してオブジェクトのメソッドを呼び出します。

DISPIDとパラメータの型を指定してオブジェクトのメソッドを呼び出します。

呼び出すメソッドのインターフェイスを事前に知っている場合に、DISPIDとパ
ラメータの型を指定してメソッドを呼び出します。

このメソッドは引数の変換方法をプログラマが制御できるようにすることと、
COMアーリーバインディングを利用して外部プロセスサーバとのラウンドトリッ
プを減らして処理速度を向上させることを目的としたものです。後者の目的に
ついては、DLLの形式で型情報（TypeLib）を提供しているサーバに対してはあ
まり意味を持ちません。そのため、型の高精度な制御が不要な場合は、直接メ
ソッド名を指定した...

• WIN32OLE
• WIN32OLE::VARIANT

WIN32OLE#method_missing(id, *args) -> object | nil (63121.0)

• 2.3.0

• インスタンスメソッド

WIN32OLE#invokeメソッドを実行します。

WIN32OLE#invokeメソッドを実行します。

WIN32OLEのインスタンスに対して、このリファレンスに明記されていないメソッ
ドを呼び出した場合、OLEオートメーションサーバのメソッド（プロパティ）呼
び出しと解釈します。

@param id メソッド名をシンボルで指定します。
@param args メソッドの引数を指定します。
@return メソッドの返り値。ただし返り値を持たないメソッドの場合はnil。
@raise RuntimeError idが有効なシンボルではありません。
@raise WIN32OLERuntimeError オートメーションサーバの呼び出しに失...

• WIN32OLE

絞り込み条件を変える

WIN32OLE.codepage -> Integer (63121.0)

• 2.3.0

• 特異メソッド

WIN32OLEがOLEオートメーションのインターフェイスに利用するコードページを 取得します。

WIN32OLEがOLEオートメーションのインターフェイスに利用するコードページを
取得します。

OLEオートメーションに利用する文字列はUnicodeでエンコードします。
WIN32OLEはここで示されたコードページを利用してRubyのStringとUnicodeの相
互変換を行います。

ロード時の既定値はEncoding.default_internal、または
Encoding.default_internalがnilの場合はEncoding.default_externalによって
求めたエンコーディングに対応するコードページです。もし、該当するコード
ページが見つからない場合は...

• WIN32OLE

WIN32OLE.locale -> Integer (63103.0)

• 2.3.0

• 特異メソッド

WIN32OLEがオートメーション呼び出し時に設定するロケール識別子(LCID)を取 得します。

WIN32OLEがオートメーション呼び出し時に設定するロケール識別子(LCID)を取
得します。

OLEオートメーションでは、UNIXで利用される"ja_JP"などの国名と言語名を「_」
で接続した文字列ではなく、32ビット整数で示します。32ビットの内訳は上位
16ビットが予約領域で0、下位16ビットが言語ID(LANGID）です。LANGIDは、0〜
9ビットでプライマリ言語ID、10〜15ビットでサブ言語IDを示します。

ロード時の既定値はWIN32OLE::LOCALE_SYSTEM_DEFAULTです。

@return WIN32OLEがオートメーション呼び出し時に設定するロ...

• WIN32OLE

WIN32OLE.locale=(lcid) -> nil (63103.0)

• 2.3.0

• 特異メソッド

WIN32OLEがオートメーション呼び出し時に設定するロケール識別子(LCID)を設 定します。

WIN32OLEがオートメーション呼び出し時に設定するロケール識別子(LCID)を設
定します。

OLEオートメーションでは、UNIXで利用される"ja_JP"などの国名と言語名を「_」
で接続した文字列ではなく、32ビット整数で示します。32ビットの内訳は上位
16ビットが予約領域で0、下位16ビットが言語ID(LANGID）です。LANGIDは、0〜
9ビットでプライマリ言語ID、10〜15ビットでサブ言語IDを示します。

@param lcid 新たに設定するロケール識別子を整数で指定します。

@raise WIN32OLERuntimeError システムにインストールされてい...

• WIN32OLE

WIN32OLE#_getproperty(dispid, args, types) -> object (63091.0)

• 2.3.0

• インスタンスメソッド

DISPIDとパラメータの型を指定してオブジェクトのプロパティを参照します。

DISPIDとパラメータの型を指定してオブジェクトのプロパティを参照します。

アクセスするプロパティのインターフェイスを事前に知っている場合に、
DISPIDとパラメータの型を指定してプロパティを参照します。

@param dispid プロパティのDISPID（メソッドを一意に特定する数値）を指定
します。

@param args プロパティが引数を取る場合に配列で指定します。引数の順序は
最左端の引数のインデックスを0とします。引数が不要な場合は空
配列を指定します。

@param types プロパティが...

• WIN32OLE
• WIN32OLE::VARIANT

WIN32OLE#_setproperty(dispid, args, types) -> () (63091.0)

• 2.3.0

• インスタンスメソッド

DISPIDとパラメータの型を指定してオブジェクトのプロパティを設定します。

DISPIDとパラメータの型を指定してオブジェクトのプロパティを設定します。

アクセスするプロパティのインターフェイスを事前に知っている場合に、
DISPIDとパラメータの型を指定してプロパティを設定します。

このメソッドはCOMアーリーバインディングを利用することで外部プロセスサー
バとのラウンドトリップを減らして処理速度を向上させることを目的としたも
のです。このため、DLLの形式で型情報（TypeLib）を提供しているサーバに対
してはあまり意味を持ちません。

@param dispid プロパティのDISPID（メソッドを一意に特定する数値）を指定
し...

• WIN32OLE
• WIN32OLE::VARIANT

絞り込み条件を変える

WIN32OLE#ole_free -> () (63091.0)

• 2.3.0

• インスタンスメソッド

selfが参照するCOMオブジェクトを解放します。

selfが参照するCOMオブジェクトを解放します。

selfが参照するCOMオブジェクトのIUnknown::Releaseを呼び出すことで、COMオ
ブジェクトを開放します。ole_freeを呼び出した後は、このオブジェクトに対
する操作は行えません。

excel = WIN32OLE.new('Excel.Application')
excel.ole_free # オブジェクトの解放
excel.Quit #=> RuntimeError (failed to get Dispatch Interface)

通常は利用されなくなったWIN32OLEオブジェ...

• WIN32OLE

WIN32OLE::ARGV -> [object] (63073.0)

• 2.3.0

• 定数

直前のメソッド呼び出しの引数を格納した配列です。

直前のメソッド呼び出しの引数を格納した配列です。

OLEオートメーションでは呼び出し先が引数に対して値を設定できます。しかし、
Rubyのメソッド引数は値のみを取るため、そのままでは呼び出し先が設定した
値を参照できません。このような場合、ARGVを参照することで呼び出し先の設
定値を参照できます。

以下のリストは、VBで開発したオブジェクトのメソッド呼び出しを例としてい
ます。このメソッド（Accm）は、第1引数で指定した演算を第2引数と第3引数に
適用し、結果を第2引数に設定します。

' VB (OLE Automation server)
Public Sub Accm(...

• WIN32OLE

WIN32OLE::LOCALE_SYSTEM_DEFAULT -> Integer (63049.0)

• 2.3.0

• 定数

システム既定のロケールを示すLCID(0x0800)です。WIN32OLEがオートメーショ ンを利用する場合の既定値です。

システム既定のロケールを示すLCID(0x0800)です。WIN32OLEがオートメーショ
ンを利用する場合の既定値です。

• WIN32OLE

WIN32OLE::VERSION -> String (63049.0)

• 2.3.0

• 定数

Major.Minor.Patch形式のWIN32OLEのバージョン番号を示す文字列です。

Major.Minor.Patch形式のWIN32OLEのバージョン番号を示す文字列です。

• WIN32OLE

WIN32OLE#[](key...) -> object (63037.0)

• 2.3.0

• インスタンスメソッド

オブジェクトのデフォルトプロパティを参照します。

オブジェクトのデフォルトプロパティを参照します。

OLEオートメーションにはデフォルトプロパティというプロパティ名を指定せず
にアクセスできるプロパティがあります。

WIN32OLEからデフォルトプロパティにアクセスするには、[]内に必要なキーを
「,」で区切って記述します。シンボルは文字列として扱います。

なおデフォルトプロパティは記述が省略できるプロパティ名に意味がないため、
OLEオートメーション規約ではItemと命名することが決められています。

@param key プロパティでアクセスする情報を特定するキーを指定します。プロ
パティの特定に複数のキーが必...

• WIN32OLE

絞り込み条件を変える

WIN32OLE#[]=(key..., value) -> () (63037.0)

• 2.3.0

• インスタンスメソッド

オブジェクトのデフォルトプロパティを設定します。

オブジェクトのデフォルトプロパティを設定します。

OLEオートメーションにはデフォルトプロパティというプロパティ名を指定せず
にアクセスできるプロパティがあります。

WIN32OLEからデフォルトプロパティにアクセスするには、[]内に必要なキーを
記述します。

なおデフォルトプロパティは記述が省略できるプロパティ名には意味がありま
せん。このためOLEオートメーション規約では一律にItemと命名することが決め
られています。

@param key プロパティでアクセスする情報を特定するキーを指定します。プロ
パティの特定に複数のキーが必要な場合は「,」で区切って列...

• WIN32OLE

WIN32OLE#invoke(name, *args) -> object | nil (63037.0)

• 2.3.0

• インスタンスメソッド

メソッド名を指定してオブジェクトのメソッドを呼び出します。

メソッド名を指定してオブジェクトのメソッドを呼び出します。

OLEオートメーションサーバのメソッドを動的に呼び出したい場合に利用します。

なお、OLEオートメーションの仕様により、メソッド名の大文字、小文字は区別
されません。

@param name メソッド名を文字列またはシンボルで指定します。
@param args メソッドの引数を指定します。また、最後の引数にHashを
与えることで、名前付き引数を指定できます。この場合、キーに
文字列またはシンボルでパラメータ名、値に引数を指定します。
@return メソッドの返り値。ただし返り...

• Hash
• WIN32OLE

WIN32OLE.create_guid -> String (63037.0)

• 2.3.0

• 特異メソッド

GUID(グローバル一意識別子：Global Unique Identifier)を生成します。

GUID(グローバル一意識別子：Global Unique Identifier)を生成します。

GUIDは、COMのクラス識別子(CLSID)、インターフェイス識別子(IID)など多数の
領域でWindows上のオブジェクトの識別に利用される128ビットの値です。

WIN32OLEが生成するGUIDは以下の形式によるGUIDの文字列表現です。なお00〜
FFはGUIDの先頭からのバイト位置を示します。これはレジストリのキーとして
利用される形式です。

{33221100-5544-7766-8899-AABBCCDDEEFF}

@return GUIDの文字列表現を返します。
...

• WIN32OLE

WIN32OLE#each {|i|...} -> () (63019.0)

• 2.3.0

• インスタンスメソッド

オブジェクトの列挙インターフェイスを呼び出してアイテム単位にブロックを 実行します。

オブジェクトの列挙インターフェイスを呼び出してアイテム単位にブロックを
実行します。

OLEオートメーションサーバの中には、コレクション用インターフェイスを持つ
ものがあります。eachメソッドは、このようなオブジェクトの列挙メソッドを
呼び出して、アイテム毎のイテレーションを行います。

@param i コレクション内のアイテム

@raise WIN32OLERuntimeError selfが列挙インターフェイスをサポートしてい
ない場合に通知します。

excel = WIN32OLE.new('Excel.Appli...

• WIN32OLE

WIN32OLE#ole_activex_initialize -> nil (63019.0)

• 2.3.0

• インスタンスメソッド

ActiveXコントロール用の初期化を行います。

ActiveXコントロール用の初期化を行います。

ole_activex_initializeメソッドは、スクリプト内でActiveXコントロールを利
用できるように、オブジェクトが持つ永続化データを初期化します。

ActiveXコントロール（OCX）は、主にUI用に利用されるOLEオートメーションサー
バです。ActiveXコントロールは、IDEを利用した開発時と、プログラムの実行
時の2種類の実行モードを持ちます。これは、開発時の設定を永続化するためで
す。

幾つかのActiveXコントロールは、上記の動作を前提に組まれているため、実行
に先だって永続化データの転送をデータの有無と...

• WIN32OLE

絞り込み条件を変える

WIN32OLE#ole_respond_to?(name) -> bool (63019.0)

• 2.3.0

• インスタンスメソッド

指定したメソッドをオブジェクトがサポートしているか調べます。

指定したメソッドをオブジェクトがサポートしているか調べます。

OLEオートメーションサーバが引数で指定した名前のメソッド（プロパティ）を
サポートしているかどうかを調べます。

なお、OLEオートメーションの仕様により、メソッド名の大文字、小文字は区別
されません。

@param name 調べるメソッド名を文字列またはシンボルで指定します。

@return nameで指定したメソッドをオブジェクトが提供していれば真を返します。

excel = WIN32OLE.new('Excel.Application')
excel.ole_respond_to?(:quit) #=...

• WIN32OLE

WIN32OLE#setproperty(name, args..., val) -> () (63019.0)

• 2.3.0

• インスタンスメソッド

オブジェクトのプロパティを設定します。

オブジェクトのプロパティを設定します。

プロパティ名を指定してOLEオートメーションオブジェクトのプロパティ
（Rubyの属性に相当）を設定します。

なお、OLEオートメーションの仕様により、プロパティ名の大文字、小文字は区
別されません。

@param name プロパティ名を文字列またはシンボルで指定します。
@param val プロパティに設定する値を指定します。
@param args 集合的なプロパティに対する設定項目を特定するための引数を指
定します。
@raise WIN32OLERuntimeError オートメーションサーバの呼び出しに失敗し...

• WIN32OLE

WIN32OLE#setproperty(name, val) -> () (63019.0)

• 2.3.0

• インスタンスメソッド

オブジェクトのプロパティを設定します。

オブジェクトのプロパティを設定します。

プロパティ名を指定してOLEオートメーションオブジェクトのプロパティ
（Rubyの属性に相当）を設定します。

なお、OLEオートメーションの仕様により、プロパティ名の大文字、小文字は区
別されません。

@param name プロパティ名を文字列またはシンボルで指定します。
@param val プロパティに設定する値を指定します。
@param args 集合的なプロパティに対する設定項目を特定するための引数を指
定します。
@raise WIN32OLERuntimeError オートメーションサーバの呼び出しに失敗し...

• WIN32OLE

WIN32OLE::CP_ACP -> Integer (63001.0)

• 2.3.0

• 定数

Windows既定のANSIコードページ（0）を示します。

Windows既定のANSIコードページ（0）を示します。

• WIN32OLE

WIN32OLE::CP_MACCP -> Integer (63001.0)

• 2.3.0

• 定数

Macintoshコードページ（2）を示します。

Macintoshコードページ（2）を示します。

• WIN32OLE

絞り込み条件を変える

WIN32OLE::CP_OEMCP -> Integer (63001.0)

• 2.3.0

• 定数

OEMコードページ（1）を示します。

OEMコードページ（1）を示します。

• WIN32OLE

WIN32OLE::CP_SYMBOL -> Integer (63001.0)

• 2.3.0

• 定数

文字コードの変換にシンボルを利用することを示します（42）。

文字コードの変換にシンボルを利用することを示します（42）。

• WIN32OLE

WIN32OLE::CP_THREAD_ACP -> Integer (63001.0)

• 2.3.0

• 定数

現在実行中のスレッドの既定のコードページ（3）を示します。

現在実行中のスレッドの既定のコードページ（3）を示します。

Windowsのコードページはスレッド毎に異なる値を設定できます。

• WIN32OLE

WIN32OLE::CP_UTF7 -> Integer (63001.0)

• 2.3.0

• 定数

文字コードの変換にUTF-7を利用することを示します（65000）。

文字コードの変換にUTF-7を利用することを示します（65000）。

• WIN32OLE

WIN32OLE::CP_UTF8 -> Integer (63001.0)

• 2.3.0

• 定数

文字コードの変換にUTF-8を利用することを示します（65001）。

文字コードの変換にUTF-8を利用することを示します（65001）。

• WIN32OLE

絞り込み条件を変える

WIN32OLE::LOCALE_USER_DEFAULT -> Integer (63001.0)

• 2.3.0

• 定数

ユーザ既定のロケールを示すLCID(0x0400)です。

ユーザ既定のロケールを示すLCID(0x0400)です。

• WIN32OLE

win32ole (18325.0)

• 2.3.0

• ライブラリ

Microsoft Windows で COM や ActiveX を扱うためのライブラリです。

Microsoft Windows で COM や ActiveX を扱うためのライブラリです。

* http://suke.my.coocan.jp/ruby/win32ole/index.html
* http://pub.cozmixng.org/~the-rwiki/rw-cgi.rb?cmd=view;name=Win32OLE
* http://objectclub.jp/community/memorial/homepage3.nifty.com/masarl/article/ruby-win32ole.html
* Rubyist Magazine https...

• WIN32OLE
• WIN32OLE::VARIANT
• WIN32OLERuntimeError
• WIN32OLE_EVENT
• WIN32OLE_METHOD
• WIN32OLE_PARAM
• WIN32OLE_TYPE
• WIN32OLE_TYPELIB
• WIN32OLE_VARIABLE
• WIN32OLE_VARIANT

WIN32OLE_METHOD (18181.0)

• 2.3.0

• クラス

OLEオートメーションサーバが持つメソッドの情報を提供します。

OLEオートメーションサーバが持つメソッドの情報を提供します。

WIN32OLE_METHODは、WIN32OLE#ole_methodsなどの呼び出しによって返さ
れるオブジェクトで、OLEオートメーションサーバのメソッドの情報（メタデー
タ）を保持します。

=== サンプルコード

excel = WIN32OLE.new('Excel.Application')
excel.ole_methods.each do |method|
if method.visible?
puts <<SIGNATURE
#{method.return_type} ...

• WIN32OLE_PARAM

WIN32OLE_VARIANT (18181.0)

• 2.3.0

• クラス

OLEオートメーションの標準型のVARIANTオブジェクトをRubyで利用するための クラスです。

OLEオートメーションの標準型のVARIANTオブジェクトをRubyで利用するための
クラスです。

VARIANT型とは、型情報と値のペアから構成されるデータ型で、元はVBの型無し
変数のための構造体です。OLEオートメーションのメソッド呼び出しには汎用型
として引数にはVARIANT型を利用します。

* 型情報は、WIN32OLE_VARIANT#vartypeで取得できます。
* 値は、WIN32OLE_VARIANT#valueで取得できます。

OLEオートメーションのメソッド呼び出し規約では、引数はVARIANT型の配列と
して定義されています。

この規約に対して、WIN3...

WIN32OLE_VARIABLE (18163.0)

• 2.3.0

• クラス

OLEオートメーションの変数情報をRubyで参照するためのクラスです。

OLEオートメーションの変数情報をRubyで参照するためのクラスです。

OLEオートメーションサーバは、定数（WIN32OLE.const_load）、メソッ
ド/プロパティ（WIN32OLE_METHOD）、イベント（WIN32OLE_EVENT）
のほかに変数をクライアントへ提供できます。WIN32OLE_VARIABLEクラスは、サー
バが提供する変数の情報をオブジェクト化します。変数情報にはCOMで決められ
た構造体やユーザ定義型のフィールド情報などがありますが、最も良く利用さ
れるのはenum（列挙型）のメンバ情報です。enumのメンバは定数として利用で
きます。

WIN32OL...

• WIN32OLE_EVENT
• WIN32OLE_METHOD

絞り込み条件を変える

WIN32OLE_TYPE (18157.0)

• 2.3.0

• クラス

WIN32OLE_TYPEオブジェクトは、型情報ライブラリ（TypeLib）内に定義された 1つの型情報を保持します。

WIN32OLE_TYPEオブジェクトは、型情報ライブラリ（TypeLib）内に定義された
1つの型情報を保持します。

=== サンプルコード

require 'win32ole'

excel_app_type = WIN32OLE_TYPE.new('Microsoft Excel 14.0 Object Library', 'Application')
puts excel_app_type.progid # => "Excel.Application.14"



Ruby-1.9.1以降、WIN32OLE_TYPELIBオブジェクトの
WIN32OLE_TYPELIB...

• WIN32OLE_TYPELIB

WIN32OLE_PARAM (18091.0)

• 2.3.0

• クラス

OLEオートメーションサーバが持つメソッドのパラメータ情報を提供します。

OLEオートメーションサーバが持つメソッドのパラメータ情報を提供します。

WIN32OLE_PARAMは、WIN32OLE_METHODのパラメータのメタデータを保持し
ます。

=== サンプルコード

tobj = WIN32OLE_TYPE.new('Microsoft Excel 9.0 Object Library', 'Workbook')
method = WIN32OLE_METHOD.new(tobj, 'SaveAs')
param1 = method.params[0]
puts param1.name # => Filename...

• WIN32OLE_METHOD

WIN32OLE_EVENT (18073.0)

• 2.3.0

• クラス

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

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

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

=== サンプルコード

ie = WIN32OLE.new('InternetExplorer.Application.1')
event = WIN32OLE_EVENT.new(ie, 'DWebBr...

WIN32OLE_TYPELIB (18073.0)

• 2.3.0

• クラス

OLEオートメーションサーバの型情報ライブラリ（TypeLib）を操作するための クラスです。

OLEオートメーションサーバの型情報ライブラリ（TypeLib）を操作するための
クラスです。

OLEオートメーションサーバはクライアントに、クラス、インターフェイス、メ
ソッドなどのメタデータを提供するための機構を持ちます。この情報は拡張子
からTLBと呼ばれるライブラリまたはオートメーションサーバのプログラム内の
リソースとして保持され、クライアントからの要求によって参照可能となりま
す。

WIN32OLE_TYPELIBクラスは、TypeLibを操作して各種情報を参照するためのオブ
ジェクトを生成します。

=== サンプルコード

require 'win32ole'

...

WIN32OLERuntimeError (18001.0)

• 2.3.0

• クラス

COMインターフェイスエラー時に発生する例外です。

COMインターフェイスエラー時に発生する例外です。

WIN32OLERuntimeErrorは、OLEオートメーション呼び出しが例外ステータス
（HRESULTのMSBがオン）で返った場合や、メソッド呼び出し時にオートメーショ
ン仕様で認められていない値が与えられた場合に発生します。

OLEオートメーション呼び出しが例外ステータスで戻された場合は、メッセージ
に例外となったHRESULT値と対応するメッセージが表示されます。

HRESULT: http://msdn.microsoft.com/en-us/library/cc704587(v=PROT.10).aspx

絞り込み条件を変える

WIN32OLE_TYPE#default_event_sources -> [WIN32OLE_TYPE] (9628.0)

• 2.3.0

• インスタンスメソッド

型が持つソースインターフェイスを取得します。

型が持つソースインターフェイスを取得します。

default_event_sourcesメソッドは、selfがCoClass（コンポーネントクラス）
の場合、そのクラスがサポートするデフォルトのソースインターフェイス（イ
ベントの通知元となるインターフェイス）を返します。

@return デフォルトのソースインターフェイスをWIN32OLE_TYPEの配列と
して返します。返すのは配列ですが、デフォルトのソースインターフェ
イスは最大でも1インターフェイスです。ソースインターフェイスを持
たない場合は空配列を返します。

tobj = ...

• WIN32OLE_TYPE

WIN32OLE_VARIANT.new(val, vartype = nil) -> WIN32OLE_VARIANT (9532.0)

• 2.3.0

• 特異メソッド

指定したオブジェクトを値とするWIN32OLE_VARIANTオブジェクトを生成します。

指定したオブジェクトを値とするWIN32OLE_VARIANTオブジェクトを生成します。

@param val ラップするRubyオブジェクトを指定します。
@param vartype 省略時はWIN32OLEが自動型変換を行います。指定する場合は
WIN32OLE::VARIANTの定数を指定してください。
@return val引数を値として持つWIN32OLE_VARIANTオブジェクトを返します。

@raise TypeError val引数の型がArray、String、Integer、Float、Time、
WI...

• WIN32OLE::VARIANT
• WIN32OLE_VARIANT

WIN32OLE_METHOD.new(ole_type, method) -> WIN32OLE_METHOD (9526.0)

• 2.3.0

• 特異メソッド

WIN32OLE_TYPEとメソッド名を指定してWIN32OLE_METHODのインスタンス を生成します。

WIN32OLE_TYPEとメソッド名を指定してWIN32OLE_METHODのインスタンス
を生成します。

OLEオートメーションサーバの型情報とメソッド名からWIN32OLE_METHODのイン
スタンスを生成します。

アプリケーションプログラムでは、WIN32OLE_METHODオブジェクトをnewメソッ
ドで生成するよりも、WIN32OLE#ole_methodなどのメソッドを参照するほ
うが簡単です。

@param ole_type WIN32OLE_TYPEのインスタンス。
@param method メソッド名を文字列で指定します。
@return methodパラメータに...

• WIN32OLE_METHOD
• WIN32OLE_TYPE

WIN32OLE_TYPELIB.new(libname, mjv = nil, miv = nil) -> WIN32OLE_TYPELIB (9496.0)

• 2.3.0

• 特異メソッド

WIN32OLE_TYPELIBオブジェクトを生成します。

WIN32OLE_TYPELIBオブジェクトを生成します。

@param libname 生成するTypeLibのレジストリ上のドキュメント文字列
（WIN32OLE_TYPELIB#name）または
GUID（WIN32OLE_TYPELIB#guid）またはTLBファイル名を
文字列で指定します。
@param mjv 作成するTypeLibのメジャーバージョン番号をIntegerで指定します。
または整数部にメジャーバージョン、小数点数部にマイナーバージョ
...

• WIN32OLE_TYPELIB

WIN32OLE_PARAM.new(ole_method, index) -> WIN32OLE_PARAM (9460.0)

• 2.3.0

• 特異メソッド

メソッドとパラメータ位置を指定してWIN32OLE_PARAMのインスタンスを作成します。

メソッドとパラメータ位置を指定してWIN32OLE_PARAMのインスタンスを作成します。

アプリケーションプログラムでは、WIN32OLE_PARAMオブジェクトをnewメソッド
で生成するよりも、WIN32OLE_METHOD#paramsを参照するほうが簡単です。

@param ole_method パラメータを取得するWIN32OLE_METHODのインスタンス。
@param index パラメータの位置。最左端を1とします。
@return メソッドの指定位置のパラメータの情報を持つオブジェクトを返します。
@raise TypeError ole_methodパラメータがW...

• WIN32OLE_METHOD
• WIN32OLE_PARAM

絞り込み条件を変える

WIN32OLE_TYPE.new(libname, ole_class) -> WIN32OLE_TYPE (9460.0)

• 2.3.0

• 特異メソッド

WIN32OLE_TYPEオブジェクトを生成します。

WIN32OLE_TYPEオブジェクトを生成します。

@param libname 生成するTypeLibのレジストリ上のドキュメント文字列
（WIN32OLE_TYPELIB#name）または
GUID（WIN32OLE_TYPELIB#guid）またはTLBファイル名を
文字列で指定します。
@param ole_class 型情報を取り出す型の名前を指定します。
@return 指定されたTypeLIbに定義された型の情報を格納したWIN32OLE_TYPEオブジェクトを返します。
@raise W...

• WIN32OLE_TYPE
• WIN32OLE_TYPELIB

WIN32OLE_EVENT.new(ole, event = nil) -> WIN32OLE_EVENT (9448.0)

• 2.3.0

• 特異メソッド

OLEオートメーションサーバのイベント受信機構をオブジェクト化して返します。

OLEオートメーションサーバのイベント受信機構をオブジェクト化して返します。

newメソッドは、OLEオートメーションサーバがイベント通知に利用するインター
フェイスを取得し、オブジェクトとして返します。

@param ole イベントの通知元のWIN32OLEオブジェクトを指定します。

@param event イベントのインターフェイスを示すインターフェイス名または
IIDを文字列で指定します。省略時にはoleパラメータで指定した
オブジェクトの既定のイベントインターフェイスを利用します。

@return 指定したオブジェクトの...

• WIN32OLE_EVENT

WIN32OLE_TYPE.ole_classes(libname) -> [WIN32OLE_TYPE] (9412.0)

• 2.3.0

• 特異メソッド

TypeLibで定義されているすべての型情報を取得します。

TypeLibで定義されているすべての型情報を取得します。

@param libname 生成するTypeLibのレジストリ上のドキュメント文字列
（WIN32OLE_TYPELIB#name）または
GUID（WIN32OLE_TYPELIB#guid）またはTLBファイル名を
文字列で指定します。
@return TypeLibに格納されているすべての型をWIN32OLE_TYPEオブジェクトの配列として返します。
@raise WIN32OLERuntimeError 引数で指定したTypeLibが...

• WIN32OLE_TYPE
• WIN32OLE_TYPELIB

WIN32OLE_VARIANT.array(dims, vt) -> WIN32OLE_VARIANT (9412.0)

• 2.3.0

• 特異メソッド

配列用のVARIANTオブジェクトを生成します。

配列用のVARIANTオブジェクトを生成します。

オートメーションメソッド呼び出し用の配列を生成します。なお、OLEオートメー
ションの配列の次元と添え字の関係はVB型だという点に注意してください。こ
れはCと逆順の並びです。

@param dims 各次元の要素数を示す配列を与えます。たとえば4要素のベクター
であれば[4]、各3要素の2次元配列であれば[3, 3]とします。
@param vt 配列要素の型をWIN32OLE::VARIANTの定数で指定します。
@return 指定された次元/要素数を持つWIN32OLE_VARIANTオブジェクト。

次の例...

• WIN32OLE::VARIANT
• WIN32OLE_VARIANT

WIN32OLE_METHOD#params -> [WIN32OLE_PARAM] (9376.0)

• 2.3.0

• インスタンスメソッド

メソッドのパラメータ情報を取得します。

メソッドのパラメータ情報を取得します。

このメソッドのパラメータをWIN32OLE_PARAMの配列として返します。配
列の最初の要素が最左端のパラメータに対応します。

@return WIN32OLE_PARAMの配列。無引数のメソッドであれば要素数0の配
列を返します。

tobj = WIN32OLE_TYPE.new('Microsoft Excel 14.0 Object Library', 'Workbook')
method = WIN32OLE_METHOD.new(tobj, 'SaveAs')
p method.params # => ...

• WIN32OLE_METHOD
• WIN32OLE_PARAM

絞り込み条件を変える

WIN32OLE_TYPE#variables -> [WIN32OLE_VARIABLE] (9376.0)

• 2.3.0

• インスタンスメソッド

型が持つ変数を取得します。

型が持つ変数を取得します。

型がEnum（列挙型）やユーザ定義型の場合、メンバ変数の情報を
WIN32OLE_VARIABLEオブジェクトの配列として返します。

@return 型が持つ変数情報をWIN32OLE_VARIABLEの配列として返します。
変数を持たない場合は空配列を返します。
@raise WIN32OLERuntimeError 型属性が取得できない場合に通知します。

tobj = WIN32OLE_TYPE.new('Microsoft Excel 14.0 Object Library', 'XlSheetType')
vars = to...

• WIN32OLE_TYPE
• WIN32OLE_VARIABLE

WIN32OLE_VARIANT::Empty -> WIN32OLE_VARIANT (9370.0)

• 2.3.0

• 定数

EMPTY型のWIN32OLE_VARIANTオブジェクトです。

EMPTY型のWIN32OLE_VARIANTオブジェクトです。

このオブジェクトは、VOID型の戻り値や、値が空なことを明示しなければなら
ない特殊な引数に利用します。

@see WIN32OLE::VARIANT::VT_EMPTY

• WIN32OLE_VARIANT

WIN32OLE_VARIANT::Null -> WIN32OLE_VARIANT (9370.0)

• 2.3.0

• 定数

NULL型のWIN32OLE_VARIANTオブジェクトです。

NULL型のWIN32OLE_VARIANTオブジェクトです。

このオブジェクトは、ADOなどのデータベースインターフェイスでNULLを指定す
るのに利用可能です。

@see WIN32OLE::VARIANT::VT_NULL

• WIN32OLE_VARIANT

WIN32OLE_TYPE#ole_methods -> [WIN32OLE_METHOD] (9358.0)

• 2.3.0

• インスタンスメソッド

型が持つメソッドのメタデータを取得します。

型が持つメソッドのメタデータを取得します。

@return 型が持つメソッドのメタデータをWIN32OLE_METHODの配列として返します。
メソッドを持たない場合は空配列を返します。


tobj = WIN32OLE_TYPE.new('Microsoft Excel 14.0 Object Library', 'Worksheet')
methods = tobj.ole_methods.map {|m| m.name }
# => ['QueryInterface', 'AddRef', 'Release',.....

• WIN32OLE_METHOD
• WIN32OLE_TYPE

WIN32OLE_TYPE#source_ole_types -> [WIN32OLE_TYPE] (9358.0)

• 2.3.0

• インスタンスメソッド

型が持つソースインターフェイスを取得します。

型が持つソースインターフェイスを取得します。

source_ole_typesメソッドは、selfがCoClass（コンポーネントクラス）の場合、
そのクラスがサポートするすべてのソースインターフェイス（イベントの通知
元となるインターフェイス）を返します。

ActiveXコントロールのようにイベント（WIN32OLE_EVENT）をサポートし
ているコンポーネントクラスの場合は、このメソッドの呼び出しによりイベン
トインターフェイスを調べることが可能です。

@return ソースインターフェイスをWIN32OLE_TYPEの配列として返します。
ソースインターフェイスを...

• WIN32OLE_EVENT
• WIN32OLE_TYPE

絞り込み条件を変える

WIN32OLE_TYPELIB#ole_classes -> [WIN32OLE_TYPE] (9343.0)

• 2.3.0

• インスタンスメソッド

TypeLibに格納されているすべての型を取得します。

TypeLibに格納されているすべての型を取得します。

TypeLibに格納されている型には、クラス（CoClass——コンポーネントクラス）
やEnum（列挙子）、構造体などがあります。

@return TypeLibに格納されているすべての型をWIN32OLE_TYPEオブジェ
クトの配列として返します。

tlib = WIN32OLE_TYPELIB.new('Microsoft Excel 14.0 Object Library')
classes = tlib.ole_types.map{|k| k.name} # => ["Adjustments...

• WIN32OLE_TYPE
• WIN32OLE_TYPELIB

WIN32OLE_TYPELIB#ole_types -> [WIN32OLE_TYPE] (9343.0)

• 2.3.0

• インスタンスメソッド

TypeLibに格納されているすべての型を取得します。

TypeLibに格納されているすべての型を取得します。

TypeLibに格納されている型には、クラス（CoClass——コンポーネントクラス）
やEnum（列挙子）、構造体などがあります。

@return TypeLibに格納されているすべての型をWIN32OLE_TYPEオブジェ
クトの配列として返します。

tlib = WIN32OLE_TYPELIB.new('Microsoft Excel 14.0 Object Library')
classes = tlib.ole_types.map{|k| k.name} # => ["Adjustments...

• WIN32OLE_TYPE
• WIN32OLE_TYPELIB

WIN32OLE_TYPE#default_ole_types -> [WIN32OLE_TYPE] (9340.0)

• 2.3.0

• インスタンスメソッド

型が持つデフォルトのインターフェイスを取得します。

型が持つデフォルトのインターフェイスを取得します。

default_ole_typesメソッドは、selfがCoClass（コンポーネントクラス）の場
合、そのクラスが実装しているデフォルトのインターフェイスと、サポートし
ていればデフォルトのソースインターフェイスを返します。

@return デフォルトインターフェイスをWIN32OLE_TYPEの配列として返し
ます。デフォルトインターフェイスは、最大でも、クラス操作用のイ
ンターフェイス（OLEオートメーション用）と、イベント用のソースイ
ンターフェイスの2要素です。デフォルトインターフ...

• WIN32OLE_TYPE

WIN32OLE_TYPE#implemented_ole_types -> [WIN32OLE_TYPE] (9340.0)

• 2.3.0

• インスタンスメソッド

この型が実装するインターフェイスを取得します。

この型が実装するインターフェイスを取得します。

implemented_ole_typesメソッドは、selfがCoClass（コンポーネントクラス）
の場合、そのクラスが実装しているすべてのインターフェイスを返します。

@return クラスが実装するすべてのインターフェイスをWIN32OLE_TYPEの
配列として返します。この型がインターフェイスを実装しない場合は、
空配列を返します。

@raise WIN32OLERuntimeError 型属性が取得できない場合に通知します。

tobj = WIN32OLE_TYPE.new('Micro...

• WIN32OLE_TYPE

WIN32OLE_TYPE#ole_typelib -> WIN32OLE_TYPELIB | nil (9340.0)

• 2.3.0

• インスタンスメソッド

この型を登録してある型情報ライブラリ（TypeLib）を取得します。

この型を登録してある型情報ライブラリ（TypeLib）を取得します。

@return この型を登録しているTypeLibをWIN32OLE_TYPELIBオブジェクト
として返します。見つからない場合はnilを返します。

tobj = WIN32OLE_TYPE.new('Microsoft Excel 14.0 Object Library', 'Worksheet')
puts tobj.ole_typelib.name # => 'Microsoft Excel 14.0 Object Library'

• WIN32OLE_TYPE
• WIN32OLE_TYPELIB

絞り込み条件を変える

WIN32OLE_TYPELIB.typelibs -> [WIN32OLE_TYPELIB] (9340.0)

• 2.3.0

• 特異メソッド

システムに登録されているすべてのTypeLibを取得します。

システムに登録されているすべてのTypeLibを取得します。

@return 登録されているすべてのTypeLibを元にWIN32OLE_TYPELIBオブジェクト
の配列を返します。

tlibs = WIN32OLE_TYPELIB.typelibs

• WIN32OLE_TYPELIB

WIN32OLE_VARIANT::Nothing -> WIN32OLE_VARIANT (9322.0)

• 2.3.0

• 定数

DISPATCH型の空のオブジェクトです。

DISPATCH型の空のオブジェクトです。

@see WIN32OLE::VARIANT::VT_DISPATCH

• WIN32OLE_VARIANT

WIN32OLE_VARIANT#[]=(i..., val) -> object (9139.0)

• 2.3.0

• インスタンスメソッド

配列型のWIN32OLE_VARIANTの要素を設定します。

配列型のWIN32OLE_VARIANTの要素を設定します。

selfは、WIN32OLE_VARIANT.arrayまたは引数に配列を指定して
WIN32OLE_VARIANT.newで作成したインスタンスの必要があります。

@param i 各次元の0からのインデックスを「,」で区切って次元数分指定します。
インデックスは0から要素数-1までのIntegerで指定してください。
@param val 設定値を指定します。Array、String、Integer、Float、
TrueClass、FalseClass、NilClass以外のオブジェ...

• WIN32OLE_VARIANT

WIN32OLE_METHOD#dispid -> Integer (9127.0)

• 2.3.0

• インスタンスメソッド

メソッドのディスパッチID（DISPID）を取得します。

メソッドのディスパッチID（DISPID）を取得します。

ディスパッチIDはメソッドの一意識別子です。WIN32OLEでは、
WIN32OLE#_invokeなどのメソッドで、呼び出すサーバのメソッドを指定
するのに利用します。

@return メソッドのDISPIDを返します。

tobj = WIN32OLE_TYPE.new('Microsoft Excel 14.0 Object Library', 'Workbooks')
method = WIN32OLE_METHOD.new(tobj, 'Add')
puts method.dispid # => 181
...

• WIN32OLE_METHOD

WIN32OLE_VARIANT#[](i...) -> object (9121.0)

• 2.3.0

• インスタンスメソッド

配列型のWIN32OLE_VARIANTの要素を取得します。

配列型のWIN32OLE_VARIANTの要素を取得します。

selfは、WIN32OLE_VARIANT.arrayまたは引数に配列を指定して
WIN32OLE_VARIANT.newで作成したインスタンスの必要があります。

@param i 各次元の0からのインデックスを「,」で区切って次元数分指定します。
インデックスは0から要素数-1までのIntegerで指定してください。
@return 引数で指定したインデックスの要素を返します。
@raise ArgError 引数の数が次元数と一致していません。

@raise WIN32OLERuntimeError s...

• WIN32OLE_VARIANT

絞り込み条件を変える

WIN32OLE_VARIANT#value=(val) -> () (9121.0)

• 2.3.0

• インスタンスメソッド

WIN32OLE_VARIANTの値を再設定します。

WIN32OLE_VARIANTの値を再設定します。

指定した値でselfを再設定します。指定値が元のVARIANT型に合わない場合は元
のVARIANT型に合うように引数を変換します。変換は、引数を一度VARIANT型に
変換してからCOMのVARIANT型変換関数（VariantChangeTypeEx）を呼び出すこと
で実現します。

@param val 設定値を指定します。
@raise WIN32OLERuntimeError selfが配列型です。あるいは、型変換に失敗し
ました。

obj = WIN32OLE_V...

• WIN32OLERuntimeError
• WIN32OLE_VARIANT

WIN32OLE_EVENT#on_event(event = nil) {|*args| ... } -> () (9109.0)

• 2.3.0

• インスタンスメソッド

イベント通知を受けるブロックを登録します。

イベント通知を受けるブロックを登録します。

引数にはイベントのメソッド名を指定します。引数を省略した場合は、すべて
のイベントを対象とするブロックの登録となります。

@param event イベント名を文字列かシンボルで指定します。イベント名は大文
字小文字を区別します。省略時にはすべてのイベントが対象となります。

@param args サーバがイベント通知時に指定した引数です。
eventパラメータを省略した場合、第1引数にはイベントのメソッ
ド名が文字列で与えられます。引数の変更が必要な場合は、
...

• WIN32OLE_EVENT

WIN32OLE_METHOD#helpcontext -> Integer | nil (9109.0)

• 2.3.0

• インスタンスメソッド

メソッドのヘルプコンテキストを取得します。

メソッドのヘルプコンテキストを取得します。

ヘルプコンテキストは、関連するヘルプファイル上のトピック位置を示す整数
値です。

@return ヘルプコンテキストを返します。未定義の場合はnilを返します。

tobj = WIN32OLE_TYPE.new('Microsoft Excel 14.0 Object Library', 'Workbooks')
method = WIN32OLE_METHOD.new(tobj, 'Add')
puts method.helpcontext # => 65717

WIN32OLE_METHODオブジェクトを引数として、WI...

• WIN32OLE_METHOD

WIN32OLE_METHOD#helpfile -> String | nil (9091.0)

• 2.3.0

• インスタンスメソッド

ヘルプファイルのパス名を取得します。

ヘルプファイルのパス名を取得します。

メソッドにヘルプファイルが関連付けられている場合、該当ヘルプファイルの
パス名を返します。

@return ヘルプファイルのパス名を文字列で返します。ヘルプファイルが未定
義ならばnilを返します。

tobj = WIN32OLE_TYPE.new('Microsoft Excel 14.0 Object Library', 'Workbooks')
method = WIN32OLE_METHOD.new(tobj, 'Add')
puts method.helpfile # => C:\...\VBAXL9.CH...

• WIN32OLE_METHOD

WIN32OLE_TYPE#inspect -> String (9091.0)

• 2.3.0

• インスタンスメソッド

selfを説明的な文字列で表現します。

selfを説明的な文字列で表現します。

@return "#<WIN32OLE_TYPE"とWIN32OLE_TYPE#to_sの結果を「:」で結合
し、「>」で閉じた文字列を返します。

x = WIN32OLE_TYPE.new('Microsoft Excel 14.0 Object Library', 'Worksheet')
puts x.inspect #=> #<WIN32OLE_TYPE:Worksheet>

@see WIN32OLE_TYPE#to_s

• WIN32OLE_TYPE

絞り込み条件を変える

WIN32OLE_VARIANT#vartype -> Integer (9091.0)

• 2.3.0

• インスタンスメソッド

selfの型情報を取得します。

selfの型情報を取得します。

型情報は、WIN32OLE::VARIANTの定数値の組み合わせです。

obj = WIN32OLE_VARIANT.new("string")
obj.vartype # => 8 (WIN32OLE::VARIANT::VT_BSTR)
bytes = WIN32OLE_VARIANT.new([1,2,3,4,5], VT_UI1 | VT_ARRAY)
bytes.vartype # => 8209 (WIN32OLE::VARIANT::VT_ARRAY | VT_UI1)

• WIN32OLE::VARIANT
• WIN32OLE_VARIANT

WIN32OLE_EVENT#off_event(event = nil) -> () (9085.0)

• 2.3.0

• インスタンスメソッド

WIN32OLE_EVENT#on_eventで登録したブロックを解除します。

WIN32OLE_EVENT#on_eventで登録したブロックを解除します。

@param event 文字列またはシンボルで登録時に指定したイベント名を指定しま
す。nilの場合、WIN32OLE_EVENT#on_eventに対してnilを指定したブロッ
クを解除します。

ev = WIN32OLE_EVENT.new(ie, 'DWebBrowserEvents')
ev.on_event(:NavigateComplete) {|url| puts url }
...
ev.off_event(:NavigateComplete)

• WIN32OLE_EVENT

WIN32OLE_EVENT#handler=(obj) -> () (9073.0)

• 2.3.0

• インスタンスメソッド

イベント処理を実行するオブジェクトを登録します。

イベント処理を実行するオブジェクトを登録します。

イベントハンドラをメソッドとして持つオブジェクトをイベントハンドラとし
て登録します。

イベントハンドラはイベント名に「on」を前置します。もし、イベントに対応
するonメソッドが実装されていなければmethod_missingが呼ばれます。イベン
ト名は大文字小文字を区別するため、正確な記述が必要です。

@param obj イベントに対応するメソッドを持つオブジェクト。イベント受信を
解除するにはnilを指定します。

class IeHandler
def initialize
@com...

• WIN32OLE_EVENT

WIN32OLE_EVENT#on_event_with_outargs(event = nil) {|*args| ... } -> () (9073.0)

• 2.3.0

• インスタンスメソッド

イベント通知を受けて結果を呼び出し元へ返すブロックを登録します。

イベント通知を受けて結果を呼び出し元へ返すブロックを登録します。

引数にはイベントのメソッド名を指定します。引数を省略した場合は、すべて
のイベントを対象とするブロックの登録となります。

WIN32OLE_EVENT#on_eventと異なり、イベントのブロック変数に戻り値を
設定できます。

@param event イベント名を文字列かシンボルで指定します。イベント名は大文
字小文字を区別します。省略時にはすべてのイベントが対象となります。

@param args サーバがイベント通知時に指定した引数の配列です。
eventパラメータ...

• WIN32OLE_EVENT

WIN32OLE_METHOD#invoke_kind -> String (9073.0)

• 2.3.0

• インスタンスメソッド

メソッドの種類を文字列で取得します。

メソッドの種類を文字列で取得します。

ここで言うメソッドの種類というのは、OLEオートメーションクライアントの記
述言語がどのような形式でサーバ呼び出しを記述すべきかを指定した属性値で
す。

@return メソッドの種類を示す文字列を返します。

tobj = WIN32OLE_TYPE.new('Microsoft Excel 14.0 Object Library', 'Workbooks')
method = WIN32OLE_METHOD.new(tobj, 'Add')
puts method.invoke_kind # => "FUNC"

返送値は以下のい...

• WIN32OLE_METHOD

絞り込み条件を変える

WIN32OLE_METHOD#return_type -> String (9073.0)

• 2.3.0

• インスタンスメソッド

メソッドの返り値の型名を取得します。

メソッドの返り値の型名を取得します。

@return 返り値の型名を示す文字列を返します。
@raise WIN32OLERuntimeError メソッドの型情報を取得できなかった場合に通知します。

tobj = WIN32OLE_TYPE.new('Microsoft Excel 14.0 Object Library', 'Application')
method = WIN32OLE_METHOD.new(tobj, 'Visible')
puts method.return_type # => BOOL

OLEオートメーションの型名は、対応するWIN32OLE...

• WIN32OLE::VARIANT
• WIN32OLE_METHOD

WIN32OLE_PARAM#input? -> bool (9073.0)

• 2.3.0

• インスタンスメソッド

パラメータがクライアントからサーバへ与えるものかを判定します。

パラメータがクライアントからサーバへ与えるものかを判定します。

OLEオートメーションのパラメータは、in(クライアントからサーバへ与える。
WIN32OLE_PARAM#input?が真)、out（サーバがクライアントへ与える。
WIN32OLE_PARAM#output?が真)および、inout（クライアントからサーバ
へ与え、サーバがクライアントへ与える）の3種類の方向属性のいずれかを持ち
ます。

input?メソッドはin属性またはinout属性なら真を返します。

@return メソッドの方向属性がinまたはinoutならば真を返します。

tobj = WIN32OLE...

• WIN32OLE_PARAM

WIN32OLE_PARAM#ole_type -> String (9073.0)

• 2.3.0

• インスタンスメソッド

パラメータの型名を取得します。

パラメータの型名を取得します。

@return パラメータの型名を示す文字列を返します。
パラメータの型情報が見つからない場合は、"unknown type"を返します。

tobj = WIN32OLE_TYPE.new('Microsoft Excel 9.0 Object Library', 'Workbook')
method = WIN32OLE_METHOD.new(tobj, 'SaveAs')
param1 = method.params[0]
puts param1.ole_type # => VARIANT

OLEオートメーション...

• WIN32OLE::VARIANT
• WIN32OLE_PARAM

WIN32OLE_PARAM#output? -> bool (9073.0)

• 2.3.0

• インスタンスメソッド

パラメータがクライアントからの結果を受け取るためのものかを判定します。

パラメータがクライアントからの結果を受け取るためのものかを判定します。

OLEオートメーションのパラメータは、in(クライアントからサーバへ与える。
WIN32OLE_PARAM#input?が真)、out（サーバがクライアントへ与える。
WIN32OLE_PARAM#output?が真)および、inout（クライアントからサーバ
へ与え、サーバがクライアントへ与える）の3種類の方向属性のいずれかを持ち
ます。

output?メソッドはout属性またはinout属性なら真を返します。

@return メソッドの方向属性がoutまたはinoutならば真を返します。

tobj = W...

• WIN32OLE_PARAM

WIN32OLE_TYPE#helpfile -> String | nil (9073.0)

• 2.3.0

• インスタンスメソッド

オブジェクトに関連付けられたヘルプファイルのフルパス名。

オブジェクトに関連付けられたヘルプファイルのフルパス名。

ここで返されたヘルプファイルを表示するには、
WIN32OLE#ole_show_helpメソッドを呼び出します。

オブジェクトがヘルプファイルを持たない場合はnilを返します。

@return オブジェクトに関連付けられたヘルプファイルのフルパス名を文字列で返します。
ヘルプファイルが未定義の場合はnilを返します。

tobj = WIN32OLE_TYPE.new('Microsoft Excel 14.0 Object Library', 'Worksheet')
puts tobj.helpf...

• WIN32OLE_TYPE

絞り込み条件を変える

WIN32OLE_TYPE#progid -> String | nil (9073.0)

• 2.3.0

• インスタンスメソッド

selfのPROGIDを取得します。

selfのPROGIDを取得します。

PROGIDは、生成可能なOLEオートメーションサーバのCoClass（コンポーネント
クラス）が持つレジストリ登録名です。WIN32OLE.newの引数に指定して
WIN32OLEオブジェクトを生成できます。

@return selfのPROGIDを文字列で返します。selfがPROGIDを持たない、または
CoClassでない場合はnilを返します。

tobj = WIN32OLE_TYPE.new('Microsoft Excel 14.0 Object Library', 'Application')
p tobj...

• WIN32OLE_TYPE

WIN32OLE_TYPE.progids -> [String] (9073.0)

• 2.3.0

• 特異メソッド

システムに登録されているすべてのコンポーネントクラスのPROGIDを取得します。

システムに登録されているすべてのコンポーネントクラスのPROGIDを取得します。

@return システムに登録されているすべてのコンポーネントクラスのPROGIDを
文字列配列で返します。

excel = nil
WIN32OLE_TYPE.progids.each do |pg|
if pg =~ /excel\.application/i # ExcelのPROGIDをバージョン無視で取り出す
excel = WIN32OLE.new(pg)
break
end
end
unless excel
$s...

• WIN32OLE_TYPE

WIN32OLE_VARIABLE#ole_type_detail -> [String] (9073.0)

• 2.3.0

• インスタンスメソッド

変数の型と属性を取得します。

変数の型と属性を取得します。

@return 変数の型と属性を文字列配列で返します。

tobj = WIN32OLE_TYPE.new('Microsoft XML, v5.0', 'tagSTATSTG')
tobj.variables.each do |v|
puts "#{v.ole_type} [#{v.ole_type_detail.join(', ')}] #{v.name}"
end

出力結果

Unknown Type 31 [] pwcsName # => VT_LPWSTR はWIN32OLE::VARIANTで未定義なので変換でき...

• WIN32OLE_VARIABLE

WIN32OLE::VARIANT (9055.0)

• 2.3.0

• モジュール

OLEオートメーション型を指定するための定数を定義したモジュールです。

OLEオートメーション型を指定するための定数を定義したモジュールです。

WIN32OLE::VARIANTは、WIN32OLE_VARIANTオブジェクトの作成時や、
WIN32OLE#_invokeなどのメソッド呼び出し時に、ユーザがRubyのオブジェ
クトの変換方法を指定するための定数を提供します。

これらの値は、COMの仕様で定義されたOLEオートメーション型と呼ばれる一連
の型を決定する定数です。ただし、一部、OLEオートメーション非互換の型も定
義されているため、利用時にはOLEオートメーション互換型のみを利用するよう
にしてください。

• WIN32OLE_VARIANT

WIN32OLE_EVENT.message_loop -> () (9055.0)

• 2.3.0

• 特異メソッド

Windowsのメッセージポンプを実行します。

Windowsのメッセージポンプを実行します。

message_loopメソッドは、Windowsメッセージがキューイングされている限りメッ
セージの読み出しとディスパッチを実行します。

COMのスレッド間/プロセス間通信はスレッド内で呼び出しをシリアライズする
ためにWindowsメッセージを利用します。このため、ほとんどのイベント処理は
Windowsメッセージを読み取ってディスパッチすることで通知されます。

ie = WIN32OLE.new('InternetExplorer.Application.1')
event = WIN32OLE_EVENT.new(ie, ...

• WIN32OLE_EVENT

絞り込み条件を変える