Hi all,
The Win32Utils Team is happy to announce the first release of win32-api.
= What is it?
This is a replacement for the Win32API library that currently ships with
the Ruby standard library.
= Quick Synopsis
require ‘win32/api’
include Win32
Typical stuff
buf = 0.chr * 260
len = [@buf.length].pack(‘L’)
GetUserName = API.new(‘GetUserName’, ‘PP’, ‘I’, ‘advapi32’)
GetUserName.call(buf, len)
puts buf.strip
Callback example
EnumWindows = API.new(‘EnumWindows’, ‘KP’, ‘L’, ‘user32’)
GetWindowText = API.new(‘GetWindowText’, ‘LPI’, ‘I’, ‘user32’)
EnumWindowsProc = API::Callback.new(‘LP’, ‘I’){ |handle, param|
buf = “\0” * 200
GetWindowText.call(handle, buf, 200);
puts buf.strip
buf.index(param).nil? ? true : false
}
EnumWindows.call(EnumWindowsProc, ‘UEDIT32’)
= What are the advantages over Win32API?
- Added callback support!
- Uses the Ruby 1.8.x allocation framework internally
- Now properly under the Win32 namespace
- Argument order change to the constructor that allows sensible defaults
- Better internal documentation
- It’s actually maintained
= How do I get it?
There are two gems. Use the “mswin32” gem to install a prebuilt binary
(built via VC++ 6). Use the “plain” gem to build from source if you have
a compiler installed.
Or, you can download the source directly from the RubyForge project page
at http://www.rubyforge.org/projects/win32utils.
Enjoy!
The Win32Utils Team