windows_gui 3.0.2 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 95dd7c7c9ab71ebfc897b76fb2baa67be52d3f84
-  data.tar.gz: efff862e7a92f2d33ff138fdda7bd9ce760516f2
+  metadata.gz: d19698398bf2d86bdc449cf6e5874003e960081a
+  data.tar.gz: b45e14d18728307fff6a1019ef7099b2c08a0eb8
 SHA512:
-  metadata.gz: 1c4e85ee289451dd7e4aece5b74fe8aae151d7308064b932daa9b91d97790b9ae6b87a8277f387d04bc11602db72455fe69e4d820259e9749bd4348cd0c818ff
-  data.tar.gz: 13884d853f9d90a5a465f59d9e07e794286aba16989e680746dc86a96ecae0bcdfdfd55f2624917d71b91dc089f4668a55c68942a8452c64c7b91d77541dc529
+  metadata.gz: 0f0f8387b811b38de7ca7981985bd6e8aa66d717c2e1fc7d4dd3b955c7b20b77a90b83fb996c2d0ebab96a160f795ef16728e89aad912a9a35b7a2422053fd26
+  data.tar.gz: 9c99e81ab2b5b1fc96db84e85fa6e7ac821eb99d9dcc0870356ecb48a40f45f7053d2174a9de54c401df48f3276ba923112de90aa77e8269b65340894b2c3bca

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License
 
-Copyright (c) 2017 Radoslav Peev
+Copyright (c) 2017 Radoslav Peev <rpeev@ymail.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/RELNOTES.md

@@ -1,5 +1,9 @@
 # Release Notes
 
+## 4.0.0
+
+Improve code (move additional functionality from FFI bindings to external functions)
+
 ## 3.0.2
 
 Add recent Windows version info

data/examples/Command.rbw

@@ -37,7 +37,7 @@ def OnCreate(hwnd,
 		xtra[:haccel] = CreateAcceleratorTable(paccels, accels.count)
 	}
 
