详情

首页手游攻略 借助RubyGnome2库进行GTK下的Ruby GUI编程的基本做法实用指南

借助RubyGnome2库进行GTK下的Ruby GUI编程的基本做法实用指南

佚名 2026-09-04 18:10:01

平时做技术实践时,很多问题不是概念不会,而是细节没串起来。拿“借助RubyGnome2库进行GTK下的Ruby GUI编程的基本做法”来说,它看着像小点,放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序,把思路、关键写法和容易踩坑的地方讲清楚,便于大家直接对照操作。

前言
在这个场景下,随着RubyGnome2库越来越完善,以及ruby1.9的性能提升,用Ruby编写GUI程序渐渐从我的业余爱好转为我工作的一个重要部分。

实际处理时,用Ruby写程序确实很有乐趣,它能够让你的想法更快地以一种优雅的方式实现。这里主要介绍的一个gem就是一个例子,用很少的代码,实现很有趣的功能,让编写Ruby GUI程序变得轻松愉快。

RubyGnome2介绍

从实现思路看,虽然我以前也曾经多次地介绍过RubyGnome2,但我还是想再一次地建议RubyGnome2,它实在是采用Ruby编写GUI程序的首选。

结合项目来看,RubyGnome2是GTK+库的一个ruby扩展。它对GTK+的对象模型仔细地用Ruby的方式进行封装,保留了GTK+ API命名方式和含义,所以GTK+的文档对于RubyGnome2也是适用的---尽管我认为RubyGnome2的文档已经做得很不错了,需回去借鉴GTK文档的地方实在不多。

落到代码里,虽然GTK本身是由C编写的,但它有一套完整的精心设计对象体系,使得它的GUI元件能够很灵活的自由组合,以实现复杂的,功能强大的界面。

在这个场景下,由于GTK很重视它的对象体系的灵活性,因此刚开始采用GTK编程同时不容易。很多时候表面上看起来很轻松的一个功能,在GTK里面却要绕几个弯才能实现。比如要设置一个label的字体,要借助Pango来实现,Pango接管了GTK的所有字体渲染事务....这种“多绕几个弯”的情况很多,它确实使得编写GTK程序不那么直接了当。但换来的是整个GTK系统变得很灵活,以较少的代价实现强大的功能,在跨平台,换肤,国际化上面都有很好的表现。

RubyGnome2继承了GTK的所有特点,包括优点和缺点。

GUI布局
实际处理时,GTK程序的布局很灵活,有许多种容器可选择。在布局的时候,大多数都是建议相对位置而不是绝对位置,这样GUI程序能够更好的适应不同分辨率的屏幕,也有利于特定风格对UI的fine tune。
在这个场景下,最常用的容器就是“盒子”,包括“水平盒子”和“垂直盒子”。将可视的UI元件放入“盒子”,不同的“盒子”互相组合叠放就能够构建出目标布局。

落到代码里,理论上用盒子就能够构建任何相对位置布局,但是为了方面,GTK还提供了像table这样的更高级的容器。

实际处理时,盒子模型对于许多刚开始GTK编程的人觉得很难适应,即采用了可视化布局工具比如Glade,初学者也往往被盒子模型困扰。可视化布局器最擅长的是固定位置布局。对于相对位置布局,很多时候用代码构建界面比用Glade反而来的快捷便于。

落到代码里,但是用代码构建界面有一个显著的缺点,那就是“不直观”,即很难从代码中看出UI布局,这样会给后期维护以及变更带来麻烦。

从实现思路看,有一些GUI库如Shose,用builder风格的代码来描述UI,使得UI布局能够借助代码形象地体现出来,如以下这个例子来自shooose.net:


Shoes.app {
 stack(:margin => 4) {
  button "Mice"
  button "Eagles"
  button "Quail"
 }
}



这样,我们就能够从代码中一下子看出UI布局了。

结合项目来看,builder风格的代码和HTML很类似,对于熟悉HTML的web界面设计者来说,可视化的编辑器同时没有多大的必要。


理解这一步时,RubyGnome2没有为我们提供builder方式的布局,所以UI代码写起来就像:


class MyWin < Gtk::Window
 def initialize
  super
  vbox = Gtk::VBox.new
  btn_mice = Gtk::Button.new 'Mice'
  vbox.pack_start btn_mice
  btn_eagles = Gtk::Button.new 'Eagles'
  vbox.pack_start btn_eagles
  btn_quail = Gtk::Button.new 'Quail'
  vbox.pack_start btn_quail
  add vbox
 end
end


从上面的代码中很难一下子看出UI布局。

理解这一步时,若也为RubyGnome2构建一个builder风格的布局器,那么代码就会变成:


