検索結果

win32ole (114361.0)

• 2.7.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.const_load(ole, mod = WIN32OLE) -> () (51466.0)

• 2.7.0

• 特異メソッド

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

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

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

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

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

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

@raise WIN32OLERunt...

• WIN32OLE

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

• 2.7.0

• インスタンスメソッド

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

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

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

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

ie = WIN32OLE.n...

• WIN32OLE

WIN32OLE.codepage -> Integer (51139.0)

• 2.7.0

• 特異メソッド

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

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

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

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

• WIN32OLE

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

• 2.7.0

• 定数

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

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

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

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

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

• WIN32OLE

絞り込み条件を変える

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

• 2.7.0

• インスタンスメソッド

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

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

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

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

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

• WIN32OLE

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

• 2.7.0

• インスタンスメソッド

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

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

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

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

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

• WIN32OLE

WIN32OLE (42283.0)

• 2.7.0

• クラス

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

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

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

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

WIN32OLE_VARIANT (42229.0)

• 2.7.0

• クラス

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

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

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

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

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

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

WIN32OLE_VARIABLE (42211.0)

• 2.7.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 (42175.0)

• 2.7.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_EVENT (42109.0)

• 2.7.0

• クラス

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

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

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

=== サンプルコード

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

WIN32OLE_TYPE#default_event_sources -> [WIN32OLE_TYPE] (33736.0)

• 2.7.0

• インスタンスメソッド

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

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

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

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

tobj = ...

• WIN32OLE_TYPE

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

• 2.7.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_TYPE.ole_classes(libname) -> [WIN32OLE_TYPE] (33430.0)

• 2.7.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 (33430.0)

• 2.7.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_EVENT.message_loop -> () (33109.0)

• 2.7.0

• 特異メソッド

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

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

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

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

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

• WIN32OLE_EVENT

WIN32OLE_VARIANT#value -> object (33103.0)

• 2.7.0

• インスタンスメソッド

値に対応するRubyオブジェクトを取得します。

値に対応するRubyオブジェクトを取得します。

@return 値に対応するRubyのオブジェクトを返します。

obj = WIN32OLE_VARIANT.new(1, WIN32OLE::VARIANT::VT_BSTR)
obj.value # => "1" (VT_BSTRを指定して生成したので、Stringオブジェクトとなる)

• WIN32OLE_VARIANT

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

• 2.7.0

• インスタンスメソッド

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

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

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

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

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

class IeHandler
def initialize
@com...

• WIN32OLE_EVENT

WIN32OLE_TYPE#helpfile -> String | nil (33091.0)

• 2.7.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::VARIANT (33073.0)

• 2.7.0

• モジュール

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

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

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

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

• WIN32OLE_VARIANT

WIN32OLE::VARIANT::VT_BSTR -> Integer (33055.0)

• 2.7.0

• 定数

文字列（BSTR）を示します（8）。

文字列（BSTR）を示します（8）。

OLEオートメーションのBSTRはUnicodeで表現された長さ付き文字列です。Ruby
のStringとBSTRの相互変換は、WIN32OLEがWIN32OLE#codepageに基づいて
自動的に行います。

• WIN32OLE::VARIANT

WIN32OLE_METHOD#invkind -> Integer (33055.0)

• 2.7.0

• インスタンスメソッド

メソッドの種類を示すINVOKEKIND列挙値を取得します。

メソッドの種類を示すINVOKEKIND列挙値を取得します。

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

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

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

INVOKE...

• WIN32OLE_METHOD

WIN32OLE_TYPE.typelibs -> [String] (33055.0)

• 2.7.0

• 特異メソッド

システムに登録されているすべてのTypeLibのドキュメント文字列を取得します。

システムに登録されているすべてのTypeLibのドキュメント文字列を取得します。

@return システムに登録されているすべてのTypeLibのドキュメント文字列の配
列を返します。

Ruby-1.9.1からは、すべてのTypeLibのドキュメント文字列を取得するには、
WIN32OLE_TYPELIBオブジェクトを利用して、以下のように記述してくだ
さい。

WIN32OLE_TYPELIB.typelibs.map {|t| t.name}

• WIN32OLE_TYPE
• WIN32OLE_TYPELIB

WIN32OLE::VARIANT::VT_DATE -> Integer (33037.0)

• 2.7.0

• 定数

日付型（DATE）を示します（7）。

日付型（DATE）を示します（7）。