-	NONCLIENTMETRICS.new { |ncm|
+	UsingFFIStructs(NONCLIENTMETRICS.new) { |ncm|
 		ncm[:cbSize] = ncm.size
 
 		SystemParametersInfo(SPI_GETNONCLIENTMETRICS, ncm.size, ncm, 0);
@@ -204,7 +204,7 @@ end
 def WinMain
 	Id2RefTrack(xtra = WndExtra.new)
 
-	WNDCLASSEX.new { |wc|
+	UsingFFIStructs(WNDCLASSEX.new) { |wc|
 		wc[:cbSize] = wc.size
 		wc[:lpfnWndProc] = WindowProc
 		wc[:cbWndExtra] = FFI::Type::Builtin::POINTER.size
@@ -213,7 +213,7 @@ def WinMain
 		wc[:hCursor] = LoadCursor(nil, IDC_ARROW)
 		wc[:hbrBackground] = FFI::Pointer.new(COLOR_WINDOW + 1)
 
-		PWSTR(APPNAME) { |className|
+		UsingFFIMemoryPointers(PWSTR(APPNAME)) { |className|
 			wc[:lpszClassName] = className
 
 			DetonateLastError(0, :RegisterClassEx,
@@ -236,7 +236,7 @@ def WinMain
 	ShowWindow(hwnd, SW_SHOWNORMAL)
 	UpdateWindow(hwnd)
 
-	MSG.new { |msg|
+	UsingFFIStructs(MSG.new) { |msg|
 		until DetonateLastError(-1, :GetMessage,
 			msg, nil, 0, 0
 		) == 0

data/examples/HelloBulgarian.rbw

@@ -0,0 +1,11 @@
+# encoding: UTF-8
+
+require 'windows_gui'
+
+include WindowsGUI
+
+MessageBox(nil,
+	L('Здрасти, свят!'),
+	L('Здрасти'),
+	MB_ICONINFORMATION
+)

data/examples/Layered.rbw

@@ -44,7 +44,7 @@ end
 }
 
 def WinMain
-	WNDCLASSEX.new { |wc|
+	UsingFFIStructs(WNDCLASSEX.new) { |wc|
 		wc[:cbSize] = wc.size
 		wc[:lpfnWndProc] = WindowProc
 		wc[:hInstance] = GetModuleHandle(nil)
@@ -52,7 +52,7 @@ def WinMain
 		wc[:hCursor] = LoadCursor(nil, IDC_ARROW)
 		wc[:hbrBackground] = FFI::Pointer.new(COLOR_WINDOW + 1)
 
-		PWSTR(APPNAME) { |className|
+		UsingFFIMemoryPointers(PWSTR(APPNAME)) { |className|
 			wc[:lpszClassName] = className
 
 			DetonateLastError(0, :RegisterClassEx,
@@ -75,7 +75,7 @@ def WinMain
 	ShowWindow(hwnd, SW_SHOWNORMAL)
 	UpdateWindow(hwnd)
 
-	MSG.new { |msg|
+	UsingFFIStructs(MSG.new) { |msg|
 		until DetonateLastError(-1, :GetMessage,
 			msg, nil, 0, 0
 		) == 0

data/examples/LifeCycle.rbw

@@ -71,7 +71,7 @@ end
 }
 
 def WinMain
-	WNDCLASSEX.new { |wc|
+	UsingFFIStructs(WNDCLASSEX.new) { |wc|
 		wc[:cbSize] = wc.size
 		wc[:lpfnWndProc] = WindowProc
 		wc[:hInstance] = GetModuleHandle(nil)
@@ -79,7 +79,7 @@ def WinMain
 		wc[:hCursor] = LoadCursor(nil, IDC_ARROW)
 		wc[:hbrBackground] = FFI::Pointer.new(COLOR_WINDOW + 1)
 
-		PWSTR(APPNAME) { |className|
+		UsingFFIMemoryPointers(PWSTR(APPNAME)) { |className|
 			wc[:lpszClassName] = className
 
 			DetonateLastError(0, :RegisterClassEx,
@@ -102,7 +102,7 @@ def WinMain
 	ShowWindow(hwnd, SW_SHOWNORMAL)
 	UpdateWindow(hwnd)
 
-	MSG.new { |msg|
+	UsingFFIStructs(MSG.new) { |msg|
 		until DetonateLastError(-1, :GetMessage,
 			msg, nil, 0, 0
 		) == 0

data/examples/LifeCycleNC.rbw

@@ -101,7 +101,7 @@ end
 }
 
 def WinMain
-	WNDCLASSEX.new { |wc|
+	UsingFFIStructs(WNDCLASSEX.new) { |wc|
 		wc[:cbSize] = wc.size
 		wc[:lpfnWndProc] = WindowProc
 		wc[:hInstance] = GetModuleHandle(nil)
@@ -109,7 +109,7 @@ def WinMain
 		wc[:hCursor] = LoadCursor(nil, IDC_ARROW)
 		wc[:hbrBackground] = FFI::Pointer.new(COLOR_WINDOW + 1)
 
-		PWSTR(APPNAME) { |className|
+		UsingFFIMemoryPointers(PWSTR(APPNAME)) { |className|
 			wc[:lpszClassName] = className
 
 			DetonateLastError(0, :RegisterClassEx,
@@ -132,7 +132,7 @@ def WinMain
 	ShowWindow(hwnd, SW_SHOWNORMAL)
 	UpdateWindow(hwnd)
 
-	MSG.new { |msg|
+	UsingFFIStructs(MSG.new) { |msg|
 		until DetonateLastError(-1, :GetMessage,
 			msg, nil, 0, 0
 		) == 0

data/examples/Menu.rbw

@@ -221,7 +221,7 @@ end
 def WinMain
 	Id2RefTrack(xtra = WndExtra.new)
 
-	WNDCLASSEX.new { |wc|
+	UsingFFIStructs(WNDCLASSEX.new) { |wc|
 		wc[:cbSize] = wc.size
 		wc[:lpfnWndProc] = WindowProc
 		wc[:cbWndExtra] = FFI::Type::Builtin::POINTER.size
@@ -230,7 +230,7 @@ def WinMain
 		wc[:hCursor] = LoadCursor(nil, IDC_ARROW)
 		wc[:hbrBackground] = FFI::Pointer.new(COLOR_WINDOW + 1)
 
-		PWSTR(APPNAME) { |className|
+		UsingFFIMemoryPointers(PWSTR(APPNAME)) { |className|
 			wc[:lpszClassName] = className
 
 			DetonateLastError(0, :RegisterClassEx,
@@ -253,7 +253,7 @@ def WinMain
 	ShowWindow(hwnd, SW_SHOWNORMAL)
 	UpdateWindow(hwnd)
 
-	MSG.new { |msg|
+	UsingFFIStructs(MSG.new) { |msg|
 		until DetonateLastError(-1, :GetMessage,
 			msg, nil, 0, 0
 		) == 0

data/examples/MenuContext.rbw

@@ -105,7 +105,7 @@ end
 def WinMain
 	Id2RefTrack(xtra = WndExtra.new)
 
-	WNDCLASSEX.new { |wc|
+	UsingFFIStructs(WNDCLASSEX.new) { |wc|
 		wc[:cbSize] = wc.size
 		wc[:lpfnWndProc] = WindowProc
 		wc[:cbWndExtra] = FFI::Type::Builtin::POINTER.size
@@ -114,7 +114,7 @@ def WinMain
 		wc[:hCursor] = LoadCursor(nil, IDC_ARROW)
 		wc[:hbrBackground] = FFI::Pointer.new(COLOR_WINDOW + 1)
 
-		PWSTR(APPNAME) { |className|
+		UsingFFIMemoryPointers(PWSTR(APPNAME)) { |className|
 			wc[:lpszClassName] = className
 
 			DetonateLastError(0, :RegisterClassEx,
@@ -137,7 +137,7 @@ def WinMain
 	ShowWindow(hwnd, SW_SHOWNORMAL)
 	UpdateWindow(hwnd)
 
-	MSG.new { |msg|
+	UsingFFIStructs(MSG.new) { |msg|
 		until DetonateLastError(-1, :GetMessage,
 			msg, nil, 0, 0
 		) == 0

data/examples/MenuPARGB32.rbw

@@ -22,58 +22,56 @@ def OnCreate(hwnd,
 		LR_LOADFROMFILE | LR_CREATEDIBSECTION
 	)
 
-	info = MENUITEMINFO.new
+	UsingFFIStructs(MENUITEMINFO.new) { |mii|
+		mii[:cbSize] = mii.size
+		mii[:fMask] = MIIM_BITMAP
+		mii[:hbmpItem] = xtra[:hbmp]
 
-	info[:cbSize] = info.size
-	info[:fMask] = MIIM_BITMAP
-	info[:hbmpItem] = xtra[:hbmp]
+		hbar = CreateMenu()
+			hmenu1 = CreatePopupMenu()
+				AppendMenu(hmenu1, MF_STRING, CMD[:ITEM1], L('Item&1'))
+				SetMenuDefaultItem(hmenu1, CMD[:ITEM1], 0)
+				SetMenuItemInfo(hmenu1, CMD[:ITEM1], 0, mii)
 
-	hbar = CreateMenu()
-		hmenu1 = CreatePopupMenu()
-			AppendMenu(hmenu1, MF_STRING, CMD[:ITEM1], L('Item&1'))
-			SetMenuDefaultItem(hmenu1, CMD[:ITEM1], 0)
-			SetMenuItemInfo(hmenu1, CMD[:ITEM1], 0, info)
+				AppendMenu(hmenu1, MF_STRING | MF_GRAYED, CMD[:ITEM2], L('Item&2'))
+				SetMenuItemInfo(hmenu1, CMD[:ITEM2], 0, mii)
 
-			AppendMenu(hmenu1, MF_STRING | MF_GRAYED, CMD[:ITEM2], L('Item&2'))
-			SetMenuItemInfo(hmenu1, CMD[:ITEM2], 0, info)
+				AppendMenu(hmenu1, MF_STRING | MF_CHECKED, CMD[:ITEM3], L('Item&3'))
+				SetMenuItemInfo(hmenu1, CMD[:ITEM3], 0, mii)
 
-			AppendMenu(hmenu1, MF_STRING | MF_CHECKED, CMD[:ITEM3], L('Item&3'))
-			SetMenuItemInfo(hmenu1, CMD[:ITEM3], 0, info)
+				AppendMenu(hmenu1, MF_SEPARATOR, 0, nil)
 
-			AppendMenu(hmenu1, MF_SEPARATOR, 0, nil)
+				AppendMenu(hmenu1, MF_STRING | MF_CHECKED | MFT_RADIOCHECK,
+					CMD[:ITEM4], L('Item&4'))
+				SetMenuItemInfo(hmenu1, CMD[:ITEM4], 0, mii)
 
-			AppendMenu(hmenu1, MF_STRING | MF_CHECKED | MFT_RADIOCHECK,
-				CMD[:ITEM4], L('Item&4'))
-			SetMenuItemInfo(hmenu1, CMD[:ITEM4], 0, info)
+				AppendMenu(hmenu1, MF_STRING, CMD[:ITEM5], L('Item&5'))
+				SetMenuItemInfo(hmenu1, CMD[:ITEM5], 0, mii)
 
-			AppendMenu(hmenu1, MF_STRING, CMD[:ITEM5], L('Item&5'))
-			SetMenuItemInfo(hmenu1, CMD[:ITEM5], 0, info)
+				AppendMenu(hmenu1, MF_SEPARATOR, 0, nil)
 
-			AppendMenu(hmenu1, MF_SEPARATOR, 0, nil)
+				hmenu2 = CreatePopupMenu()
+					AppendMenu(hmenu2, MF_STRING | MF_CHECKED | MFT_RADIOCHECK,
+						CMD[:ITEM6], L('Item&6'))
+					SetMenuItemInfo(hmenu2, CMD[:ITEM6], 0, mii)
 
-			hmenu2 = CreatePopupMenu()
-				AppendMenu(hmenu2, MF_STRING | MF_CHECKED | MFT_RADIOCHECK,
-					CMD[:ITEM6], L('Item&6'))
-				SetMenuItemInfo(hmenu2, CMD[:ITEM6], 0, info)
+					AppendMenu(hmenu2, MF_STRING, CMD[:ITEM7], L('Item&7'))
+					SetMenuItemInfo(hmenu2, CMD[:ITEM7], 0, mii)
+				AppendMenu(hmenu1, MF_POPUP, hmenu2.to_i, L('Menu&2'))
+				SetMenuItemInfo(hmenu1, 7, MF_BYPOSITION, mii)
+			AppendMenu(hbar, MF_POPUP, hmenu1.to_i, L('Menu&1'))
+			SetMenuItemInfo(hbar, 0, MF_BYPOSITION, mii)
 
-				AppendMenu(hmenu2, MF_STRING, CMD[:ITEM7], L('Item&7'))
-				SetMenuItemInfo(hmenu2, CMD[:ITEM7], 0, info)
-			AppendMenu(hmenu1, MF_POPUP, hmenu2.to_i, L('Menu&2'))
-			SetMenuItemInfo(hmenu1, 7, MF_BYPOSITION, info)
-		AppendMenu(hbar, MF_POPUP, hmenu1.to_i, L('Menu&1'))
-		SetMenuItemInfo(hbar, 0, MF_BYPOSITION, info)
+			AppendMenu(hbar, MF_STRING, CMD[:ITEM8], L('Item&8!'))
+			SetMenuItemInfo(hbar, CMD[:ITEM8], 0, mii)
 
-		AppendMenu(hbar, MF_STRING, CMD[:ITEM8], L('Item&8!'))
-		SetMenuItemInfo(hbar, CMD[:ITEM8], 0, info)
-
-		hmenu3 = CreatePopupMenu()
-			AppendMenu(hmenu3, MF_BITMAP, CMD[:ITEM9], xtra[:hbmp])
-		AppendMenu(hbar, MF_POPUP | MF_BITMAP | MF_RIGHTJUSTIFY, hmenu3.to_i, xtra[:hbmp])
-	SetMenu(hwnd, hbar)
+			hmenu3 = CreatePopupMenu()
+				AppendMenu(hmenu3, MF_BITMAP, CMD[:ITEM9], xtra[:hbmp])
+			AppendMenu(hbar, MF_POPUP | MF_BITMAP | MF_RIGHTJUSTIFY, hmenu3.to_i, xtra[:hbmp])
+		SetMenu(hwnd, hbar)
+	}
 
 	0
-ensure
-	info.pointer.free if info
 end
 
 def OnDestroy(hwnd)
@@ -255,7 +253,7 @@ end
 def WinMain
 	Id2RefTrack(xtra = WndExtra.new)
 
-	WNDCLASSEX.new { |wc|
+	UsingFFIStructs(WNDCLASSEX.new) { |wc|
 		wc[:cbSize] = wc.size
 		wc[:lpfnWndProc] = WindowProc
 		wc[:cbWndExtra] = FFI::Type::Builtin::POINTER.size
@@ -264,7 +262,7 @@ def WinMain
 		wc[:hCursor] = LoadCursor(nil, IDC_ARROW)
 		wc[:hbrBackground] = FFI::Pointer.new(COLOR_WINDOW + 1)
 
-		PWSTR(APPNAME) { |className|
+		UsingFFIMemoryPointers(PWSTR(APPNAME)) { |className|
 			wc[:lpszClassName] = className
 
 			DetonateLastError(0, :RegisterClassEx,
@@ -287,7 +285,7 @@ def WinMain
 	ShowWindow(hwnd, SW_SHOWNORMAL)
 	UpdateWindow(hwnd)
 
-	MSG.new { |msg|
+	UsingFFIStructs(MSG.new) { |msg|
 		until DetonateLastError(-1, :GetMessage,
 			msg, nil, 0, 0
 		) == 0

data/examples/MinMax.rbw

@@ -46,7 +46,7 @@ end
 }
 
 def WinMain
-	WNDCLASSEX.new { |wc|
+	UsingFFIStructs(WNDCLASSEX.new) { |wc|
 		wc[:cbSize] = wc.size
 		wc[:lpfnWndProc] = WindowProc
 		wc[:hInstance] = GetModuleHandle(nil)
@@ -54,7 +54,7 @@ def WinMain
 		wc[:hCursor] = LoadCursor(nil, IDC_ARROW)
 		wc[:hbrBackground] = FFI::Pointer.new(COLOR_WINDOW + 1)
 
-		PWSTR(APPNAME) { |className|
+		UsingFFIMemoryPointers(PWSTR(APPNAME)) { |className|
 			wc[:lpszClassName] = className
 
 			DetonateLastError(0, :RegisterClassEx,
@@ -77,7 +77,7 @@ def WinMain
 	ShowWindow(hwnd, SW_SHOWNORMAL)
 	UpdateWindow(hwnd)
 
-	MSG.new { |msg|
+	UsingFFIStructs(MSG.new) { |msg|
 		until DetonateLastError(-1, :GetMessage,
 			msg, nil, 0, 0
 		) == 0

data/examples/Minimal.rbw

@@ -34,7 +34,7 @@ end
 }
 
 def WinMain
-	WNDCLASSEX.new { |wc|
+	UsingFFIStructs(WNDCLASSEX.new) { |wc|
 		wc[:cbSize] = wc.size
 		wc[:lpfnWndProc] = WindowProc
 		wc[:hInstance] = GetModuleHandle(nil)
@@ -42,7 +42,7 @@ def WinMain
 		wc[:hCursor] = LoadCursor(nil, IDC_ARROW)
 		wc[:hbrBackground] = FFI::Pointer.new(COLOR_WINDOW + 1)
 
-		PWSTR(APPNAME) { |className|
+		UsingFFIMemoryPointers(PWSTR(APPNAME)) { |className|
 			wc[:lpszClassName] = className
 
 			DetonateLastError(0, :RegisterClassEx,
@@ -65,7 +65,7 @@ def WinMain
 	ShowWindow(hwnd, SW_SHOWNORMAL)
 	UpdateWindow(hwnd)
 
-	MSG.new { |msg|
+	UsingFFIStructs(MSG.new) { |msg|
 		until DetonateLastError(-1, :GetMessage,
 			msg, nil, 0, 0
 		) == 0

data/examples/Paint.rbw

@@ -11,7 +11,7 @@ def OnCreate(hwnd,
 )
 	xtra = Id2Ref[GetWindowLong(hwnd, GWL_USERDATA)]
 
-	LOGFONT.new { |lf|
+	UsingFFIStructs(LOGFONT.new) { |lf|
 		lf[:lfHeight] = DPIAwareFontHeight(16)
 		lf[:lfItalic] = 1
 		lf[:lfFaceName].to_ptr.put_bytes(0, L('Verdana'))
@@ -38,8 +38,8 @@ def OnPaint(hwnd,
 	SetBkColor(ps[:hdc], RGB(255, 0, 0))
 	SetTextColor(ps[:hdc], RGB(255, 255, 255))
 
-	UseObjects(ps[:hdc], xtra[:hfont]) {
-		RECT.new { |rect|
+	UsingGDIObjects(ps[:hdc], xtra[:hfont]) {
+		UsingFFIStructs(RECT.new) { |rect|
 			GetClientRect(hwnd, rect)
 
 			DrawText(ps[:hdc],
@@ -98,7 +98,7 @@ end
 def WinMain
 	Id2RefTrack(xtra = WndExtra.new)
 
-	WNDCLASSEX.new { |wc|
+	UsingFFIStructs(WNDCLASSEX.new) { |wc|
 		wc[:cbSize] = wc.size
 		wc[:style] = CS_HREDRAW | CS_VREDRAW
 		wc[:lpfnWndProc] = WindowProc
@@ -108,7 +108,7 @@ def WinMain
 		wc[:hCursor] = LoadCursor(nil, IDC_ARROW)
 		wc[:hbrBackground] = FFI::Pointer.new(COLOR_WINDOW + 1)
 
-		PWSTR(APPNAME) { |className|
+		UsingFFIMemoryPointers(PWSTR(APPNAME)) { |className|
 			wc[:lpszClassName] = className
 
 			DetonateLastError(0, :RegisterClassEx,
@@ -130,7 +130,7 @@ def WinMain
 
 	AnimateWindow(hwnd, 1000, AW_ACTIVATE | AW_BLEND)
 
-	MSG.new { |msg|
+	UsingFFIStructs(MSG.new) { |msg|
 		until DetonateLastError(-1, :GetMessage,
 			msg, nil, 0, 0
 		) == 0

data/examples/Region.rbw

@@ -47,7 +47,7 @@ end
 }
 
 def WinMain
-	WNDCLASSEX.new { |wc|
+	UsingFFIStructs(WNDCLASSEX.new) { |wc|
 		wc[:cbSize] = wc.size
 		wc[:lpfnWndProc] = WindowProc
 		wc[:hInstance] = GetModuleHandle(nil)
@@ -55,7 +55,7 @@ def WinMain
 		wc[:hCursor] = LoadCursor(nil, IDC_ARROW)
 		wc[:hbrBackground] = FFI::Pointer.new(COLOR_APPWORKSPACE + 1)
 
-		PWSTR(APPNAME) { |className|
+		UsingFFIMemoryPointers(PWSTR(APPNAME)) { |className|
 			wc[:lpszClassName] = className
 
 			DetonateLastError(0, :RegisterClassEx,
@@ -78,7 +78,7 @@ def WinMain
 	ShowWindow(hwnd, SW_SHOWNORMAL)
 	UpdateWindow(hwnd)
 
-	MSG.new { |msg|
+	UsingFFIStructs(MSG.new) { |msg|
 		until DetonateLastError(-1, :GetMessage,
 			msg, nil, 0, 0
 		) == 0

data/examples/WndExtra.rbw

@@ -69,7 +69,7 @@ end
 def WinMain
 	Id2RefTrack(xtra = WndExtra.new)
 
-	WNDCLASSEX.new { |wc|
+	UsingFFIStructs(WNDCLASSEX.new) { |wc|
 		wc[:cbSize] = wc.size
 		wc[:lpfnWndProc] = WindowProc
 		wc[:cbWndExtra] = FFI::Type::Builtin::POINTER.size
@@ -78,7 +78,7 @@ def WinMain
 		wc[:hCursor] = LoadCursor(nil, IDC_ARROW)
 		wc[:hbrBackground] = FFI::Pointer.new(COLOR_WINDOW + 1)
 
-		PWSTR(APPNAME) { |className|
+		UsingFFIMemoryPointers(PWSTR(APPNAME)) { |className|
 			wc[:lpszClassName] = className
 
 			DetonateLastError(0, :RegisterClassEx,
@@ -101,7 +101,7 @@ def WinMain
 	ShowWindow(hwnd, SW_SHOWNORMAL)
 	UpdateWindow(hwnd)
 
-	MSG.new { |msg|
+	UsingFFIStructs(MSG.new) { |msg|
 		until DetonateLastError(-1, :GetMessage,
 			msg, nil, 0, 0
 		) == 0

data/lib/windows_gui.rb

@@ -1,3 +1,4 @@
+require_relative 'windows_gui/common'
 require_relative 'windows_gui/libc'
 require_relative 'windows_gui/kernel'
 require_relative 'windows_gui/gdi'

data/lib/windows_gui/common.rb

@@ -1,7 +1,7 @@
 require 'weakref'
 require 'ffi'
 
-WINDOWS_GUI_VERSION = '3.0.2'
+WINDOWS_GUI_VERSION = '4.0.0'
 
 WINDOWS_GUI_VISUAL_STYLES = true unless defined?(WINDOWS_GUI_VISUAL_STYLES)
 WINDOWS_GUI_DPI_AWARE = true unless defined?(WINDOWS_GUI_DPI_AWARE)
@@ -17,45 +17,73 @@ module WindowsGUI
 		str
 	end
 
-	module_function :FormatException
-
 	Id2Ref = {}
 
-	def Id2RefTrack(object)
-		Id2Ref[object.object_id] = WeakRef.new(object)
+	def Id2RefTrack(obj)
+		Id2Ref[oid = obj.object_id] = WeakRef.new(obj)
 
-		p "Object id #{object.object_id} of #{object} stored in Id2Ref track hash" if $DEBUG
+		STDERR.puts "Object id #{oid} of #{obj} stored in Id2Ref track hash" if $DEBUG
 
-		ObjectSpace.define_finalizer(object, -> id {
+		ObjectSpace.define_finalizer(obj, -> id {
 			Id2Ref.delete(id)
 
-			p "Object id #{id} deleted from Id2Ref track hash" if $DEBUG
+			STDERR.puts "Object id #{id} deleted from Id2Ref track hash" if $DEBUG
 		})
+
+		oid
+	end
+
+	def UsingFFIStructs(*structs)
+		yield(*structs)
+	ensure
+		structs.each { |struct|
+			struct.pointer.free
+
+			STDERR.puts "#{struct} freed" if $DEBUG
+		}
 	end
 
-	module_function :Id2RefTrack
+	def UsingFFIMemoryPointers(*ptrs)
+		yield(*ptrs)
+	ensure
+		ptrs.each { |ptr|
+			ptr.free
 
-	module AutoFFIStructClassSupport
-		def new(*args)
-			raise ArgumentError, 'Cannot accept both arguments and a block' if
-				args.length > 0 && block_given?
+			STDERR.puts "#{ptr} freed" if $DEBUG
+		}
+	end
 
-			struct = super
+	def Detonate(on, name, *args)
+		result = send(name, *args)
+		failed = [*on].include?(result)
 
-			return struct unless block_given?
+		raise "#{name} failed (result: #{result})" if failed
 
-			begin
-				yield struct
-			ensure
-				struct.pointer.free
+		result
+	ensure
+		yield result if failed && block_given?
+	end
 
-				p "Native memory for #{struct} freed" if $DEBUG
-			end
+	def DetonateLastError(on, name, *args)
+		result = send(name, *args)
+		failed = [*on].include?(result)
+		last_error = 0
 
-			nil
-		end
+		raise "#{name} failed (last error: #{last_error = GetLastError()})" if failed
+
+		result
+	ensure
+		yield result, last_error if failed && block_given?
 	end
 
+	module_function \
+		:FormatException,
+		:Id2RefTrack,
+		:UsingFFIStructs,
+		:UsingFFIMemoryPointers,
+		:Detonate,
+		:DetonateLastError
+
 	INVALID_HANDLE_VALUE = FFI::Pointer.new(-1)
 
 	def MAKEWORD(lobyte, hibyte)
@@ -70,8 +98,6 @@ module WindowsGUI
 		(word >> 8) & 0xff
 	end
 
-	module_function :MAKEWORD, :LOBYTE, :HIBYTE
-
 	def MAKELONG(loword, hiword)
 		(loword & 0xffff) | ((hiword & 0xffff) << 16)
 	end
@@ -92,7 +118,15 @@ module WindowsGUI
 		((hishort = HIWORD(long)) > 0x7fff) ? hishort - 0x1_0000 : hishort
 	end
 
-	module_function :MAKELONG, :LOWORD, :HIWORD, :LOSHORT, :HISHORT
+	module_function \
+		:MAKEWORD,
+		:LOBYTE,
+		:HIBYTE,
+		:MAKELONG,
+		:LOWORD,
+		:HIWORD,
+		:LOSHORT,
+		:HISHORT
 
 	def L(str)
 		(str << "\0").encode!('utf-16le')
@@ -102,45 +136,29 @@ module WindowsGUI
 		raise 'Invalid Unicode string' unless
 			wstr.encoding == Encoding::UTF_16LE && wstr[-1] == L('')
 
-		ptr = FFI::MemoryPointer.new(:ushort, wstr.length).
+		FFI::MemoryPointer.new(:ushort, wstr.length).
 			put_bytes(0, wstr)
-
-		return ptr unless block_given?
-
-		begin
-			yield ptr
-		ensure
-			ptr.free
-
-			p "Native copy of '#{wstr[0...-1].encode($0.encoding)}' freed" if $DEBUG
-		end
-
-		nil
 	end
 
-	module_function :L, :PWSTR
+	module_function \
+		:L,
+		:PWSTR
 
 	APPNAME = L(File.basename($0, '.rbw'))
 
 	class POINT < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:x, :long,
 			:y, :long
 	end
 
 	class SIZE < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:cx, :long,
 			:cy, :long
 	end
 
 	class RECT < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:left, :long,
 			:top, :long,

data/lib/windows_gui/gdi.rb

@@ -1,5 +1,6 @@
-require_relative 'common'
 if __FILE__ == $0
+	require_relative 'common'
+	require_relative 'libc'
 	require_relative 'kernel'
 end
 
@@ -25,7 +26,11 @@ module WindowsGUI
 		LOBYTE(rgb >> 16)
 	end
 
-	module_function :RGB, :GetRValue, :GetGValue, :GetBValue
+	module_function \
+		:RGB,
+		:GetRValue,
+		:GetGValue,
+		:GetBValue
 
 	attach_function :CreateCompatibleDC, [
 		:pointer
@@ -53,7 +58,8 @@ module WindowsGUI
 		-MulDiv(pointSize, DPIY, 72)
 	end
 
-	module_function :DPIAwareFontHeight
+	module_function \
+		:DPIAwareFontHeight
 
 	FW_DONTCARE = 0
 	FW_THIN = 100
@@ -102,8 +108,6 @@ module WindowsGUI
 	FF_DECORATIVE = 5 << 4
 
 	class LOGFONT < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:lfHeight, :long,
 			:lfWidth, :long,
@@ -143,8 +147,6 @@ module WindowsGUI
 	HS_DIAGCROSS = 5
 
 	class LOGBRUSH < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:lbStyle, :uint,
 			:lbColor, :ulong,
@@ -177,8 +179,6 @@ module WindowsGUI
 	PS_JOIN_ROUND = 0x0000_0000
 
 	class LOGPEN < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:lopnStyle, :uint,
 			:lopnWidth, POINT,
@@ -367,7 +367,7 @@ module WindowsGUI
 		:pointer
 	], :pointer
 
-	def UseObjects(hdc, *hgdiobjs)
+	def UsingGDIObjects(hdc, *hgdiobjs)
 		holds = []
 
 		hgdiobjs.each { |hgdiobj|
@@ -376,14 +376,15 @@ module WindowsGUI
 			)
 		}
 
-		yield
+		yield(*hgdiobjs)
 	ensure
 		holds.each { |hgdiobj|
 			SelectObject(hdc, hgdiobj)
 		}
 	end
 
-	module_function :UseObjects
+	module_function \
+		:UsingGDIObjects
 
 	AD_COUNTERCLOCKWISE = 1
 	AD_CLOCKWISE = 2

data/lib/windows_gui/kernel.rb

@@ -1,4 +1,7 @@
-require_relative 'common'
+if __FILE__ == $0
+	require_relative 'common'
+	require_relative 'libc'
+end
 
 module WindowsGUI
 	ffi_lib 'kernel32'
@@ -12,29 +15,7 @@ module WindowsGUI
 
 	], :ulong
 
-	def Detonate(on, name, *args)
-		raise "#{name} failed" if
-			(failed = [*on].include?(result = send(name, *args)))
-
-		result
-	ensure
-		yield failed if block_given?
-	end
-
-	def DetonateLastError(on, name, *args)
-		raise "#{name} failed (last error: #{GetLastError()})" if
-			(failed = [*on].include?(result = send(name, *args)))
-
-		result
-	ensure
-		yield failed if block_given?
-	end
-
-	module_function :Detonate, :DetonateLastError
-
 	class OSVERSIONINFOEX < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:dwOSVersionInfoSize, :ulong,
 			:dwMajorVersion, :ulong,
@@ -53,15 +34,14 @@ module WindowsGUI
 		OSVERSIONINFOEX.by_ref
 	], :int
 
-	OSVERSION = OSVERSIONINFOEX.new.tap { |ovi|
-		at_exit { OSVERSION.pointer.free }
+	OSVERSION = OSVERSIONINFOEX.new
 
-		ovi[:dwOSVersionInfoSize] = ovi.size
+	at_exit { OSVERSION.pointer.free }
 
-		DetonateLastError(0, :GetVersionEx,
-			ovi
-		)
-	}
+	OSVERSION[:dwOSVersionInfoSize] = OSVERSION.size
+	DetonateLastError(0, :GetVersionEx,
+		OSVERSION
+	)
 
 	NTDDI_WIN2K = 0x0500_0000
 
@@ -144,7 +124,8 @@ module WindowsGUI
 			) == IDNO
 	end
 
-	module_function :TARGETVER
+	module_function \
+		:TARGETVER
 
 	attach_function :GetModuleHandle, :GetModuleHandleW, [
 		:buffer_in
@@ -160,8 +141,6 @@ module WindowsGUI
 
 	if WINVER >= WINXP
 		class ACTCTX < FFI::Struct
-			extend AutoFFIStructClassSupport
-
 			layout \
 				:cbSize, :ulong,
 				:dwFlags, :ulong,
@@ -205,13 +184,14 @@ module WindowsGUI
 			ReleaseActCtx(COMMON_CONTROLS_ACTCTX[:handle]) unless
 				COMMON_CONTROLS_ACTCTX[:handle] == INVALID_HANDLE_VALUE
 
-			COMMON_CONTROLS_ACTCTX[:cookie].free
+			COMMON_CONTROLS_ACTCTX[:cookie].free unless
+				COMMON_CONTROLS_ACTCTX[:cookie] == FFI::Pointer::NULL
 
 			COMMON_CONTROLS_ACTCTX[:handle] = INVALID_HANDLE_VALUE
-			COMMON_CONTROLS_ACTCTX[:cookie] = 0
+			COMMON_CONTROLS_ACTCTX[:cookie] = FFI::Pointer::NULL
 			COMMON_CONTROLS_ACTCTX[:activated] = false
 
-			p "Visual styles cleanup, COMMON_CONTROLS_ACTCTX is #{COMMON_CONTROLS_ACTCTX}" if $DEBUG
+			STDERR.puts "Visual styles cleanup (COMMON_CONTROLS_ACTCTX: #{COMMON_CONTROLS_ACTCTX})" if $DEBUG
 		}
 	end
 
@@ -243,10 +223,10 @@ module WindowsGUI
 			XML
 		}
 
-		ACTCTX.new { |ac|
+		UsingFFIStructs(ACTCTX.new) { |ac|
 			ac[:cbSize] = ac.size
 
-			PWSTR(L(manifest)) { |source|
+			UsingFFIMemoryPointers(PWSTR(L(manifest))) { |source|
 				ac[:lpSource] = source
 
 				COMMON_CONTROLS_ACTCTX[:handle] =
@@ -258,19 +238,18 @@ module WindowsGUI
 
 		DetonateLastError(0, :ActivateActCtx,
 			COMMON_CONTROLS_ACTCTX[:handle], COMMON_CONTROLS_ACTCTX[:cookie]
-		) { |failed|
-			next unless failed
-
+		) {
 			ReleaseActCtx(COMMON_CONTROLS_ACTCTX[:handle])
 			COMMON_CONTROLS_ACTCTX[:handle] = INVALID_HANDLE_VALUE
 		}
 
 		COMMON_CONTROLS_ACTCTX[:activated] = true
 
-		p "Visual styles init, COMMON_CONTROLS_ACTCTX is #{COMMON_CONTROLS_ACTCTX}" if $DEBUG
+		STDERR.puts "Visual styles init (COMMON_CONTROLS_ACTCTX: #{COMMON_CONTROLS_ACTCTX})" if $DEBUG
 	end
 
-	module_function :EnableVisualStyles
+	module_function \
+		:EnableVisualStyles
 
 	EnableVisualStyles() if WINDOWS_GUI_VISUAL_STYLES
 

data/lib/windows_gui/libc.rb

@@ -1,4 +1,6 @@
-require_relative 'common'
+if __FILE__ == $0
+	require_relative 'common'
+end
 
 module WindowsGUI
 	ffi_lib FFI::Library::LIBC
@@ -6,5 +8,5 @@ module WindowsGUI
 
 	attach_function :windows_gui_wcslen, :wcslen, [
 		:buffer_in
-	], :uint
+	], :size_t
 end

data/lib/windows_gui/user.rb

@@ -1,5 +1,6 @@
-require_relative 'common'
 if __FILE__ == $0
+	require_relative 'common'
+	require_relative 'libc'
 	require_relative 'kernel'
 	require_relative 'gdi'
 end
@@ -72,7 +73,8 @@ module WindowsGUI
 			rect[:top] > rect[:bottom]
 	end
 
-	module_function :NormalizeRect
+	module_function \
+		:NormalizeRect
 
 	attach_function :DrawFocusRect, [
 		:pointer,
@@ -131,10 +133,21 @@ module WindowsGUI
 		attach_function :SetProcessDPIAware, [
 
 		], :int
+	end
+
+	def DeclareDPIAware
+		return unless WINVER >= WINVISTA
 
-		Detonate(0, :SetProcessDPIAware) if WINDOWS_GUI_DPI_AWARE
+		Detonate(0, :SetProcessDPIAware)
+
+		STDERR.puts "DPI aware init"
 	end
 
+	module_function \
+		:DeclareDPIAware
+
+	DeclareDPIAware() if WINDOWS_GUI_DPI_AWARE
+
 	attach_function :GetWindowDC, [
 		:pointer
 	], :pointer
@@ -148,7 +161,7 @@ module WindowsGUI
 		:pointer
 	], :int
 
-	def UseWindowDC(hwnd)
+	def UsingWindowDC(hwnd)
 		hdc = DetonateLastError(FFI::Pointer::NULL, :GetWindowDC,
 			hwnd
 		)
@@ -160,7 +173,7 @@ module WindowsGUI
 		end
 	end
 
-	def UseDC(hwnd)
+	def UsingDC(hwnd)
 		hdc = DetonateLastError(FFI::Pointer::NULL, :GetDC,
 			hwnd
 		)
@@ -172,9 +185,11 @@ module WindowsGUI
 		end
 	end
 
-	module_function :UseWindowDC, :UseDC
+	module_function \
+		:UsingWindowDC,
+		:UsingDC
 
-	UseDC(nil) { |hdc|
+	UsingDC(nil) { |hdc|
 		DPIX = GetDeviceCaps(hdc, LOGPIXELSX)
 		DPIY = GetDeviceCaps(hdc, LOGPIXELSY)
 	}
@@ -196,7 +211,10 @@ module WindowsGUI
 		}
 	end
 
-	module_function :DPIAwareX, :DPIAwareY, :DPIAwareXY
+	module_function \
+		:DPIAwareX,
+		:DPIAwareY,
+		:DPIAwareXY
 
 	SM_CXSCREEN = 0
 	SM_CYSCREEN = 1
@@ -206,8 +224,6 @@ module WindowsGUI
 	], :int
 
 	class NONCLIENTMETRICS < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout(*[
 			:cbSize, :uint,
 			:iBorderWidth, :int,
@@ -461,8 +477,6 @@ module WindowsGUI
 	COLOR_MENU = 4
 
 	class WNDCLASSEX < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:cbSize, :uint,
 			:style, :uint,
@@ -625,8 +639,6 @@ module WindowsGUI
 	], :pointer
 
 	class DLGTEMPLATE < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:style, :ulong,
 			:dwExtendedStyle, :ulong,
@@ -921,8 +933,6 @@ module WindowsGUI
 	SIF_DISABLENOSCROLL = 0x0008
 
 	class SCROLLINFO < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:cbSize, :uint,
 			:fMask, :uint,
@@ -1029,8 +1039,6 @@ module WindowsGUI
 	], :int
 
 	class PAINTSTRUCT < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:hdc, :pointer,
 			:fErase, :int,
@@ -1053,7 +1061,7 @@ module WindowsGUI
 	def DoPaint(hwnd)
 		return unless GetUpdateRect(hwnd, nil, 0) != 0
 
-		PAINTSTRUCT.new { |ps|
+		UsingFFIStructs(PAINTSTRUCT.new) { |ps|
 			DetonateLastError(FFI::Pointer::NULL, :BeginPaint,
 				hwnd, ps
 			)
@@ -1067,7 +1075,7 @@ module WindowsGUI
 	end
 
 	def DoPrintClient(hwnd, wParam)
-		PAINTSTRUCT.new { |ps|
+		UsingFFIStructs(PAINTSTRUCT.new) { |ps|
 			ps[:hdc] = FFI::Pointer.new(wParam)
 			ps[:fErase] = 1
 			GetClientRect(hwnd, ps[:rcPaint])
@@ -1076,7 +1084,9 @@ module WindowsGUI
 		}
 	end
 
-	module_function :DoPaint, :DoPrintClient
+	module_function \
+		:DoPaint,
+		:DoPrintClient
 
 	attach_function :SetCapture, [
 		:pointer
@@ -1136,8 +1146,6 @@ module WindowsGUI
 	MOUSEEVENTF_VIRTUALDESK = 0x4000
 
 	class MOUSEINPUT < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:dx, :long,
 			:dy, :long,
@@ -1153,8 +1161,6 @@ module WindowsGUI
 	KEYEVENTF_UNICODE = 0x0004
 
 	class KEYBDINPUT < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:wVk, :ushort,
 			:wScan, :ushort,
@@ -1164,8 +1170,6 @@ module WindowsGUI
 	end
 
 	class HARDWAREINPUT < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:uMsg, :ulong,
 			:wParamL, :ushort,
@@ -1173,8 +1177,6 @@ module WindowsGUI
 	end
 
 	class INPUT < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:type, :ulong,
 
@@ -1234,8 +1236,6 @@ module WindowsGUI
 	HWND_BROADCAST = FFI::Pointer.new(0xffff)
 
 	class CREATESTRUCT < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:lpCreateParams, :pointer,
 			:hInstance, :pointer,
@@ -1270,8 +1270,6 @@ module WindowsGUI
 	WM_ENDSESSION = 0x0016
 
 	class STYLESTRUCT < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:styleOld, :ulong,
 			:styleNew, :ulong
@@ -1299,8 +1297,6 @@ module WindowsGUI
 	WM_SHOWWINDOW = 0x0018
 
 	class MINMAXINFO < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:ptReserved, POINT,
 			:ptMaxSize, POINT,
@@ -1312,8 +1308,6 @@ module WindowsGUI
 	WM_GETMINMAXINFO = 0x0024
 
 	class WINDOWPOS < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:hwnd, :pointer,
 			:hwndInsertAfter, :pointer,
@@ -1518,8 +1512,6 @@ module WindowsGUI
 	WM_COMMAND = 0x0111
 
 	class NMHDR < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:hwndFrom, :pointer,
 			:idFrom, :uint,
@@ -1540,8 +1532,6 @@ module WindowsGUI
 	WM_CHARTOITEM = 0x002f
 
 	class DELETEITEMSTRUCT < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:CtlType, :uint,
 			:CtlID, :uint,
@@ -1553,8 +1543,6 @@ module WindowsGUI
 	WM_DELETEITEM = 0x002d
 
 	class COMPAREITEMSTRUCT < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:CtlType, :uint,
 			:CtlID, :uint,
@@ -1577,8 +1565,6 @@ module WindowsGUI
 	ODT_COMBOBOX = 3
 
 	class MEASUREITEMSTRUCT < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:CtlType, :uint,
 			:CtlID, :uint,
@@ -1610,8 +1596,6 @@ module WindowsGUI
 	ODS_COMBOBOXEDIT = 0x1000
 
 	class DRAWITEMSTRUCT < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:CtlType, :uint,
 			:CtlID, :uint,
@@ -1672,8 +1656,6 @@ module WindowsGUI
 	], :void
 
 	class MSG < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:hwnd, :pointer,
 			:message, :uint,
@@ -1862,8 +1844,6 @@ module WindowsGUI
 	MIIM_BITMAP = 0x0000_0080
 
 	class MENUITEMINFO < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:cbSize, :uint,
 			:fMask, :uint,
@@ -2022,8 +2002,6 @@ module WindowsGUI
 	VK_VOLUME_DOWN = 0xae
 
 	class ACCEL < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:fVirt, :uchar,
 			:key, :ushort,
@@ -2401,8 +2379,6 @@ module WindowsGUI
 	CBS_NOINTEGRALHEIGHT = 0x0400
 
 	class COMBOBOXINFO < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:cbSize, :ulong,
 			:rcItem, RECT,
@@ -2530,8 +2506,6 @@ module WindowsGUI
 	OBJID_CLIENT = 0xffff_fffc - 0x1_0000_0000
 
 	class SCROLLBARINFO < FFI::Struct
-		extend AutoFFIStructClassSupport
-
 		layout \
 			:cbSize, :ulong,
 			:rcScrollBar, RECT,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: windows_gui
 version: !ruby/object:Gem::Version
-  version: 3.0.2
+  version: 4.0.0
 platform: ruby
 authors:
 - Radoslav Peev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-01-22 00:00:00.000000000 Z
+date: 2017-01-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -36,6 +36,7 @@ files:
 - RELNOTES.md
 - examples/Command.rbw
 - examples/Hello.rbw
+- examples/HelloBulgarian.rbw
 - examples/HelloOptout.rbw
 - examples/HelloTimeout.rbw
 - examples/Layered.rbw