class MyWin < Gtk::Window
 
 def initialize
  super
  add my_layout
 end
 
 def my_layout
  vbox do
   button 'Mice'
   button 'Eagles'
   button 'Quail'
  end
 end
 
end



嗯,这个代码就和Shose差不多了,能够从代码中一眼看出UI布局。

从实现思路看,本文所介绍的GtkSimpleLayout其功能之一就是为RubyGnome2提供builder风格的布局器。

GtkSimpleLayout布局器
结合项目来看,这个轻松的布局器原先只有200行不到的代码,我经常是直接拷贝到项目中采用。后来逐渐添了些功能,觉得它变得更有用了,于是便发布到github生成gem,便于感兴趣者采用。

Source: git://github.com/rickyzheng/GtkSimpleLayout.git
or:
gem source -a (链接已移除) && gem install rickyzheng-GtkSimpleLayout

以下是主要功能介绍以及轻松例子。

提供Builder风格布局
实际处理时,正如上面的例子中所介绍的,GtkSimpleLayout为RubyGnome2带来了builder风格的布局功能,只需为布局的类扩展GtkSimpleLayout::Base即可,一个完整的例子:


require 'gtk2'
require 'simple_layout'
 
class MyWin < Gtk::Window
 include SimpleLayout::Base
 def initialize
  super
  add my_layout
  signal_connect('destroy') do
   Gtk.main_quit
  end
 end
 
 def my_layout
  hbox do
    label 'Hello, '
    button 'World !'
   end
 end
end


MyWin.new.show_all
Gtk.main


从实现思路看,从上面的例子中能够看出,GtkSimpleLayout同时没有改变RubyGnome2程序的主框架,它只是一个扩充。


属性设置
在这个场景下,在放置UI元件的时候,往往需设置初始属性,或者要指定布局参数。GtkSimpleLayout用Hash来传递这些属性与参数,比如:


vbox do
 button 'sensitive = false', :sensitive => false # 初始为disable状态
 button 'expand space', :layout => [true, true] # 指定这个button填充剩余空间
end

落到代码里,上面这个例子中,第一个button的初始状态为disable。 ":sensitive => false"这个参数最后被转换成属性设置:Gtk::Button#sensitive=false,至于Gtk::Button有那些属性能够设置,请参阅RubyGnome2 API文档或GTK文档。GtkSimpleLayout在这里只是作一个轻松参数的转换而已。

在这个场景下,第二个button的":layout => [true, true]"有点特殊。":layout" 参数是GtkSimpleLayout的保留参数,它会被转换成当这个UI被放入容器时候的参数。这个例子中,容器是vbox(Gtk::VBox),默认的加入方法是Gtk::VBox#pack_start,这个例子中的[true, true] 最后会被传递到pack_start,所以这个button在被加入vbox的时候调用的方法以及参数是:"Gtk::VBox#pack_start( button, true, true)"。

在这个场景下,所以,要采用GtkSimpleLayout,就首先要熟悉RubyGnome2的各个元件,容器的用法,以及参数。当你熟悉了RubyGnome2以后,用GtkSimpleLayout就会很轻松。

批量属性设置
在UI布局的时候,经常碰到要对一组UI元件设置相同的属性的情况,比如:


hbox do
  button 'C', :layout => [false, false, 5]
  button 'D', :layout => [false, false, 5]
  button 'E', :layout => [false, false, 5]
end

这个时候,能够用"with_attr"来简化:


hbox do
 with_attr :layout => [false, false, 5] do
  button 'C'
  button 'D'
  button 'E'
 end
end


特殊容器
从实现思路看,有些容器的放置子元件的时候有 特殊要求,比如Gtk::HPaned,左边子窗口要用Gtk::HPaned#add1()来添加,右边的用Gtk::HPaned#add2()。对于这种容器,GtkSimpleLayout要特别对待,就以hpaned为例:


hpaned do
 area_first do
  frame 'first area'
 end
 area_second do
  frame 'second area'
 end
end


需特殊对待的容器有:
结合项目来看,hpaned/vpaned : 用area_first和area_second来添加子窗口。
table : 用grid来填充格子。
nodebook : 用page来添加子页。

标识UI元件
落到代码里,GtkSimpleLayout用":id => ??"这个参数为UI元件进行标识,比如:


hbox do
 button 'first', :id => :btn_first
 button 'second', :id => :btn_second
end


之后,能够用component()函数取得这个UI元件:


my_first_button = component(:btn_first)
my_second_button = component(:btn_second)
 
...
my_first_button.signal_connect('clicked') do
 puts "first button clicked"
end
 