OLEオートメーションのDATE型は、1899年12月30日0時00分からの日時を示す64
ビット浮動小数点数型です。

WIN32OLEは、RubyのTime型と自動的に変換します。

• WIN32OLE::VARIANT

絞り込み条件を変える

WIN32OLE_TYPELIB#path -> String (33037.0)

• 2.7.0

• インスタンスメソッド

TypeLibのパス名を取得します。

TypeLibのパス名を取得します。

@return TypeLibのパス名を文字列で返します。この値はレジストリの登録値を
そのまま利用するため、Rubyのパス名形式（ディレクトリ区切りは
「/」）ではなく、Windowsのパス名形式（ディレクトリ区切りは「\」）
です。
@raise WIN32OLERuntimeError TypeLibの属性が読み取れない場合に通知します。

tlib = WIN32OLE_TYPELIB.new('Microsoft Excel 14.0 Object Library')
puts tli...

• WIN32OLE_TYPELIB

WIN32OLE::VARIANT::VT_DISPATCH -> Integer (33019.0)

• 2.7.0

• 定数

OLEオートメーションオブジェクトを示します（9）。

OLEオートメーションオブジェクトを示します（9）。

RubyのオブジェクトをOLEオートメーションサーバへ与える場合に利用します。

• WIN32OLE::VARIANT

ruby 1.8.3 feature (11068.0)

• 2.7.0

• 文書

ruby 1.8.3 feature *((<ruby 1.8 feature>)) *((<ruby 1.8.2 feature>))

ruby 1.8.3 feature
*((<ruby 1.8 feature>))
*((<ruby 1.8.2 feature>))

ruby 1.8.2 から ruby 1.8.3 までの変更点です。

掲載方針

*バグ修正の影響も含めて動作が変わるものを収録する。
*単にバグを直しただけのものは収録しない。
*ライブラリへの単なる定数の追加は収録しない。

以下は各変更点に付けるべきタグです。

記号について(特に重要なものは大文字(主観))

* カテゴリ
* [ruby]: ruby インタプリタの変更
* [api]: 拡張ライブラリ API
* [lib]: ...

1.6.8から1.8.0への変更点(まとめ) (4231.0)

• 2.7.0

• 文書

1.6.8から1.8.0への変更点(まとめ) * ((<1.6.8から1.8.0への変更点(まとめ)/インタプリタの変更>)) * ((<1.6.8から1.8.0への変更点(まとめ)/追加されたクラス／モジュール>)) * ((<1.6.8から1.8.0への変更点(まとめ)/追加されたメソッド>)) * ((<1.6.8から1.8.0への変更点(まとめ)/追加された定数>)) * ((<1.6.8から1.8.0への変更点(まとめ)/拡張されたクラス／メソッド(互換性のある変更)>)) * ((<1.6.8から1.8.0への変更点(まとめ)/変更されたクラス／メソッド(互換性のない変更)>)) * ((<1.6.8から1.8.0への変更点(まとめ)/文法の変更>)) * ((<1.6.8から1.8.0への変更点(まとめ)/正規表現>)) * ((<1.6.8から1.8.0への変更点(まとめ)/Marshal>)) * ((<1.6.8から1.8.0への変更点(まとめ)/Windows 対応>)) * ((<1.6.8から1.8.0への変更点(まとめ)/廃止された(される予定の)機能>)) * ((<1.6.8から1.8.0への変更点(まとめ)/ライブラリ>)) * ((<1.6.8から1.8.0への変更点(まとめ)/拡張ライブラリAPI>)) * ((<1.6.8から1.8.0への変更点(まとめ)/バグ修正>)) * ((<1.6.8から1.8.0への変更点(まとめ)/サポートプラットフォームの追加>))

1.6.8から1.8.0への変更点(まとめ)
* ((<1.6.8から1.8.0への変更点(まとめ)/インタプリタの変更>))
* ((<1.6.8から1.8.0への変更点(まとめ)/追加されたクラス／モジュール>))
* ((<1.6.8から1.8.0への変更点(まとめ)/追加されたメソッド>))
* ((<1.6.8から1.8.0への変更点(まとめ)/追加された定数>))
* ((<1.6.8から1.8.0への変更点(まとめ)/拡張されたクラス／メソッド(互換性のある変更)>))
* ((<1.6.8から1.8.0への変更点(まとめ)/変更されたクラス／メソッド(互換性のない変更)>))...