# 글레이드로 만든 도구 모음(Python)

Tiffany Antopolski
tiffany.antopolski@gmail.com 2012
Marta Maria Casetti
mmcasetti@gmail.com 2012
Sebastian Pölsterl
sebp@k-d-w.org 2011
단추 및 기타 위젯 표시줄
조성호
shcho@gnome.org 2017-2019.

# 글레이드로 만든 도구 모음

이 예제는 XML .ui 파일을 만들 때 글레이드를 사용한다는 점만 빼면 와 유사합니다.

# 글레이드로 도구 모음 만들기

글레이드 인터페이스 디자이너로 도구 모음을 만들려면:

글레이드를 열고 toolbar_builder.ui 파일로 저장하십시오

글레이드 사용자 인터페이스 스크린샷

왼편의 컨테이너에서, 도구모음 아이콘에 마우스 커서를 올려둔 후 오른쪽 단추를 누르고 최상위에 위젯 추가를 선택하십시오.

글레이드 UI 도구 모음 아이콘 스크린샷

하단 우측의 일반 탭에서 , 이름을 toolbar로 바꾸고 Show Arrow는 No로 바꾸십시오.

일반 탭 스크린샷

공통 사항 탭에서, 수평 확장을 Yes로 설정하십시오.

공통 사항 탭 스크린샷

우측 상단의 도구 모음에서 마우스 오른쪽 단추를 누른후 편집을 선택하십시오. 도구 모음 편집기 창이 뜹니다.

도구 모음을 편집할 때 오른쪽 단추를 누를 부분의 스크린샷.

새 파일, 열기, 실행 취소, 전체 화면, 전체 화면 나가기 도구 단추 5개를 추가하겠습니다. 우선 새 도구 단추를 추가하겠습니다.

계층 구조 탭에서, 추가를 누르십시오.

ToolItem 이름을 new_button으로 바꾸십시오.

스크롤을 내린 후 Is important를 Yes로 설정하십시오. 이렇게 설정하면, 도구 모음에서 도구 단추 레이블이 나타납니다.

동작 이름을 app.new로 입력하십시오.

레이블을 New로 바꾸십시오.

드롭 다운 메뉴에서 새로 만들기의 스톡 ID를 선택하거나 gtk-new를 입력하십시오.

나머지 ToolButton에 대해 위 단계를 반복하시고, 다음 속성을 설정하십시오:

Name | 중요 여부 | 동작 이름 | Label | 스톡 ID
--- | --- | --- | --- | ---
open_button | 예 | app.open | 열기 | gtk-open
undo_button | 예 | win.undo | 실행 취소 | gtk-undo
fullscreen_button | 예 | win.fullscreen | 최대 화면 | gtk-fullscreen
leave_fullscreen_button | 예 | win.fullscreen | 전체 화면 나가기 | gtk-leave-fullscreen

도구 모음 편집기를 닫으십시오.

프로그램을 처음 시작할 때, 프로그램이 전체 화면 모드가 아니기에 전체 화면 나가기 ToolButton을 나타내고 싶진 않습니다. 이 설정은 일반 탭에서 Visible을 누르고 No로 설정할 수 있습니다. ToolButton은 인터페이스 디자이너에서 여전히 나타나겠지만 프로그램 코드에 파일을 불러올 때, 상태에 따라 올바르게 나타납니다. 참고로 `show_all()` 메서드는 이 설정을 무시한 채로 적용합니다. 따라서, 코드에서는 모든 구성요소에 `show()` 함수를 각각 적용해야합니다.

visible 속성을 No로 설정

작업을 저장하고 글레이드를 닫으십시오.

글레이드에서 만든 XML 파일은 아래와 같습니다. 도구 모음의 설명 부분입니다. 이 글을 쓰는 시점에서는 글레이드 인터페이스에서 추가할 Gtk.STYLE_CLASS_PRIMARY_TOOLBAR 옵션 클래스가 없습니다. 이 옵션 클래스를 XML 파일에 직접 추가할 수 있습니다. 이렇게 하려면, 다음 toolbar_builder.ui XML 코드 9번째 줄에 추가하십시오:

<style> <class name="primary-toolbar"/> </style>

추가하지 않았더라도 프로그램은 여전히 멀쩡하게 동작합니다. Toolbar의 결과는 이 페이지 상단의 스크린샷보다는 약간 다르게 보일 수도 있습니다.

<?xml version="1.0" encoding="UTF-8"?> <interface> <!-- interface-requires gtk+ 3.0 --> <object class="GtkToolbar" id="toolbar"> <property name="visible">True</property> <property name="can_focus">False</property> <property name="hexpand">True</property> <property name="show_arrow">False</property> <child> <object class="GtkToolButton" id="new_button"> <property name="use_action_appearance">False</property> <property name="visible">True</property> <property name="can_focus">False</property> <property name="use_action_appearance">False</property> <property name="is_important">True</property> <property name="action_name">app.new</property> <property name="label" translatable="yes">New</property> <property name="use_underline">True</property> <property name="stock_id">gtk-new</property> </object> <packing> <property name="expand">False</property> <property name="homogeneous">True</property> </packing> </child> <child> <object class="GtkToolButton" id="open_button"> <property name="use_action_appearance">False</property> <property name="visible">True</property> <property name="can_focus">False</property> <property name="use_action_appearance">False</property> <property name="is_important">True</property> <property name="action_name">app.open</property> <property name="label" translatable="yes">Open</property> <property name="use_underline">True</property> <property name="stock_id">gtk-open</property> </object> <packing> <property name="expand">False</property> <property name="homogeneous">True</property> </packing> </child> <child> <object class="GtkToolButton" id="undo_button"> <property name="use_action_appearance">False</property> <property name="visible">True</property> <property name="can_focus">False</property> <property name="use_action_appearance">False</property> <property name="is_important">True</property> <property name="action_name">win.undo</property> <property name="label" translatable="yes">Undo</property> <property name="use_underline">True</property> <property name="stock_id">gtk-undo</property> </object> <packing> <property name="expand">False</property> <property name="homogeneous">True</property> </packing> </child> <child> <object class="GtkToolButton" id="fullscreen_button"> <property name="use_action_appearance">False</property> <property name="visible">True</property> <property name="can_focus">False</property> <property name="use_action_appearance">False</property> <property name="is_important">True</property> <property name="action_name">win.fullscreen</property> <property name="label" translatable="yes">Fullscreen</property> <property name="use_underline">True</property> <property name="stock_id">gtk-fullscreen</property> </object> <packing> <property name="expand">False</property> <property name="homogeneous">True</property> </packing> </child> <child> <object class="GtkToolButton" id="leave_fullscreen_button"> <property name="use_action_appearance">False</property> <property name="can_focus">False</property> <property name="use_action_appearance">False</property> <property name="is_important">True</property> <property name="action_name">win.fullscreen</property> <property name="label" translatable="yes">Leave Fullscreen</property> <property name="use_underline">True</property> <property name="stock_id">gtk-leave-fullscreen</property> </object> <packing> <property name="expand">False</property> <property name="homogeneous">True</property> </packing> </child> </object> </interface>

# 예제 결과를 만드는 코드

이제 앞서 만들었던 파일로 Toolbar를 추가하는 아래 코드를 작성하겠습니다.

from gi.repository import Gtk from gi.repository import Gdk from gi.repository import Gio import sys

class MyWindow(Gtk.ApplicationWindow):

def __init__(self, app): Gtk.Window.__init__(self, title="Toolbar Example", application=app) self.set_default_size(400, 200)

# a grid to attach the toolbar (see below) grid = Gtk.Grid() self.add(grid) # we have to show the grid (and therefore the toolbar) with show(), # as show_all() would show also the buttons in the toolbar that we want to # be hidden (such as the leave_fullscreen button) grid.show()