my_second_button.signal_connect('clicked') do
 puts "second button clicked"
end



在这个场景下,若嫌麻烦,GtkSimpleLayout还提供了expose_components()用来自动将所有已标识的元件添加为实例读属性(getter):

结合项目来看,expose_components() # 将自动添加btn_first和btn_second这两个读属性(getter)。


...
btn_first.signal_connect('clicked') do
 puts "first button clicked"
end
 
btn_second.signal_connect('clicked') do
 puts "second button clicked"
end



自动事件响应映射
在这个场景下,若你嫌显式调用signal_connect来注册事件麻烦,那么GtkSimpleLayout为你提供了自动事件响应映射的功能:


require 'gtk2'
require 'simple_layout'
 
class MyWin < Gtk::Window
 include SimpleLayout::Base
 def initialize
  super
  add my_layout
  register_auto_events() # 注册自动事件响应映射
 end
 
 def my_layout
  hbox do
   button "First', :btn_first
   button "Second", :btn_second
  end
 end
 
 # 事件响应函数
 def btn_first_on_clicked(*_)
  puts "First button clicked"
 end
 
 # 事件响应函数
 def btn_second_on_clicked(*_)
  puts "Second button clicked"
 end
 
 # 退出事件响应函数
 def self_on_destroy(*_)
  Gtk.main_quit
 end
end


最后那个'self‘是指宿主容器。

UI分组
落到代码里,有时候你希望对UI元件进行分组,这样就能够对同一组的UI元件进行控制,如使能或禁止整个组。GtkSimpleLayout允许你在布局的时候指定UI组。
GtkSimpleLayout的UI分组规则如下所示:
落到代码里,默认情况下,已命名的容器(即传入了:id参数)自动对自己所属的子元件建立一个组,组名就是容器明。
在这个场景下,若容器传入:gid=>??参数,则以此名称为所属子元件建立组。
允许多个容器的:gid名字相同,这种情况下所属子元件将归为同一个组。
理解这一步时,能够用“group”来显式对UI分组,group能够看作是一个虚拟的容器。
结合项目来看,用component_children(group_name)来拿到UI组。

理解这一步时,由于UI分组的例子比较长不在此列出,请参阅源码中的examples/group.rb文件


UI与逻辑代码分离
在这个场景下,由于GtkSimpleLayout潜在地迫使采用者分离界面代码和逻辑处理(或事件响应)代码,使得整个程序的层次结构更加清晰。对于界面元件比较多的程序,能够很便于的分区进行layout,因为layout的结果还是容器,这个容器又能够放入其他容器组合成更复杂的界面。

结合项目来看,由于GtkSimpleLayout同时不改变RubyGnome2的程序结构,你能够选择在你的程序中部分或全部采用GtkSimpleLayout。虽然本文所提供的例子都是静态布局,但由于GtkSimpleLayout是存代码构建UI,因此你完全能够在布局的时候传入变量,进行动态布局和动态生成UI,而仍然保持UI代码的“可视化”。


在这个场景下,有兴趣者能够看看GtkSimpleLayout实现的代码,不过300行而已,这就是Ruby的魅力。

最后,贴上一个计算器的界面部分的代码例子,你能从代码中看出UI布局么?


require 'gtk2'
require 'simple_layout'
 
class MyWin < Gtk::Window
 include SimpleLayout::Base
 def initialize
  super
  add my_layout
  signal_connect('destroy') do
   Gtk.main_quit
  end
 end
 
 def my_layout
  vbox do
   with_attr :border_width => 3 do
    hbox do
     entry :id => :ent_input, :layout => [true, true, 5]
    end
    hbox do
     frame do
      label 'M', :set_size_request => [20, 20]
     end
     hbutton_box do
      button 'Backspace'
      button 'CE'
      button 'C'
     end
    end
    hbox do
     vbutton_box do
      button 'MC'
      button 'MR'
      button 'MS'
      button 'M+'
     end
     with_attr :layout => [true, true] do
      number_and_operators_layout
     end
    end
   end
  end
 end
 
 def number_and_operators_layout
  vbox do
   [ ['7', '8', '9', '/', 'sqt'],
    ['4', '5', '6', '*', '%'],
    ['1', '2', '3', '-', '1/x'],
    ['0', '+/=', '.', '+', '=']].each do |cols|
    hbox :layout => [true, true] do
     cols.each do |txt|
      button txt, :set_size_request => [20, 20], :layout => [true, true]
     end
    end
   end
  end
 end
 
end


MyWin.new.show_all
Gtk.main

Enjoy it :-)

相关资讯
点击查看更多
游戏推荐
推荐专题
热门阅读
推荐下载