# a builder to add the UI designed with Glade to the grid: builder = Gtk.Builder() # get the file (if it is there) try: builder.add_from_file("toolbar_builder.ui") except: print("file not found") sys.exit() # and attach it to the grid grid.attach(builder.get_object("toolbar"), 0, 0, 1, 1)

# two buttons that will be used later in a method self.fullscreen_button = builder.get_object("fullscreen_button") self.leave_fullscreen_button = builder.get_object( "leave_fullscreen_button")

# create the actions that control the window, connect their signal to a # callback method (see below), add the action to the window:

# undo undo_action = Gio.SimpleAction.new("undo", None) undo_action.connect("activate", self.undo_callback) self.add_action(undo_action)

# and fullscreen fullscreen_action = Gio.SimpleAction.new("fullscreen", None) fullscreen_action.connect("activate", self.fullscreen_callback) self.add_action(fullscreen_action)

# callback for undo def undo_callback(self, action, parameter): print("You clicked \"Undo\".")

# callback for fullscreen def fullscreen_callback(self, action, parameter): # check if the state is the same as Gdk.WindowState.FULLSCREEN, which # is a bit flag is_fullscreen = self.get_window().get_state( ) & Gdk.WindowState.FULLSCREEN != 0 if is_fullscreen: self.unfullscreen() self.leave_fullscreen_button.hide() self.fullscreen_button.show() else: self.fullscreen() self.fullscreen_button.hide() self.leave_fullscreen_button.show()

class MyApplication(Gtk.Application):

def __init__(self): Gtk.Application.__init__(self)

def do_activate(self): win = MyWindow(self) # show the window - with show() not show_all() because that would show also # the leave_fullscreen button win.show()

def do_startup(self): Gtk.Application.do_startup(self)

# actions that control the application: create, connect their signal to a # callback method (see below), add the action to the application

# new new_action = Gio.SimpleAction.new("new", None) new_action.connect("activate", self.new_callback) app.add_action(new_action)

# open open_action = Gio.SimpleAction.new("open", None) open_action.connect("activate", self.open_callback) app.add_action(open_action)

# callback for new def new_callback(self, action, parameter): print("You clicked \"New\".")

# callback for open def open_callback(self, action, parameter): print("You clicked \"Open\".")

app = MyApplication() exit_status = app.run(sys.argv) sys.exit(exit_status)

# Gtk.Builder에 쓸만한 메서드

Toolbar 위젯의 쓸만한 메서드를 찾아보려면 를 참고하십시오

Gtk.Builder는 XML UI 정의로 인터페이스를 만듭니다.

`add_from_file(filename)` 함수는 주어진 파일을 불러오고 해석한 다음 Gtk.Builder의 현재 내용과 합칩니다.

`add_from_string(string)` 함수는 주어진 문자열을 해석하고 Gtk.Builder의 현재 내용과 합칩니다.

`add_objects_from_file(filename, object_ids)` 함수는 `add_from_file()` 함수와 동일하지만, `object_id` 목록에 주어진 ID가 딸린 객체만을 불러옵니다.

`add_objects_from_string(string, object_ids)` 함수는 `add_from_string()`함수와 동일하지만, `object_id` 목록에 주어진 ID의 객체만을 불러옵니다.

`get_object(object_id)` 함수는 빌더에서 불러온 객체의 `object_id` ID를 가진 위젯을 가져옵니다.

`get_objects()` 함수는 불러온 모든 객체를 반환합니다.

`connect_signals(handler_object)` 함수는 `handler_object`로 지정한 메서드에 시그널을 연결합니다. 이 함수에는 class 또는 dict 처럼 인터페이스 설명에 주어진 시그널 핸들러 이름처럼 키 또는 속성이 들어간 객체가 될 수 있습니다. 39번째 줄에서 `undo_action` 동작의 `"activate"` 시그널은 `action.connect(signal, callback function)` 함수로 `undo_callback()` 콜백 함수에 연결했습니다. 더 자세한 설명은 를 참조하십시오.

# API 참고서

이 예제는 다음 참고자료가 필요합니다:

GtkGrid

GtkBuilder

GtkWidget

이벤트 구조체