FoundationsofGTKDevelopment:Appendix A

From 흡혈양파의 번역工房
Jump to navigation Jump to search
부록 A GTK+ 프로퍼티

GTK+ 프로퍼티

GObject는 프로퍼티 시스템을 제공하여 위젯이 사용자와 어떻게 상호작용하고 화면에 어떻게 그려지는지 개발자가 맞춤설정할 수 있도록 해준다. 지금부터는 GTK+ 2.10에서 이용 가능한 위젯과 자식 프로퍼티에 대해 완전한 참고자료를 제공하겠다.

GTK+ 프로퍼티

GObject에서 파생된 모든 클래스는 원하는 수만큼의 프로퍼티를 가질 수 있다. GTK+에서 이러한 프로퍼티는 위젯의 현재 상태에 관한 정보를 저장한다. 가령 GtkButton은 relief라는 프로퍼티를 갖고 있는데, 이 프로퍼티는 정상 상태에서 버튼이 사용하는 양감 테두리(relief border)의 타입을 정의한다.


아래 코드에서는 g_object_get()을 이용해 버튼의 relief 프로퍼티가 저장한 현재 값을 검색하였다. 이 함수는 리턴된 값을 저장하기 위해 NULL로 끝나는 프로퍼티와 변수의 리스트를 수락한다. g_object_set()을 이용해 각 객체(object) 프로퍼티도 설정이 가능하다.

g_object_get (button, "relief", &value, NULL);


위젯에 이용 가능한 프로퍼티에는 다수가 있는데, 표 A-1부터 A-90까지는 GTK+ 2.10의 위젯과 객체에 관련된 프로퍼티 리스트를 모두 제공한다. 객체 프로퍼티는 부모 위젯으로부터 상속되므로 프로퍼티의 전체 리스트는 위젯의 상속구조를 확인해야 함을 기억하도록 한다. 각 객체에 대한 추가 정보는 API 문서를 참조하라.

프로퍼티 타입 설명
artists GStrv 애플리케이션에서 사용되는 아트워크를 생성하도록 도와준 사람들의 리스트. 종종 링크로 된 이메일 주소 또는 URL과 같은 정보가 포함된다.
authors GStrv 애플리케이션의 프로그래밍을 도와준 사람들의 리스트. 종종 프로그래머마다 링크로 된 이메일 주소 또는 URL과 같은 정보가 포함된다.
comments gchararray 프로그램의 일반적인 기능을 설명하는 짧은 문자열. 메인 대화창에 표시되므로 너무 길어선 안 된다.
copyright gchararray 애플리케이션에 관한 저작권 정보. 메인 대화창에 표시되므로 너무 길어선 안 된다. 저작권 문자열에 관한 예로 "(C) Copyright 2007 Author"를 들 수 있다.
documenters GStrv 애플리케이션에 관한 문서를 작성하도록 도와준 사람들의 리스트. 종종 링크로 된 각 문서에 대한 이메일 주소 또는 URL이 포함된다.
license gchararray 애플리케이션의 라이센스 내용. 2차(secondary) 대화상자에 GtkTextView 위젯을 이용해 표시되므로 문자열 길이는 중요하지 않다.
logo GdkPixbuf 메인 창에 애플리케이션의 로고로 표시할 이미지. 이 값이 설정되지 않으면 gtk_window_get_default_icon_list()가 사용될 것이다.
logo-icon-name gchararray 아이콘 테마 중에서 메인 About 대화상자의 로고로 사용할 아이콘명. 이 값을 설정 시 logo 프로퍼티보다 우선할 것이다.
name gchararray 메인 About 대화상자에 표시할 애플리케이션명. 이 프로퍼티를 설정하지 않으면 g_get_application_name()이 사용될 것이다.
translator-credits gchararray 현재 언어에 대한 번역가(들)에 관한 정보를 보유하는 문자열. Translatable(번역 가능)으로 설정되어야만 각 번역가가 커스텀 문자열을 제공할 수 있다. 주로 번역가마다 링크로 된 이메일 주소 또는 URL이 포함된다.
version gchararray 사용자가 실행 중인 애플리케이션의 버전.
website gchararray 애플리케이션에 대한 홈페이지의 URL. 문자열 앞에는 http:// 가 붙어야 한다.
website-label gchararray 웹 사이트 URL 대신 표시할 라벨. 이 값을 설정하지 않을 경우, website가 URL 라벨로 설정될 것이다.
wrap-license gboolean TRUE로 설정 시, license 내용이 래핑될 것이다.
표 A-1. GtkAboutDialog 프로퍼티


프로퍼티 타입 설명
accel-closure GClosure 키보드 가속기에 대한 변경 내용을 감시해야 하는 closure.
accel-widget GtkWidget 키보드 가속기에 대한 변경 내용을 감시해야 하는 위젯.
표 A-2. GtkAccelLabel 프로퍼티


프로퍼티 타입 설명
action-group GtkActionGroup 액션이 속한 액션 그룹. 액션이 액션 그룹에 속하지 않을 경우, NULL로 설정해도 좋다.
hide-if-empty gboolean TRUE로 설정 시, 빈 메뉴 프록시는 뷰에서 숨겨질 것이다.
icon-name gchararray 아이콘 테마에서 사용할 아이콘명. 이 프로퍼티는 stock-id 프로퍼티로 오버라이드된다.
is-important gboolean 툴바가 GTK_TOOLBAR_BOTH_HORIZ 모드로 되어 있는 경우, 이 프로퍼티를 TRUE로 설정하면 항목에 해당하는 라벨이 표시될 것이다. 그 외의 경우, 어떤 효과도 없다.
label gchararray 메뉴 항목이나 버튼에 표시할 텍스트. 툴바 항목은 short-label 프로퍼티를 이용한다.
name gchararray 액션을 구별하는 유일한 문자열.
sensitive gboolean TRUE로 설정 시, 액션이 활성화될 것이다. 그 외의 경우, 사용자는 액션과 상호작용할 수 없을 것이다.
short-label gchararray 툴 항목에 표시할 텍스트. 메뉴 항목과 버튼은 label 프로퍼티를 이용한다.
stock-id gchararray 액션을 이용하는 위젯에 표시할 스톡 아이콘. 이 프로퍼티는 icon-name보다 우선한다.
tooltip gchararray 사용자가 툴바 항목 위를 왔다갔다하면 표시되는 액션에 관한 툴팁.
visible gboolean TRUE로 설정 시, 액션이 사용자에게 표시되지 않을 것이다.
visible-horizontal gboolean TRUE로 설정 시, 툴바가 가로 방향으로 설정되면 액션이 툴바에 표시되지 않을 것이다.
visible-overflown gboolean TRUE로 설정 시, 액션이 툴바 오버플로 메뉴에 표시될 것이다. 그 외의 경우, 뷰에서 숨겨질 것이다.
visible-vertical gboolean TRUE로 설정 시, 툴바가 세로 방향으로 설정되면 액션이 툴바에 표시될 것이다.
표 A-3. GtkAction 프로퍼티


프로퍼티 타입 설명
name gchararray 액션 그룹을 구별하는 문자열.
sensitive gboolean TRUE로 설정 시, 액션 그룹이 활성화(active 또는 enabled)로 설정된다.
visible gboolean TRUE로 설정 시, 액션 그룹이 사용자에게 표시될 것이다.
표 A-4. GtkActionGroup 프로퍼티


프로퍼티 타입 설명
lower gdouble 조정이 도달할 수 있는 최소 gdouble 값.
page-increment gdouble 앞으로 또는 뒤로 한 페이지를 이동 시 전환할 증가값(increment).
page-size gdouble 조정에 대한 페이지 크기. GtkSpinButton에 대해 GtkAdjustment를 이용 시에는 0으로 설정해야 한다.
step-increment gdouble 각 단계에서 이동하게 될 증가값. GtkSpinButton의 경우를 예로 들면, 화살표 버튼을 누를 때마다 하나의 단계를 취할 것이다.
upper gdouble 조정이 도달할 수 있는 최대 gdouble 값.
value gdouble 조정의 현재 값으로, 항상 lower와 upper 사이의 값이어야 한다.
표 A-5. GtkAdjustment 프로퍼티


프로퍼티 타입 설명
bottom-padding guint 자식 위젯의 하단면을 따라 추가된 패딩.
left-padding guint 자식 위젯의 좌측면을 따라 추가된 패딩.
right-padding guint 자식 위젯의 우측면을 따라 추가된 패딩.
top-padding guint 자식 위젯의 상단면을 따라 추가된 패딩.
xalign(yalign) gfloat 자식 위젯의 정렬을 정의하는 값으로, 0.0과 1.0 사이 값이어야 하며 1.0은 컨테이너의 하단이나 우측면을 따라 정렬됨을 의미한다.
xscale(yscale) gfloat 자식 위젯이 추가 공간을 차지하도록 확장시키는 데에 사용되는 값으로, 0.0과 1.0 사이의 값이어야 한다.
표 A-6. GtkAlignment 프로퍼티


프로퍼티 타입 설명
arrow-type GtkArrowType GtkArrow가 가리킬 방향.
shadow-type GtkShadowType 화살표 주변에 위치시킬 그림자(shadow) 타입.
표 A-7. GtkArrow 프로퍼티


프로퍼티 타입 설명
obey-child gboolean TRUE로 설정 시, ratio 프로퍼티 대신 자식 위젯이 정의한 영상비를 이용한다.
ratio gfloat 영상비를 정의하는 0.0001과 10,000 사이의 숫자.
xalign(yalign) gfloat 컨테이너 내에서 자식 컨테이너의 정렬을 정의하는 값으로, 0.0과 1.0 사이의 값이어야 하며 0.5는 중앙 정렬을 의미한다.
표 A-8. GtkAspectFrame 프로퍼티


프로퍼티 타입 설명
homogeneous gboolean TRUE로 설정 시, 모든 자식들이 동일한 크기로 설정될 것이다.
spacing gint 각 자식과 주위 자식들(neighbors) 사이에 추가할 공간.
표 A-9. GtkBox 프로퍼티


프로퍼티 타입 설명
focus-on-click gboolean TRUE로 설정 시, 버튼을 마우스로 클릭하면 버튼이 포커스를 잡을(grab) 것이다.
image GtkWidget 버튼의 테스트 옆에 표시할 위젯.
image-position GtkPositionType 라벨을 기준으로 한 image의 위치.
label gchararray 버튼이 라벨을 포함할 경우 버튼 내에 표시할 텍스트 라벨.
relief GtkReliefStyle 버튼 주변에 위치시킬 테두리 타입.
use-stock gboolean TRUE로 설정 시, 스톡 항목이 버튼의 내용으로 사용될 것이다.
use-underline gboolean TRUE로 설정 시, 밑줄 다음에 오는 문자에 니모닉 키보드 가속기가 사용될 것이다.
xalign(yalign) gfloat 0.0과 1.0 사이의 부동 소수점수로 GtkMisc 또는 GtkAlignment 위젯의 경우 자식 위젯을 정렬하는데 사용되며, 0.5는 중앙 정렬을 의미한다.
표 A-10. GtkButton 프로퍼티


프로퍼티 타입 설명
layout-style GtkButtonBoxStyle 자식 버튼에 사용되는 레이아웃의 타입.
표 A-11. GtkButtonBox 프로퍼티


프로퍼티 타입 설명
day gint 1과 31 사이에 현재 선택된 일자(day). 0을 선택하면 현재 일자의 선택을 해제할 것이다.
month gint 0과 11 사이에 현재 선택된 월로, 0은 1월을 나타낸다.
no-month-change gboolean TRUE로 설정 시, 사용자는 월을 변경하지 못할 것이다.
show-day-names gboolean TRUE로 설정 시, 요일명이 일자(day) 위에 표시될 것이다.
show-heading gboolean TURE로 설정할 경우, 캘린더 헤딩이 표시될 것이다.
show-week-numbers gboolean TURE로 설정할 경우, 현재 월과 연도에 대한 주(week) 번호가 캘린더 좌측면을 따라 표시될 것이다.
year gint 현재 선택된 연도.
표 A-12. GtkCalendar 프로퍼티


프로퍼티 타입 설명
cell-background gchararray "Red" 또는 "#00CC00"과 같이 배경색을 나타내는 문자열. 이 프로퍼티가 효과를 발휘하기 위해서는 cell-background-set 또한 TRUE로 설정해야 한다.
cell-background-gdk GdkColor 셀의 배경색.
height gint 셀의 높이. 셀의 기본 높이를 사용하려면 이 프로퍼티를 -1로 설정한다.
is-expanded gboolean 행에 자식 행이 있을 경우 행이 확장되면 이 프로퍼티는 TRUE로 설정될 것이다.
is-expander gboolean 행에 자식 행이 있을 경우 TRUE로 설정하라.
mode GtkCellRendererMode 셀의 상호작용 모드.
sensitive gboolean TRUE로 설정 시, 사용자는 셀과 상호작용을 할 수 있을 것이다.
visible gboolean TRUE로 설정 시, 셀이 사용자에게 표시될 것이다.
width gint 셀의 너비. 셀의 기본 너비를 사용하려면 이 프로퍼티를 -1로 설정한다.
xalign(yalign) gfloat 셀 내에서 내용의 정렬을 정의하는 값으로, 0.0과 1.0 사이 값이어야 하며 0.5는 중앙 정렬을 의미한다.
xpad(ypad) guint 셀의 자식 내용에서 각 면(side)마다 위치시켜야 할 수평 및 수직 패딩.
표 A-13. GtkCellRenderer 프로퍼티


프로퍼티 타입 설명
accel-key guint 가속기에 대한 키 값. 키 코드의 리스트는 gdkkeysyms.h에서 찾을 수 있다.
accel-mode GtkCellRendererAccelMode 가속기가 GTK+ 가속기인지 결정하는 플래그 값. GTK_CELL_RENDERER_ACCEL_MODE_GTK의 값을 선택할 경우 이미 사용 중인 가속기를 입력하지 못할 것이다.
accel-mods GdkModifierType 가속기에 사용할 수정자(modifier).
keycode guint 키보드 가속기에 대한 하드웨어 키 코드. 키에 이용 가능한 키 값이 있는 경우 accel-key 프로퍼티를 이용해야 한다.
표 A-14. GtkCellRendererAccel 프로퍼티


프로퍼티 타입 설명
has-entry gboolean TRUE로 설정 시, 셀을 편집하는 동안 GtkComboBoxEntry 위젯이 표시될 것이다.
model GtkTreeModel GtkComboBox 위젯에서 선택(choice)을 정의하는 트리 모델.
text-column gint 셀을 편집하지 않을 때 표시할 model 내의 열 번호.
표 A-15. GtkCellRendererCombo 프로퍼티


프로퍼티 타입 설명
follow-state gboolean TRUE로 설정 시, pixbuf는 GtkCellRendererState를 바탕으로 색이 칠해질 것이다.
icon-name gchararray 아이콘 테마로부터 표시할 아이콘. stock-id와 pixbuf 프로퍼티가 이 설정보다 우선한다.
pixbuf GdkPixbuf 셀에 표시할 이미지. 이 프로퍼티는 icon-name 보다 우선한다.
pixbuf-expander-closed GdkPixbuf 자식 행이 숨겨질 때 익스팬더로 표시할 이미지.
pixbuf-expander-open GdkPixbuf 자식 행이 표시될 때(visible) 익스팬더로 표시할 이미지.
stock-detail gchararray 테마 엔진으로 전송된 문자열. 스톡 항목의 렌더링에 관한 추가 정보를 제공한다.
stock-id gchararray 아이콘으로 사용할 스톡 식별자. 이 프로퍼티는 icon-name보다 우선한다.
stock-size guint 렌더링할 스톡 아이콘의 크기.
표 A-16. GtkCellRendererPixbuf 프로퍼티


프로퍼티 타입 설명
text gchararray 진행 막대 위에 그려질 텍스트 문자열. NULL로 설정할 경우 기본 문자열이 표시될 것이다.
value gint 진행 막대가 채워진 양으로, 0부터 100까지 숫자로 정의되는데 100은 완전히 채워짐을 의미한다.
표 A-17. GtkCellRendererProgress 프로퍼티


프로퍼티 타입 설명
adjustment GtkAdjustment 스핀 버튼을 편집할 때 그에 관한 정보를 보유하는 조정. 이 프로퍼티는 편집 가능하게(editable) 설정되어야 한다.
climb-rate gdouble 화살표 버튼을 누르고 있을 때 적용할 가속 속도.
digits guint 셀을 편집하는 동안 스핀 버튼에 표시할 소수 자리수. 셀이 편집되지 않을 때 표시하는 소수 자리수에는 영향을 미치지 않음을 주목한다. 일반 상태 숫자(state digits)를 설정하기 위해서는 셀 데이터 함수를 이용해야 한다.
표 A-18. GtkCellRendererSpin 프로퍼티


프로퍼티 타입 설명
alignment PangoAlignment 텍스트 행의 정렬. 이 프로퍼티가 효과를 발휘하기 위해서는 align-set을 TRUE로 설정해야 한다.
attributes PangoAttrList 렌더러의 텍스트로 적용되는 속성 리스트.
background gchararray 문자열로 된 셀의 배경색. 이 프로퍼티가 효과를 발휘하기 위해서는 background-set을 TRUE로 설정해야 한다.
background-gdk GdkColor 셀의 배경색.
editable gboolean TRUE로 설정 시, 사용자는 텍스트를 편집할 수 있다. 이 프로퍼티가 효과를 발휘하기 위해서는 editable-set을 TRUE로 설정해야 한다.
ellipsize PangoEllipsizeMode 전체 문자열을 표시하기에 충분한 공간이 없을 경우 문자열 내에서 텍스트를 타원(ellipse)으로 대체할 공간. 이 프로퍼티가 효과를 발휘하기 위해서는 ellipsize-set을 TRUE로 설정해야 한다.
family gchararray Arial 또는 Monospace와 같은 폰트 패밀리명. 이 프로퍼티가 효과를 발휘하기 위해서는 ellipsize-set을 TRUE로 설정해야 한다.
font gchararray "Monospace Bold 10"과 같은 폰트 패밀리 문자열. 이 프로퍼티가 효과를 발휘하기 위해서는 font-set을 TRUE로 설정해야 한다.
font-desc PangoFontDescription 셀에 대한 글꼴을 정의하는 글꼴 설명.
foreground gchararray 문자열로 된 셀의 전경색. 이 프로퍼티가 효과를 발휘하기 위해서는 foreground-set을 TRUE로 설정해야 한다.
foreground-gdk GdkColor 셀의 전경색.
language gchararray ISO 코드로 된 셀의 텍스트 언어. 대부분의 경우 이 프로퍼티를 사용하지 않아도 될 것이다. 이 프로퍼티가 효과를 발휘하기 위해서는 language-set을 TRUE로 설정해야 한다.
markup gchararray Pango 마크업을 포함하는 셀이 렌더링하게 될 텍스트.
rise gint 텍스트에 대한 양의 또는 음의 오프셋. 이 프로퍼티가 효과를 발휘하기 위해서는 rise-set을 TRUE로 설정해야 한다.
scale gdouble gdouble 값으로 된 폰트의 조정 인수(scaling factor). 이 프로퍼티가 효과를 발휘하기 위해서는 scale-set을 TRUE로 설정해야 한다.
single-paragraph-mode gboolean TRUE로 설정 시, 모든 텍스트는 강제로 하나의 단락으로 모아질 것이다.
size gint PANGO_UNITS의 인수로 스케일링된 텍스트의 글꼴 크기. 이 프로퍼티가 효과를 발휘하기 위해서는 size-set을 TRUE로 설정해야 한다.
size-points gdouble 포인트로 된 텍스트의 글꼴 크기.
stretch PangoStretch 텍스트 문자 간 공간을 추가하거나 제거하는 데에 사용되는 플래그. 이 프로퍼티가 효과를 발휘하기 위해서는 stretch-set을 TRUE로 설정해야 한다.
strikethrough gboolean TRUE로 설정 시, 텍스트를 거쳐 하나의 행이 위치할 것이다. 이 프로퍼티가 효과를 발휘하기 위해서는 strikethrough-set을 TRUE로 설정해야 한다.
style PangoStyle 이탤릭체 또는 oblique와 같은 글꼴의 스타일. 이 프로퍼티가 효과를 발휘하기 위해서는 style-set을 TRUE로 설정해야 한다.
text gchararray 셀에 표시할 텍스트.
underline PangoUnderline 텍스트 아래 위치시킬 밑줄의 스타일. 이 프로퍼티가 효과를 발휘하기 위해서는 underline-set을 TRUE로 설정해야 한다.
variant PangoVariant 소문자로 된 문자를 작은 대문자로 렌더링하려면 PANGO_VARIANT_SMALL_CAPS로 설정한다. 이 프로퍼티가 효과를 발휘하기 위해서는 variant-set을 TRUE로 설정해야 한다.
weight gint 글꼴의 두께. 이 프로퍼티가 효과를 발휘하기 위해서는 weight-set을 TRUE로 설정해야 한다.
width-chars gint 문자에서 셀의 너비. 이 프로퍼티를 -1로 설정하면 GTK+는 너비를 계산할 것이다.
wrap-mode PangoWrapMode 텍스트에 사용할 래핑(wrap) 타입. 기본적으로 PANGO_WRAP_CHAR으로 설정된다.
wrap-width gint 텍스트가 래핑될 너비. 이 프로퍼티를 -1로 설정하면 래핑이 비활성화될 것이다.
표 A-19. GtkCellRendererText 프로퍼티


프로퍼티 타입 설명
activatable gboolean TRUE로 설정 시, 사용자가 토글 버튼을 활성화할 수 있다. 그렇지 않으면 토글 버튼은 설정을 표시하는 기능에 그친다.
active gboolean TRUE로 설정 시, 토글 버튼이 활성화 상태로(activated) 설정될 것이다.
inconsistent gboolean TRUE로 설정 시, 토글 버튼의 상태는 활성화 상태도(active), 비활성화(inactive) 상태도 아니다.
indicator-size gint 체크 버튼 또는 라디오 버튼의 크기. 기본적으로 12 픽셀로 설정된다.
radio gboolean TRUE로 설정 시, 토글이 라디오 버튼으로 그려진다. 하지만 라디오 버튼의 기능은 개발자가 구현해야 할 것이다.
표 A-21. GtkCellView 프로퍼티


프로퍼티 타입 설명
active gboolean TRUE로 설정 시, 체크 메뉴 항목이 활성화로 설정된다.
draw-as-radio gboolean TRUE로 설정 시, 메뉴 항목이 라디오 버튼으로 그려진다. 하지만 라디오 버튼의 기능은 개발자가 구현해야 할 것이다.
inconsistent gboolean TRUE로 설정 시, 토글 버튼은 활성화 상태도, 비활성화 상태도 아닌 중간 상태로 표시될 것이다.
표 A-22. GtkCheckMenuItem 프로퍼티


프로퍼티 타입 설명
alpha guint 선택된 색상의 투명도로, 0은 투명한 수준이고 65,535는 불투명한 수준이다.
color GdkColor 현재 선택된 색상.
title gchararray 사용자가 버튼을 클릭하면 표시되는 GtkColorSelectionDialog에 제공할 제목.
use-alpha gboolean TRUE로 설정 시, 사용자에게 투명도를 선택할 수 있는 선택권이 부여될 것이다.
표 A-23. GtkColorButton 프로퍼티


프로퍼티 타입 설명
current-alpha guint 선택된 색상의 투명도로, 0은 투명한 수준이고 65,535는 불투명한 수준이다.
current-color GdkColor 현재 선택된 색상.
has-opacity-control gboolean TRUE로 설정 시, 사용자에게 투명도를 선택할 수 있는 선택권이 부여될 것이다.
has-palette gboolean TRUE로 설정 시, 색상 팔레트가 사용자에게 표시될 것이다.
표 A-24. GtkColorSelection 프로퍼티


프로퍼티 타입 설명
active gint 활성화된 현재 항목의 색인. 선택된 행이 루트 요소가 아닐 경우 이 항목은 gtk_tree_path_get_indices()가 리턴한 값과 동일할 것이다.
add-tearoffs gboolean TRUE로 설정 시, 콤보 박스가 메뉴 스타일을 이용한다면 메뉴에는 테어 오프(tear-off) 메뉴 항목을 가질 것이다.
column-span-column gint 리스트 내 여러 열에 걸쳐 값을 원한다면 이 프로퍼티를 G_TYPE_INIT 타입의 모델 열을 가리키는 음수가 아닌(non-negative) 정수로 설정하라. 이 정수는 값이 얼마나 많은 열에 걸쳐 표시될 것인지 정의한다.
focus-on-click gboolean TRUE로 설정 시, 사용자가 콤보 박스를 클릭하면 콤보 박스가 포커스를 잡을 것이다.
has-frame gboolean TRUE로 설정 시, 선택된 항목 주위로 프레임이 그려질 것이다.
model GtkTreeModel 콤보 박스에 대한 선택을 보유하는 트리 모델.
popup-shown gboolean TRUE로 설정 시, 콤보 박스는 현재 선택을 표시한다. notify 시그널과 이 프로퍼티를 연결하면 사용자에게 팝업 창이 표시될 때 알림을 받을 수 있다.
row-span-column gint 이 프로퍼티는 수직 방향이라는 점만 제외하면 column-span-column과 동일한 기능을 수행한다.
tearoff-title gchararray 콤보 박스 선택을 표시하는 팝업 창을 본래 위치에서 분리할(tear) 때 표시할 제목.
wrap-width gint 이 프로퍼티를 양의 정수로 설정하면 리스트를 다수의 열에 걸쳐 표시할 수 있다. 이 프로퍼티는 열의 개수를 정의한다.
표 A-25. GtkComboBox 프로퍼티


프로퍼티 타입 설명
text-column gint G_TYPE_STRING의 GType으로 된 데이터를 보유하는 GtkTreeModel 내의 열 번호.
표 A-25. GtkComboBox 프로퍼티


프로퍼티 타입 설명
border-width guint 컨테이너의 자식의 외부를 따라 위치시킬 픽셀 수를 정의하는 정수.
child GtkWidget 컨테이너의 자식 위젯. 이 프로퍼티를 이용해 컨테이너로 새로운 자식을 추가할 수 있다. 하지만 컨테이너에 다수의 자식이 있는 경우 이 프로퍼티를 이용해선 안 된다.
resize-mode GtkResizeMode 컨테이너와 그 자식의 크기 조정 요청을 처리하는 방법을 정의한다.
표 A-25. GtkComboBox 프로퍼티


프로퍼티 타입 설명
curve-type GtkCurveType 곡선의 타입. 예를 들어, 곡선의 타입으로는 선형, 스팔라인 보간형(spline interpolated), 자유형(freeform)이 있다.
max-x (max-y) gfloat 최대 x 또는 y 값을 정의하는 숫자.
min-x (min-y) gfloat 최소 x 또는 y 값을 정의하는 숫자.
표 A-28. GtkCurve 프로퍼티


프로퍼티 타입 설명
has-separator gboolean TRUE로 설정 시, 대화상자의 GtkVBow 위젯과 그 액션 영역 사이에 구분자가 위치할 것이다.
표 A-29. GtkDialog 프로퍼티


프로퍼티 타입 설명
activates-default gboolean TRUE로 설정 시, 사용자가 Enter 키를 누르면 창의 기본 창이 활성화될 것이다.
cursor-position gint 0과 65,535 사이의 정수값으로, GtkEntry 위젯 내에서 현재 커서 위치를 정의한다.
editable gboolean TRUE로 설정 시, 사용자는 GtkEntry 위젯의 내용을 편집할 수 있다.
has-frame gboolean TRUE로 설정 시, 위젯 주변에 테두리가 위치할 것이다.
inner-border GtkBorder 텍스트 네 개의 면에 추가될 공간을 정의하는 객체.
invisible-char guint visibility가 FALSE로 설정되면 실제 텍스트 대신 이 문자가 표시될 것이다. 이 프로퍼티는 비밀번호 엔트리를 구현하는 데에 종종 사용된다.
max-length gint GtkEntry가 수락하게 될 텍스트의 최대 길이로, 제한이 없어야 한다면 0을 이용하라. GtkEntry는 최대 65,535개 문자로 된 문자열을 처리할 수 있다.
scroll-offset gint 위젯의 좌측으로 스크롤 오프(scroll off)되는 GtkEntry 내용의 픽셀 수를 설명하는 정수.
selection-bound gint 문자 개수에서 선택내용(selection) 중 cursor-position의 반대편에 해당하는 정수 색인.
text gchararray GtkEntry의 현재 내용.
truncate-multiline gboolean TRUE로 설정 시, 사용자가 여러 행에 걸쳐 표시된 텍스트를 GtkEntry 위젯으로 붙여 넣으면 첫 번째 행만 삽입될 것이다.
visibility gboolean FALSE로 설정할 경우, GtkEntry 위젯 내 모든 문자는 invisibility-char로 대체될 것이다.
width-chars gint 사용자에게 표시할 문자 개수. GtkEntry는 보통 이 프로퍼티를 수용하도록 크기가 조정될 것이다.
xalign gfloat 0.0과 1.0 사이 값으로 설명되는 GtkEntry 위젯 내 텍스트의 정렬을 정의하는 값으로, 0.0과 1.0 사이 값이어야 하며 0.5는 중앙 정렬을 의미한다.
표 A-30. GtkEntry 프로퍼티


프로퍼티 타입 설명
inline-completion gboolean TRUE로 설정 시, 모든 선택에 공통된 접두사가 텍스트가 추가될 것이다. 이 프로퍼티가 효과를 발휘하기 위해서는 text-column을 설정해야 한다.
minimum-key-length gint 매치를 모두 표시하기 전에 GtkEntry 위젯에 입력해야 하는 최소 문자 수.
model GtkTreeModel 모든 가능한 선택을 보유하는 트리 모델. 열들 중 하나는 G_TYPE_STRING의 GType을 가져야 한다.
popup-completion gboolean TRUE로 설정 시, 모든 가능한 매치가 팝업 창에 표시될 것이다.
popup-set-width gboolean TRUE로 설정 시, 팝업 창의 너비는 GtkEntry 위젯과 동일해질 것이다.
popup-single-match gboolean TRUE로 설정 시, 선택이 하나에 불과하더라도 팝업 창이 표시될 것이다. inline-completion이 TRUE로 설정될 경우 이 프로퍼티를 FALSE로 설정해야 한다.
text-column gint model 프로퍼티 내에서 G_TYPE_STRING의 GType을 가진 열의 색인. 이 열은 매치의 내용을 제공할 것이다.
표 A-31. GtkEntryCompletion 프로퍼티


프로퍼티 타입 설명
above-child gboolean TRUE로 설정 시, 이벤트 박스는 그 내부에서 발생하는 모든 이벤트를 수신할 것이다. 그 외의 경우 이벤트는 자식으로 먼저 간 다음 이벤트 박스로 갈 것이다.
visible-window gboolean TRUE로 설정 시, 이벤트 박스가 사용자에게 표시된다.
표 A-32. GtkEventBox 프로퍼티


프로퍼티 타입 설명
expanded gboolean TRUE로 설정 시, 익스펜더가 현재 그 자식 위젯을 표시하고 있다.
label gchararray 익스팬더의 화살표 옆에 표시할 텍스트 문자열.
label-widget GtkWidget label이 정의한 텍스트 대신 익스팬더의 화살표 옆에 표시할 GtkWidget.
spacing gint 익스팬더의 라벨과 그 자식 위젯 사이에 위치시킬 공간의 양을 나타내는 정수.
use-markup gboolean TRUE로 설정 시, label 내 어느 Pango 마크업이든 파싱 및 적용될 것이다.
use-underline gboolean TRUE로 설정 시, 니모닉 키보드 가속기가 label에서 지원될 것이다.
표 A-33. GtkExpander 프로퍼티


프로퍼티 타입 설명
action GtkFileChooserAction 파일 선택자가 실행하는 기능.
do-overwrite-confirmation gboolean TRUE로 설정 시, GTK_FILE_CHOOSER_ACTION_SAVE의 action은 사용자에게 파일이 이미 존재하는지 확인을 요청할 것이다.
extra-widget GtkWidget 사용자에게 추가 옵션을 제공하는 데에 사용할 수 있는 보완적 위젯.
file-system-backend gchararray 파일 시스템 백엔드를 참조하는 이름.
filter GtkFileFilter 현재 선택된 파일 필터로, 어떤 파일을 표시할 것인지 필터링 시 사용된다.
local-only gboolean TRUE로 설정 시, 로컬 파일만 선택으로 표시될 것이다.
preview-widget GtkWidget 선택된 파일의 내용을 미리보기할 때 이용할 위젯.
preview-widget-active gboolean preview-widget을 사용하길 원할 경우 이를 표시하려면 해당 프로퍼티를 TURE로 설정해야 한다.
select-multiple gboolean TRUE로 설정 시, 사용자는 다수의 파일을 선택할 수 있을 것이다.
show-hidden gboolean TRUE로 설정 시, 숨겨진 파일과 폴더가 파일 선택자에 표시될 것이다.
use-preview-label gboolean TRUE로 설정 시, 현재 미리보기를 실행한 파일명과 함께 라벨이 표시될 것이다.
표 A-34. GtkFileChooser 프로퍼티


프로퍼티 타입 설명
dialog GtkFileChooserDialog 사용자가 버튼을 클릭하면 표시되는 파일 선택자 대화상자.
focus-on-click gboolean TRUE로 설정 시, 사용자가 GtkFileChooserButton 위젯을 클릭하면 해당 위젯이 포커스를 잡을 것이다.
title gchararray 사용자가 버튼을 클릭하면 표시되는 GtkFileChooserDialog 위젯의 제목.
width-chars gint 파일 선택자 버튼 내에 라벨의 너비를 문자로 표시한 것.
표 A-35. GtkFileChooserButton 프로퍼티


프로퍼티 타입 설명
font-name gchararray "Monospace Bold 10"와 같이 현재 선택된 글꼴명.
show-size gboolean TRUE로 설정 시, 글꼴 크기가 글꼴 버튼의 라벨에 표시될 것이다.
show-style gboolean TRUE로 설정 시, 글꼴 스타일이 글꼴 버튼의 라벨에 표시될 것이다.
title gchararray 사용자가 버튼을 클릭하면 표시되는 GtkFnotSelectionDialog 위젯의 제목.
use-font gboolean TRUE로 설정 시, 글꼴 버튼의 라벨은 그것을 그릴 때 선택된 글꼴을 이용할 것이다.
use-size gboolean TRUE로 설정 시, 글꼴 버튼의 라벨은 그것을 그릴 때 선택된 크기를 이용할 것이다.
표 A-36. GtkFontButton 프로퍼티


프로퍼티 타입 설명
font GdkFont GtkFontSelection에 현재 선택된 글꼴.
font-name gchararray 현재 선택된 글꼴을 나타내는 문자열.
preview-text gchararray 현재 선택된 글꼴의 미리보기로 표시할 텍스트.
표 A-37. GtkFontSelection 프로퍼티


프로퍼티 타입 설명
label gchararray GtkFrame의 라벨에 따라 표시되는 텍스트.
label-widget GtkWidget label 프로퍼티에서 텍스트 집합 대신 사용할 위젯.
label-xalign gfloat 라벨 내부에서 라벨의 수평 정렬로, 0.0과 1.0 사이의 값으로 정의된다.
label-yalign gfloat 라벨 내부에서 라벨의 수직 정렬로, 0.0과 1.0 사이의 값으로 정의된다.
shadow-type GtkShadowType GtkFrame이 사용하는 그림자 타입을 정의하는 플래그.
표 A-38. GtkFrame 프로퍼티


프로퍼티 타입 설명
handle-position GtkPositionType 자식 위젯을 기준으로 한 핸들의 위치.
shadow-type GtkShadowType GtkHandleBox 위젯이 사용하는 그림자 타입을 정의하는 플래그.
snap-edge GtkPositionType GtkHandleBox 위젯의 도킹(docking)에 사용될 스냅 에지(snap edge)의 위치. 이 프로퍼티가 효과를 발휘하기 위해서는 snap-edge-set을 TRUE로 설정해야 한다.
표 A-39. GtkHandleBox 프로퍼티


프로퍼티 타입 설명
column-spacing gint 아이콘의 열 사이에 넣을 공간의 양.
columns gint 아이콘을 정렬시킬 열의 개수. -1로 설정 시 이 값을 선택해줄 것을 GTK+로 알릴 것이다.
item-width gint 각 항목의 너비를 픽셀로 나타낸 값. -1로 설정 시 이 값을 선택해줄 것을 GTK+로 알릴 것이다.
margin gint GtkIconView의 변(edge)을 따라 위치시킬 패딩의 픽셀 수.
markup-column gint GtkTreeModel 위젯 내에 마크업에 관한 정보를 보유하는 열. 이 열은 G_TYPE_STRING의 Gtype을 가져야 한다.
model GtkTreeModel GtkIconView이 표시하는 데이터를 정의하는 트리 모델.
orientation GtkOrientation 서로를 기준으로 한 아이콘과 텍스트의 가로 및 수직 방향.
pixbuf-column gint GtkTreeModel 위젯 내에 아이콘을 포함하는 열. 이 열은 GDK_TYPE_PIXBUF의 GType을 가져야 한다.
reorderable gboolean TRUE로 설정 시, GtkIconView 위젯 내 항목들은 드래그 앤 드롭을 이용해 정렬할 수 있다.
row-spacing gint 아이콘의 행 사이에 넣을 공간의 양.
selection-mode GtkSelectionMode 아이콘 뷰의 선택 모드.
spacing gint 항목과 그 주위 항목들(neighbors) 사이에 넣을 공간의 픽셀 수.
text-column gint GtkTreeModel에서 각 항목의 텍스트를 포함하는 열. 이 열은 G_TYPE_STRING의 GType을 가져야 한다.
표 A-40. GtkIconView 프로퍼티


프로퍼티 타입 설명
file gchararray 아이콘 이미지의 위치를 명시하는 파일명.
icon-name gchararray 현재 아이콘 테마로부터의 아이콘. 아이콘 테마가 변경되면 이 또한 자동으로 업데이트된다. 이 아이콘의 크기는 icon-size에서 정의된다.
icon-set GtkIconSet 아이콘으로 표시할 GtkIconSet. 이 아이콘의 크기는 icon-size에서 정의된다.
icon-size gint icon-name, icon-set, stock 중 하나를 이용할 경우 해당 프로퍼티를 이용해 GtkIconSize에서 정의된 아이콘 크기를 명시할 수 있다.
image GdkImage 아이콘으로 표시할 이미지. GdkPixbuf로 아이콘을 가리길(mask) 원한다면 mask를 이용하라.
mask GdkPixmap image 또는 pixmap이 제공하는 아이콘을 가리는 데에 사용되는 pixmap.
pixbuf GdkPixbuf 아이콘으로 표시할 pixbuf.
pixbuf-animation GdkPixbufAnimation 아이콘으로 표시할 움직이는(animated) 이미지로, animated pixbuf 객체에 해당한다.
pixel-size gint 크기는 픽셀로 되어 있어야 한다. 이미지가 icon-name을 이용해 명시된 경우 이 프로퍼티는 icon-size보다 우선한다.
pixmap GdkPixmap 이미지로 표시할 pixmap. GdkPixbuf로 아이콘을 가리길 원한다면 mask를 이용하라.
stock gchararray 아이콘으로 표시할 이미지에 대한 스톡 식별자. 이 아이콘의 크기는 icon-size에서 정의된다.
storage-type GtkImageType GtkImage가 사용 중인 이미지 보관 타입(image storage type).
표 A-41. GtkImage 프로퍼티


프로퍼티 타입 설명
image GtkWidget 메뉴 항목의 라벨 옆에 표시할 위젯.
표 A-42. GtkImageMenuItem 프로퍼티


프로퍼티 타입 설명
screen GdkScreen GtkInvisible 창이 표시되는 화면.
표 A-43. GtkInvisible 프로퍼티


프로퍼티 타입 설명
angle gdouble x 축을 기준으로 0.0과 360.0 사이의 값에 해당하는 텍스트 각도로, 반시계 방향으로 회전한다. 예를 들어, 90.0 값의 경우 텍스트 하단이 화면의 우측면에 위치할 것이다. ellipsize, selectable, wrapped 중 하나를 설정했다면 이 프로퍼티는 무시될 것이다.
attributes PangoAttrList 라벨의 텍스트에 적용되는 속성의 리스트.
cursor-position gint selectable을 TRUE로 설정 시, 이 프로퍼티는 라벨의 텍스트 내에 커서의 위치를 설정할 것이다.
ellipsize PangoEllipsizeMode 전체 문자열을 표시하기에 공간이 충분치 않은 경우 문자열 내에서 텍스트를 타원으로 대체하기 위한 장소. 이 프로퍼티가 효과를 발휘하기 위해서는 ellipsize-set을 TRUE로 설정해야 한다.
justify GtkJustification 라벨의 맞춤(justification). 자식 라벨 내에서 라벨을 정렬하는 데에 사용되는 것이 아니라 여러 행에 걸쳐 위치한 라벨을 맞추는 데에 사용된다.
label gchararray 라벨이 표시하게 될 텍스트 문자열.
max-width-chars gint 단일 행에 표시할 최대 문자의 수. -1로 설정 시 자동으로 계산될 것이다. 이 프로퍼티는 max-chars로 오버라이드된다.
mnemonic-keyval gint 라벨의 니모닉 키보드 가속기에 대한 키 값.
mnemonic-widget GtkWidget 라벨의 니모닉 키보드 가속기가 활성화될 때 활성화되는 위젯.
pattern gchararray 표시해야 할 텍스트 문자열로, 밑줄 문자는 밑줄을 그어야 할 문자를 지정한다.
selectable gboolean TRUE로 설정 시, 사용자는 마우스로 라벨을 선택할 수 있을 것이다.
selection-bound gint 선택된 텍스트의 cursor-position 반대쪽 끝의 위치. 선택된 텍스트가 없다면 cursor-position과 동일한 값이 될 것이다.
single-line-mode gboolean TRUE로 설정 시, 라벨은 하나의 텍스트 행으로 강제로 이동할 것이다.
use-markup gboolean TRUE로 설정 시, 라벨 텍스트 내 Pango 마크업이 파싱될 것이다.
use-underline gboolean TRUE로 설정 시, 니모닉 키보드 가속기에 사용할 키를 지정하기 위해 밑줄 문자가 사용될 것이다.
width-chars gint 라벨의 너비를 문자로 나타낸 값. 이 프로퍼티를 -1로 설정할 경우 자동으로 GTK+가 계산해줄 것이다. 이 프로퍼티는 max-width-chars보다 우선한다.
wrap gboolean TRUE로 설정 시, 한 행에 들어가지 않으면 라벨은 래핑될 것이다.
wrap-mode PangoWrapMode wrap이 TRUE로 설정되면 실행되어야 하는 래핑 타입.
표 A-44. GtkLabel 프로퍼티


프로퍼티 타입 설명
hadjustment GtkAdjustment 위젯을 스크롤 시 이용되는 수평적 조정.
height guint GtkLayout 위젯의 높이를 픽셀로 나타낸 값. 위젯은 내부적으로(natively) 스크롤링을 지원하므로 높이는 화면의 높이보다 클 수 있다.
vadjustment GtkAdjustment 위젯을 스크롤 시 이용되는 수직적 조정.
width guint GtkLayout 위젯의 너비를 픽셀로 나타낸 값. 위젯은 내부적으로(natively) 스크롤링을 지원하므로 높이는 화면의 너비보다 클 수 있다.
표 A-45. GtkLayout 프로퍼티


프로퍼티 타입 설명
uri gchararray 링크 버튼이 방문하는 웹 사이트의 URI. http://www.gtkbook.com 과 같이 완전한 URI여야 한다.
표 A-46. GtkLinkButton 프로퍼티


프로퍼티 타입 설명
tearoff-state gboolean TRUE로 설정 시, 메뉴는 부착된 위젯으로부터 분리할 수 있다.
tearoff-title gchararray 메뉴를 그에 부착된 위젯에서 분리할 때 표시할 제목.
표 A-47. GtkMenu 프로퍼티


프로퍼티 타입 설명
child-pack-direction GtkPackDirection 자식의 메뉴 항목을 패킹하는 방향.
pack-direction GtkPackDirection 자식 메뉴 항목을 패킹하는 방향.
표 A-48. GtkMenuBar 프로퍼티


프로퍼티 타입 설명
take-focus gboolean TRUE로 설정 시, 메뉴와 하위메뉴는 키보드에서 포커스를 잡을 것이다.
표 A-49. GtkMenuShell 프로퍼티


프로퍼티 타입 설명
menu GtkMenu 사용자가 툴 버튼 옆의 화살표 모양을 클릭할 때 표시할 메뉴.
표 A-50. GtkMenuToolButton 프로퍼티


프로퍼티 타입 설명
buttons GtkButtonType 메시지 대화상자의 액션 영역에 표시되는 버튼(들).
image GtkWidget GtkMessageDialog에 표시할 위젯 이미지.
message-type GtkMessageType GtkMessageDialog가 보고하는 메시지 타입. 메시지 타입은 image가 설정되지 않을 시 대화상자에 표시되는 이미지를 정의한다.
secondary-text gchararray text에 정의된 문자열 아래에 표시되는 2차(secondary) 텍스트.
secondary-use-markup gboolean TRUE로 설정 시, secondary-text 에서 마크업이 파싱될 것이다.
text gchararray 대화상자가 표시하는 메인 텍스트로, 이차 텍스트 위에 표시될 것이다.
use-markup gboolean TRUE로 설정 시, text 에서 마크업이 파싱될 것이다.
표 A-51. GtkMessageDialog 프로퍼티


프로퍼티 타입 설명
xalign(yalign) gfloat 수평 또는 수직 정렬로, 0.0과 1.0 사이의 값으로 정의되는데 0.5는 중앙 정렬을 의미한다.
xpad(ypad) gint 위젯의 어떤 변으로든 추가되는 패딩의 픽셀 값
표 A-52. GtkMisc 프로퍼티


프로퍼티 타입 설명
enable-popup gboolean TRUE로 설정 시, 사용자가 탭 위를 오른쪽 마우스로 클릭하면 다른 페이지를 살펴볼 수 있는 팝업 메뉴가 표시될 것이다.
group-id gint GtkNotebook 탭에서 드래그 앤 드롭 연산에 사용되는 정수 그룹 식별자.
homogeneous gboolean TRUE로 설정 시, 모든 GtkNotebook 탭의 너비가 동일해질 것이다.
page gint 현재 선택된 페이지의 색인으로, 0부터 색인된다.
scrollable gboolean TRUE로 설정 시, 스크롤 탭의 공간이 충분치 않으면 탭을 스크롤하도록 화살표가 그려질 것이다.
show-border gboolean TRUE로 설정 시, 테두리가 표시될 것이다.
show-tabs gboolean TRUE로 설정 시, 탭이 사용자에게 표시될 것이다.
tab-border gint 각 탭 라벨 주위에 위치하는 테두리 너비.
tab-hborder gint 각 탭 라벨 주위에 위치하는 가로 테두리의 너비.
tab-pos GtkPositionType GtkNotebook 자식을 기준으로 한 탭의 위치.
tab-vborder gint 각 탭 라벨 주위에 위치한 세로 테두리의 너비.
표 A-53. GtkNotebook 프로퍼티


프로퍼티 타입 설명
user-data gpointer GtkObject와 연관된 데이터 조각으로 gpointer 타입이다.
표 A-54. GtkObject 프로퍼티


프로퍼티 타입 설명
max-position gint 패인(pane)의 최대 위치로, 자식의 타입과 크기를 바탕으로 계산된다.
min-position gint 패인의 최소 위치로, 자식의 타입과 크기를 바탕으로 계산된다.
position gint 구분자의 위치를 명시적으로 설정하는 데에 사용되는 프로퍼티로, 0은 상단면 또는 좌측면을 의미한다. 이 프로퍼티가 효과를 발휘하기 위해서는 position-set을 TRUE로 설정해야 한다.
표 A-55. GtkPaned 프로퍼티


프로퍼티 타입 설명
accepts-pdf gboolean TRUE로 설정 시, 프린터가 PDF 파일을 수락할 수 있을 것이다.
accepts-ps gboolean TRUE로 설정 시, 프린터가 PostScript 파일을 수락할 수 있을 것이다.
backend GtkPrintBackend GtkPrinter가 사용하는 프린트 백엔드(print backend).
icon-name gchararray GtkPrinter에 사용할 아이콘명.
is-virtual gboolean TRUE로 설정 시, GtkPrinter는 가상 프린터로, 실제 하드웨어를 나타내지 않을 수도 있다.
job-count gint 현재 GtkPrint가 이용 가능해지길 기다리는 인쇄 작업의 개수.
location gchararray 프린터의 위치를 설명하는 문자열.
name gchararray 프린터를 식별하는 유일한 이름.
state-message gchararray 현재 프린터의 상태에 관한 정보를 추가로 제공하는 문자열.
표 A-56. GtkPrinter 프로퍼티


프로퍼티 타입 설명
page-setup GtkPageSetup 인쇄 작업과 연관된 페이지 셋업. 이 프로퍼티는 페이지 방향이나 용지 크기와 같은 정보를 보유한다.
printer GtkPrinter 인쇄 작업을 처리하는 데에 선택된 프린터.
settings GtkPrintSettings 인쇄 작업에 연관된 인쇄 설정. 이 프로퍼티는 사본 수, 인쇄 품질, 해상도와 같은 정보를 보유한다.
title gchararray 실현 가능하도록 인쇄 작업에 주어진 제목. 주로 자신의 애플리케이션에서 설정한 인쇄 작업과 다른 곳에서 설정한 인쇄 작업을 구별한다.
tack-print-settings gboolean TRUE로 설정 시, 인쇄 작업이 프린터로 전달된 후에도 status-chaned 시그널은 계속 발생할 것이다.
표 A-57. GtkPrintJob 프로퍼티


프로퍼티 타입 설명
current-page gint 문서로부터 현재 페이지. 이 프로퍼티를 -1로 설정하면 Range 옵션이 선택 가능한 상태가 된다.
page-setup GtkPageSetup 인쇄 대화상자와 연관된 페이지 셋업. 이 프로퍼티는 페이지 방향이나 용지 크기와 같은 정보를 보유한다.
print-settings GtkPrintSettings 인쇄 대화상자와 연관된 인쇄 설정. 이 프로퍼티는 사본 수, 인쇄 품질, 해상도와 같은 정보를 보유한다.
selected-printer GtkPrinter 인쇄 대화상자에서 선택된 프린터.
표 A-58. GtkPrintUnixDialog 프로퍼티


프로퍼티 타입 설명
ellipsize PangoEllipsizeMode 전체 문자열을 표시하기에 공간이 충분치 않은 경우 문자열 내에서 텍스트를 타원으로 대체하기 위한 장소. 이 프로퍼티가 효과를 발휘하기 위해서는 ellipsize-set을 TRUE로 설정해야 한다.
fraction gdouble 상태 표시줄이 채워진 양으로, 0.0부터 1.0까지 숫자로 정의되는데 1.0은 완전히 채워짐을 의미한다.
orientation GtkProgressBarOrientation 진행 막대가 채워지는 방향.
pulse-step gdouble 진행 막대가 펄싱될 때 진행 막대를 따라 움직이는 거리를 설정한다. 예를 들어, pulse-step이 0.1로 설정되면 블록이 진행 막대의 한쪽 끝에서 반대편 끝으로 이동하려면 진행 막대가 10회 펄싱될 것이다.
text gchararray 진행 막대의 상단에 인쇄할 텍스트.
표 A-59. GtkProgressBar 프로퍼티


프로퍼티 타입 설명
current-value gint 현재 활성화된 액션 그룹의 member에 대한 value.
group GtkRadioAction 라디오 액션이 속한 라디오 그룹을 명시하는 라디오 액션.
value gint 라디오 그룹에서 GtkRadioAction에 유일한 정수. 이 프로퍼티를 current-value와 함께 이용하면 현재 활성화된 라디오 액션을 찾을 수 있다.
표 A-60. GtkRadioAction 프로퍼티


프로퍼티 타입 설명
group GtkWidget 라디오 위젯을 동일한 라디오 그룹 내 다른 위젯으로 연결하는 라디오 버튼, 라디오 메뉴 항목 또는 라디오 툴 버튼.
표 A-61. GtkRadioButton, GtkRadioMenuItem, GtkRadioToolButton 프로퍼티


프로퍼티 타입 설명
adjustment GtkAdjustment 경계(bound)를 비롯해 GtkRange의 현재 값을 보유하는 조정.
inverted gboolean TRUE로 설정 시, 슬라이더는 더 큰 값과 작은 값의 위치를 전환할 것이다.
lower-stepper-sensitivity GtkSensitivityType 활성화되면 GtkAdjustment 객체의 값을 감소시키는 버튼과 연관된 민감도.
update-policy GtkUpdateType GtkRange가 화면에서 어떻게 업데이트되어야 하는지를 정의한다.
upper-stepper-sensitivity GtkSensitivityType 활성화되면 GtkAdjustment 객체의 값을 증가시키는 버튼과 연관된 민감도.
표 A-62. GtkRange 프로퍼티


프로퍼티 타입 설명
filter GtkRecentFilter 현재 선택된 파일 필터로, 사용자에게 어떤 자원을 표시하는지 결정하는 데에 사용된다.
limit gint GtkRecentChooser에 표시되는 최대 항목의 개수. 제한을 없애려면 -1로 설정하라. 이 프로퍼티는 GtkRecentChooserMenu를 이용 시 설정되어야만 팝업 메뉴가 조작하기 힘들어지는 상황을 피할 수 있다.
local-only gboolean TRUE로 설정 시, file:// 접두사가 붙은 자원만 표시될 것이다.
recent-manager GtkRecentManager 표시해야 할 현재 사용된 자원을 보유하는 관리자. 현재 화면에서 기본 GtkRecentManager를 검색하기 위해서는 gtk_recent_manager_get_default()를 이용할 수 있다.
select-multiple gboolean TRUE로 설정 시, 사용자는 리스트에서 다수의 자원을 선택할 수 있다.
show-icons gboolean TRUE로 설정 시, 각 자원 옆에 아이콘이 표시되어 MIME 타입 등 자원에 관한 정보를 제공한다.
show-not-found gboolean 이 프로퍼티를 FALSE로 설정하면 더 이상 이용할 수 없는 파일을 숨길 수 있다. 로컬 자원에만 영향을 미치는 프로퍼티임을 주목해야 한다.
show-private gboolean TRUE로 설정 시, 특정 애플리케이션에 private하게 설정된 항목이 표시될 것이다.
show-tips gboolean TRUE로 설정 시, 각 항목에 툴팁이 이용 가능하다면 툴팁이 표시될 것이다.
sort-type GtkRecentSortType 최근 자원 리스트를 정렬하는 데에 사용할 방법.
표 A-63. GtkRecentChooser 프로퍼티


프로퍼티 타입 설명
show-numbers gboolean TRUE로 설정 시, 메뉴에서 가장 최근의 자원 10개 앞에 번호가 붙을 것이다.
표 A-64. GtkRecentChooserMenu 프로퍼티


프로퍼티 타입 설명
filename gchararray 최근 사용된 자원의 리스트를 저장하는 파일의 위치.
limit gint 최근 사용된 자원의 최대수로, gtk_recent_manager_get_items()가 호출되면 GtkRecentManager가 이 값을 리턴하게 될 것이다.
size gint 최근 사용된 자원의 리스트 내 총 항목의 개수.
표 A-65. GtkRecentManager 프로퍼티


프로퍼티 타입 설명
lower gdouble 눈금자(ruler)가 표시하는 가장 작은 값.
max-size gdouble 눈금자의 최대 크기. 이 값을 0.0으로 설정하면 크기가 제한되지 않는다.
metric GtkMetricType 눈금자가 사용하는 단위의 타입으로, 픽셀, 인치, 센티미터가 있다.
position gdouble 눈금자의 마커의 현재 위치.
upper gdouble 눈금자가 표시하는 가장 큰 값.
표 A-66. GtkRuler 프로퍼티


프로퍼티 타입 설명
digits gint 표시된 값의 최대 소수 자리수로, 64까지 가능하다. 이 프로퍼티를 -1로 설정 시 이 값을 선택해줄 것을 GTK+로 알릴 것이다.
draw-value gboolean TRUE로 설정 시, 슬라이더 옆에 값이 표시될 것이다.
value-pos GtkPositionType 슬라이더를 기준으로 GtkScale 값의 위치.
표 A-67. GtkScale 프로퍼티


프로퍼티 타입 설명
hadjustment GtkAdjustment 수평 스크롤바에 대한 조정.
hscrollbar-policy GtkPolicyType 수평 스크롤바를 항상 표시할 것인지, 항상 숨길 것인지, 아니면 필요할 때만 표시할 것인지 정의한다.
shadow-type GtkShadowType 자식 위젯 주위에 위치시킬 그림자 타입.
vadjustment GtkAdjustment 수직 스크롤바에 대한 조정.
vscrollbar-policy GtkPolicyType 수직 스크롤바를 항상 표시할 것인지, 항상 숨길 것인지, 아니면 필요할 때만 표시할 것인지 정의한다.
window-placement(set) GtkCornerType 스크롤바를 기준으로 한 자식 위젯의 배치. 이 프로퍼티가 효과를 발휘하기 위해서는 window-placement-set을 TRUE로 설정해야 한다.
표 A-68. GtkScrolledWindow 프로퍼티


프로퍼티 타입 설명
draw gboolean TRUE로 설정 시, 화면에 구분자 툴팁이 그려질 것이다. 그 외의 경우 해당 자리에 빈 공간이 추가될 것이다.
표 A-69. GtkSeparatorToolItem 프로퍼티


프로퍼티 타입 설명
ignore-hidden gboolean TRUE로 설정 시, 화면에 표시되지 않은 위젯은 그룹의 크기를 계산할 때 무시될 것이다.
mode GtkSizeGroupMode 크기 그룹이 자식의 크기를(들을) 어떻게 결정하는지를 정의하는 플래그.
표 A-70. GtkSizeGroup 프로퍼티


프로퍼티 타입 설명
adjustment GtkAdjustment 스핀 버튼의 값과 경계에 관한 정보를 보유하는 조정.
climb-rate gdouble 화살표 버튼을 누를 때 가속 속도.
digits guint 0과 20 사이의 숫자로, 표시할 값의 소수 자리수에 해당한다.
numeric gboolean TRUE로 설정 시, 수치 문자만 스핀 버튼에 의해 실현될 것이다.
snap-to-ticks gboolean TRUE로 설정 시, 값이 자동으로 업데이트되고 가장 가까운 단계 증가값(step increment)에 맞추어 조정될 것이다.
update-policy GtkSpinButtonUpdatePolicy 스핀 버튼이 얼마나 자주 그리고 언제 업데이트될 것인지 결정하는 플래그.
value gdouble 스핀 버튼이 저장한 현재 값. 스핀 버튼의 조정과 상호작용하는 대신 이 값을 읽고 쓸 수 있다.
wrap gboolean 스핀 버튼이 그것의 상단 또는 하단 경계에 도달하고 이 프로퍼티를 TRUE로 설정하면 스핀 버튼 값이 반대편 끝으로 래핑할 것이다.
표 A-71. GtkSpinButton 프로퍼티


프로퍼티 타입 설명
has-resize-grip gboolean 이 프로퍼티를 TRUE로 설정 시 GtkStatusbar 위젯이 그래픽을 표시하면서 사용자가 마우스로 창을 이동시켜 크기를 변경하도록 해준다.
표 A-72. GtkStatusbar 프로퍼티


프로퍼티 타입 설명
blinking gboolean TRUE로 설정 시, 이 행위가 지원되는 플랫폼에서는 상태 아이콘이 깜빡거릴 것이다.
file gchararray 상태 아이콘으로 표시할 아이콘의 위치.
icon-name gchararray 아이콘 테마 중에서 상태 아이콘으로 표시할 아이콘.
pixbuf GdkPixbuf 상태 아이콘으로 표시할 이미지.
size gint 표시할 아이콘의 크기.
stock gchararray 상태 아이콘으로 표시할 아이콘을 정의하는 스톡 식별자.
storage-type GtkImageType 표시할 이미지 타입. file, icon-name, pixbuf, stock 중 무엇을 사용할 것인지 식별 시 사용된다.
visible gboolean TRUE로 설정 시, 상태 아이콘이 시스템 트레이를 통해 사용자에게 표시될 것이다.
표 A-73. GtkStatusIcon 프로퍼티


프로퍼티 타입 설명
column-spacing guint 하나의 열과 그 주위 대상들 사이에 추가할 공간의 픽셀 수.
homogeneous gboolean TRUE로 설정 시, 모든 셀에 동일한 높이와 너비가 주어질 것이다.
n-columns guint GtkTable 내에 총 열의 개수.
n-rows guint GtkTable 내에 총 행의 개수.
row-spacing guint 하나의 행과 그 주위 대상들 사이에 추가할 공간의 픽셀 수.
표 A-74. GtkTable 프로퍼티


프로퍼티 타입 설명
copy-target-list GtkTargetList 클립보드에서 복사하기와 드래그 앤 드롭 소스에 관한 정보를 저장하는 데에 사용되는 버퍼에 대한 목표 리스트(target list).
cursor-position gint 버퍼 내에서 커서의 현재 위치. 커서가 이동할 때를 알기 위해서는 notify 시그널을 이용해 이 프로퍼티를 감시할 수 있다.
has-selection gboolean TRUE로 설정 시, 텍스트 버퍼가 현재 선택된 텍스트를 갖는다.
paste-target-list GtkTargetList 클립보드에서 붙여넣기와 드래그 앤 드롭 목적지에 관한 정보를 저장하는 데에 사용되는 버퍼에 대한 목표 리스트(target list).
tag-table GtkTextTagTable 텍스트 버퍼가 사용하는 모든 텍스트 태그를 보유하는 텍스트 태그 테이블.
text gchararray 포함된 이미지나 자식 위젯을 제외하고 텍스트 버퍼에 현재 포함된 텍스트.
표 A-75. GtkTextBuffer 프로퍼티


프로퍼티 타입 설명
accepts-tab gboolean TRUE로 설정 시, 탭 순서에서 다음 위젯으로 포커스를 주는 대신 Tab 키를 눌러야 텍스트 뷰가 탭 문자를 삽입할 것이다.
buffer GtkTextBuffer 현재 텍스트 뷰가 표시하는 텍스트 버퍼.
cursor-visible gboolean TRUE로 설정 시, 커서가 사용자에게 표시될 것이다.
editable gboolean TRUE로 설정 시, 사용자는 텍스트 뷰의 내용을 편집할 수 있을 것이다.
indent gint 각 문단에 들여쓰기할 픽셀 수로, 기본값은 0으로 설정된다.
justification GtkJustification 텍스트의 왼쪽, 오른쪽, 또는 중앙 맞춤.
left-margin gint 텍스트 뷰의 왼쪽면과 내용 사이에 추가할 공간의 픽셀 수.
overwrite gboolean TRUE로 설정 시, 새 문자가 이미 존재하는 문자를 덮어쓸 것이다. 그 외의 경우 새 문자가 삽입된다.
pixels-above-lines gint 각 문단 위에 위치시킬 패딩의 픽셀 수.
pixels-below-lines gint 각 문단의 아래에 위치시킬 패딩의 픽셀 수.
pixels-inside-wrap gint 문단 내에서 래핑된 행들 사이에 위치시킬 패딩의 픽셀 수.
right-margin gint 텍스트 뷰의 우측면과 내용 사이에 추가할 공간의 픽셀 수.
tabs PangoTabArray 사용자가 Tab 키를 누르면 추가될 내용을 정의하는 탭 배열.
wrap-mode GtkWrapMode 실행할 래핑 타입.
표 A-76. GtkTextView 프로퍼티


프로퍼티 타입 설명
active gboolean TRUE로 설정 시, GtkToggleAction이 체크되어 그려질 것이다.
draw-as-radio gboolean TRUE로 설정 시, GtkToggleAction이 라디오 버튼으로 그려질 것이다.
표 A-77. GtkToggleAction 프로퍼티


프로퍼티 타입 설명
active gboolean TRUE로 설정 시, GtkToggleButton이 체크되어 그려질 것이다.
draw-indicator gboolean TRUE로 설정 시, GtkToggleButton의 토글면이 표시될 것이다.
inconsistent gboolean TRUE로 설정 시, 토글 버튼의 상태는 활성화 상태도, 비활성화 상태도 아닌 중간 상태가 될 것이다.
표 A-78. GtkToggleButton 프로퍼티


프로퍼티 타입 설명
active gboolean TRUE로 설정 시, GtkToggleToolButton이 체크되어 그려질 것이다.
표 A-79. GtkToggleToolButton 프로퍼티


프로퍼티 타입 설명
icon-size GtkIconSize 툴바 아이콘의 크기. 이 프로퍼티는 특수 툴바에만 이용해야 한다. 대부분의 경우 사용자가 선택한 테마를 따라야 한다. 이 프로퍼티가 효과를 발휘하기 위해서는 icon-size-set을 TRUE로 설정해야 한다.
orientation GtkOrientation 툴바의 방향으로, 수평 또는 수직 중 하나다.
show-arrow gboolean TRUE로 설정 시, 툴바 항목이 알맞게 들어맞지 않으면 화살표가 표시될 것이다. 화살표는 오버플로 툴바 항목을 표시하는 팝업 메뉴로 접근하도록 해줄 것이다.
toolbar-style GtkToolbarStyle 텍스트 또는 아이콘이 표시되는지를 나타내는 툴바 스타일.
tooltips gboolean TRUE로 설정 시, 툴바 항목에 대해 툴팁이 표시될 것이다.
표 A-80. GtkToolbar 프로퍼티


프로퍼티 타입 설명
icon-name gchararray 아이콘 테마 중에서 표시할 아이콘명. label, icon-widget, stock-id 프로퍼티들은 icon-name보다 우선한다.
icon-widget GtkWidget 툴 버튼의 아이콘으로 표시할 위젯.
label gchararray 툴 버튼에 대한 라벨로 표시할 텍스트 문자열.
label-widget GtkWidget label 대신 툴 버튼의 라벨로 사용할 위젯.
stock-id gchararray 액션을 이용하는 위젯에 표시할 스톡 아이콘. 이 프로퍼티는 icon-name보다 우선한다.
use-underline gboolean TRUE로 설정 시, 밑줄 문자는 밑줄 다음의 문자를 니모닉 키보드 가속기로 지정할 것이다.
표 A-81. GtkToolButton 프로퍼티


프로퍼티 타입 설명
is-important gboolean 툴바가 GTK_TOOLBAR_BOTH_HORIZ의 toolbar-style을 이용할 때 이 프로퍼티를 TRUE로 설정하면 GTK+로 툴 버튼의 라벨을 표시할 것을 알린다. 그 외의 경우 아이콘만 표시될 것이다.
visible-horizontal gboolean TRUE로 설정 시, 툴바의 orientation이 GTK_ORIENTATION_HORIZONTAL로 설정되면 툴 항목이 표시될 것이다.
visible-vertical gboolean TRUE로 설정 시, 툴바의 orientation이 GTK_ORIENTATION_VERTICAL로 설정되면 툴 항목이 표시될 것이다.
표 A-82. GtkToolItem 프로퍼티


프로퍼티 타입 설명
child-model GtkTreeModel GtkTreeModelFilter에 의해 필터링되는 내용을 보유하는 트리 모델.
virtual-root GtkTreePath child-model에서 사용할 루트 행을 가리키는 트리 경로. 트리 모델의 절대적 루트 경로일 필요는 없다.
표 A-83. GtkTreeModelFilter 프로퍼티


프로퍼티 타입 설명
model GtkTreeModel GtkModelSort에 의해 정렬되는 내용을 보유하는 트리 모델.
표 A-84. GtkTreeModelSort 프로퍼티


프로퍼티 타입 설명
enable-grid-lines GtkTreeViewGridLines 수평 또는 수직 격자선을 위치시키는 플래그.
enable-search gboolean TRUE로 설정 시, 사용자는 키보드를 이용해 GtkTreeView의 내용을 검색할 수 있을 것이다.
enable-tree-lines gboolean TRUE로 설정 시, 트리 뷰 내용의 계층구조(hierarchy)를 정의하는 직선(line)이 그려질 것이다.
expander-column GtkTreeViewColumn GtkTreeStore를 이용해 트리 뷰에 대한 익스팬더가 표시되는 트리 뷰 열.
fixed-height-mode gboolean TRUE로 설정 시, GTK+는 모든 행의 높이가 동일할 것으로 추측하여 렌더링 속도를 높인다. 이 프로퍼티는 모든 행의 높이가 동일할 것이라고 확신할 때에만 이용해야 한다.
hadjustment GtkAdjustment 위젯의 스크롤에 사용되는 수평적 조정.
headers-clickable gboolean TRUE로 설정 시, 사용자는 열 헤더를 클릭할 수 있을 것이다.
headers-visible gboolean TRUE로 설정 시, 열 헤더가 사용자에게 표시될 것이다.
hover-expand gboolean TRUE로 설정 시, 마우스 포인터를 행 위에 갖다대면 행이 펼쳐지거나(expand) 접힐(collapse) 것이다.
hover-selection gboolean TRUE로 설정 시, GTK_SELECTION_SINGLE 또는 GTK_SELECTION_BROWSE 선택 모드 중 하나를 이용해 마우스 포인터를 행 위에 갖다대면 행이 선택될 것이다.
level-indentation gint 자식 행에 추가로 들여쓰기할 공간의 픽셀 수. 이 프로퍼티를 0으로 설정하더라도 자식 행은 여전히 기본 패딩으로 들여쓰기가 적용될 것이다.
model GtkTreeModel 현재 트리 뷰가 표시하는 트리 모델.
reoderable gboolean TRUE로 설정 시, 트리 뷰는 사용자 상호작용에 의해 재정렬 가능하다. 예를 들어, 개발자는 드래그 앤 드롭 지원을 구현할 수 있을 것이다.
rubber-banding gboolean TRUE로 설정 시, 사용자는 마우스 포인터를 드래그하여 다수의 항목을 선택할 수 있을 것이다.
rules-hint gboolean TRUE로 설정 시, 테마 엔진은 교호하는(alternating) 행을 다른 색상으로 그리도록 지시받는다. 이것은 힌트에 불과하며, 테마에서 유효하게 간주되지(honored) 않을지도 모른다는 사실을 명심한다. 또 일부 테마는 기본적으로 교호하는 행을 다른 색상으로 칠한다.
search-column gint enable-search가 TRUE로 설정될 때 검색할 행 번호.
show-expanders gboolean TRUE로 설정 시, 하나 또는 그 이상의 자식을 가진 행 옆에 익스팬더가 표시될 것이다.
vadjustment GtkAdjustment 위젯의 스크롤에 사용되는 수직적 조정.
표 A-85. GtkTreeView 프로퍼티


프로퍼티 타입 설명
alignment gfloat 헤더 내에서 열 제목의 수평적 정렬을 정의하는 값으로, 0.0과 1.0 사이 값이어야 하며 0.5는 중앙 정렬을 의미한다.
clickable gboolean TRUE로 설정 시, 사용자는 열 헤더를 클릭할 수 있을 것이다.
expand gboolean TRUE로 설정 시, 열이 확장되어 그것이 속한 GtkTreeView로 할당된 추가 공간을 채울 것이다.
fixed-width gint 열의 고정된 너비를 정의하는 픽셀 수.
max-width gint 열을 확장할 수 있는 최대 너비의 픽셀 수.
min-width gint 열을 축소할 수 있는 최소 너비의 픽셀 수.
reorderable gboolean TRUE로 설정 시, 열은 드래그 앤 드롭과 같은 방식을 이용해 재정렬할 수 있다.
resizable gboolean TRUE로 설정 시, 사용자는 열의 크기를 조정할 수 있을 것이다.
sizing GtkTreeViewColumnSizing 열에 대한 크기 조정 방식을 설정하는 플래그.
sort-indicator gboolean TRUE로 설정 시, 내용에 따라 트리 뷰가 정렬되었음을 나타내는 화살표가 열 헤더에 표시될 것이다.
sort-order GtkSortType 정렬 표시기(sort indicator)가 표시될 방향을 정의하는 플래그.
spacing gint 행과 그 주위 행들(neighbors) 사이에 추가되는 공간의 픽셀 수.
title gchararray 헤더에 표시되는 열의 제목.
visible gboolean TRUE로 설정 시, 열이 사용자에게 표시될 것이다.
widget GtkWidget 이 프로퍼티를 이용하면 열 헤더에 title 문자열 대신 위젯을 위치시킬 수 있다.
width gint 트리 뷰 열의 너비를 픽셀로 나타낸 값.
표 A-86. GtkTreeViewColumn 프로퍼티


프로퍼티 타입 설명
add-tearoffs gboolean TRUE로 설정 시, GtkUIManager가 생성한 메뉴는 팝업 메뉴가 아니라면 테어오프 메뉴 항목을 가질 것이다.
ui gchararray 메뉴 또는 툴바 사용자 인터페이스를 생성하는 데에 사용되는 XML 문자열.
표 A-87. GtkUIManager 프로퍼티


프로퍼티 타입 설명
hadjustment GtkAdjustment 네이티브 스크롤링 지원에 사용되는 뷰포트의 수평적 조정.
shadow-type GtkShadowType 뷰포트의 자식 위젯 주위에 그려지는 그림자 타입.
vadjustment GtkAdjustment 네이티브 스크롤링 지원에 사용되는 뷰포트의 수직적 조정.
표 A-88. GtkViewport 프로퍼티


프로퍼티 타입 설명
app-paintable gboolean TRUE로 설정 시, GTK+는 GtkWidget 위에 직접 그릴 것이다.
can-default gboolean TRUE로 설정 시, GtkWidget은 창의 기본 위젯이 될 것이다.
can-focus gboolean TRUE로 설정 시, GtkWidget은 창의 포커스를 수락할 수 있을 것이다.
composite-child gboolean TRUE로 설정 시, 위젯은 GtkWidget에서 직접적으로 파생되지 않는다.
events GdkEventMask GdkEvenMask으로부터 위젯이 수신하게 될 모든 이벤트의 비트마스크(bitmask).
extension-events GdkExtensionMode GdkExtensionMode로부터 위젯이 수신하게 될 모든 확장 이벤트(extension event)의 비트마스크.
has-default gboolean TRUE로 설정 시, GtkWidget는 현재 그 부모 창의 기본 위젯에 해당한다.
has-focus gboolean TRUE로 설정 시, GtkWidget은 현재 포커스가 있는 창에 해당한다.
height-request gint 위젯에 요청된 높이. -1로 설정 시 GTK+가 위젯의 높이를 설정하도록 허용한다. 이는 요청에 불과하며 일부 경우 유효하게 간주되지(honored) 않을지도 모른다.
is-focus gboolean TRUE로 설정 시, 위젯은 최상위 수준의 창 내에서 포커스를 갖는다.
name gchararray 동일한 타입으로 된 위젯을 구별하는 데에 사용 가능한 유일한 이름. 종종 자원 파일에서 위젯 스타일을 설정 시 사용된다.
no-show-all gboolean TRUE로 설정 시, 위젯은 gtk_widget_show_all()의 호출의 영향을 받지 않는다.
parent GtkContainer 위젯의 부모 컨테이너.
receives-default gboolean TRUE로 설정 시, 위젯에 포커스가 있으면 기본 액션을 수신할 것이다.
sensitive gboolean TRUE로 설정 시, 사용자는 위젯과 상호작용이 가능할 것이다.
style GtkStyle 위젯이 그려지는 방식을 맞춤설정하는 데에 사용되는 위젯과 연관된 스타일.
visible gboolean TRUE로 설정 시, 위젯이 화면에 표시될 것이다.
width-request gint 위젯에 요청된 너비. -1로 설정 시 GTK+가 위젯의 너비를 설정하도록 허용한다. 이는 요청에 불과하며 일부 경우 유효하게 간주되지(honored) 않을지도 모른다.
표 A-89. GtkWidget 프로퍼티


프로퍼티 타입 설명
accept-focus gboolean TRUE로 설정 시, 창이 입력을 위해 포커스를 수신할 수 있을 것이다.
allow-grow gboolean TRUE로 설정 시, 사용자는 창을 처음 크기보다 크게 조정할 수 있을 것이다.
allow-shrink gboolean TRUE로 설정 시, 창의 최소 크기가 정해지지 않을 것이다.
decorated gboolean TRUE로 설정 시, 창 관리자가 제목 표시줄이 있는 창을 그릴 것이다.
default-height gint 창의 기본 높이. 이 높이는 창이 화면에 처음으로 매핑될 때 사용된다.
default-width gint 창의 기본 너비. 이 너비는 창이 화면에 처음으로 매핑될 때 사용된다.
deletable gboolean TRUE로 설정 시, 창의 제목 표시줄은 닫기 버튼을 표시할 것이다.
destroy-with-parent gboolean TRUE로 설정 시, 창은 그 부모 창과 함께 소멸될 것이다.
focus-on-map gboolean TRUE로 설정 시, 창은 매핑 시 포커스를 수신할 것이다.
gravity GdkGravity gtk_window_move()를 이용할 때 창의 참조점.
has-toplevel-focus gboolean 창의 자식이 포커스를 가질 때 이 프로퍼티는 TRUE로 설정될 것이다.
icon GdkPixbuf 이 프로퍼티를 이용하는 창 관리자에 창 아이콘으로 표시되는 이미지.
icon-name gchararray 이 프로퍼티를 이용하는 창 관리자에 창 아이콘으로 표시되는 아이콘 테마로부터 명명된 아이콘.
is-active gboolean TRUE로 설정 시, 창은 포커스가 있는 현재 창에 해당한다.
modal gboolean TRUE로 설정 시, 사용자는 이 프로퍼티가 리턴할 때까지 부모 창과 상호작용을 할 수 없을 것이다. 부모 창은 transient-for를 이용해 설정된다.
resizable gboolean TRUE로 설정 시, 사용자는 다른 GTK+ 설정에서 금지하지 않는 한 창의 크기를 조정할 수 있을 것이다.
role gchararray 창 관리자가 지난 세션을 복구할 때 사용되는 창을 구별하는 유일한 문자열.
screen GdkScreen 창이 그려지는 화면.
skip-pager-hint gboolean TRUE로 설정 시, 창 관리자는 자체의 pager에서 창을 실현할 것이다.
skip-taskbar-hint gboolean TRUE로 설정 시, 창 관리자는 작업 표시줄에 창을 표시할 것이다.
title gchararray 창 관리자의 작업 표시줄과 제목 표시줄에 표시할 창의 제목.
transient-for GtkWindow 현재 창의 부모 창. 모달 창이 되도록 해준다.
type GdkWindowType 최상위 수준의 창 타입 또는 팝업 창 타입.
type-hint GdkWindowTypeHint 창 관리자에게 창의 목적과 관련해 주어지는 힌트. 다양한 창 관리자에서 창이 그려지는 방식에 영향을 미칠 수도 있다.
urgency-hint gboolean TRUE로 설정 시, 사용자는 창에 주의가 필요하다는 통지를 받을 것이다.
window-position GtkWindowPosition 처음 매핑될 때 창의 위치. 이것은 힌트에 불과하며, 창 관리자는 이를 유효하게 간주하지(honored) 않을지도 모른다.
표 A-90. GtkWindow 프로퍼티


자식 위젯 프로퍼티

GTK+에서 컨테이너의 모든 자식으로 할당되는 프로퍼티를 가진 컨테이너는 몇 개에 불과하다. 표 A-91부터 A-100까지 그러한 프로퍼티를 열거하겠다.

표 A-91. GtkAssistant 자식 프로퍼티

프로퍼티 타입 설명
complete gboolean TRUE로 설정 시, 페이지가 완전한 것으로(complete) 설정되고, 탐색(navigation) 버튼이 사용자와 상호작용하도록 설정될 것이다.
header-image GdkPixbuf 페이지 헤더 옆에 표시되는 이미지.
page-type GtkAssistantPageType 사용할 버튼의 타입.
sidebar-image GdkPixbuf 페이지 옆에 사이드바(sidebar)로 표시되는 이미지.
title gchararray 헤더에 페이지 제목으로 표시되는 문자열.
표 A-91. GtkAssistant 자식 프로퍼티


프로퍼티 타입 설명
expand gboolean TRUE로 설정 시, 박스가 커지면 자식 위젯에 추가 공간이 생길 것이다. 자식 위젯은 스스로 또는 패딩을 이용해 추가 공간을 차지할 수 있다.
fill gboolean TRUE로 설정 시, 자식으로 할당된 추가 공간을 위젯이 차지할 것이다. 그 외의 경우 패딩이 차지할 것이다.
pack-type GtkPackType 자식이 이용하는 패킹의 타입.
padding guint 자식 위젯과 그 주위 위젯들(neighbors) 사이에 패딩의 픽셀 수.
position gint 박스 내에서 자식의 위치로, 0부터 색인된다.
표 A-92. GtkBox 자식 프로퍼티


프로퍼티 타입 설명
secondary gboolean TRUE로 설정 시, 자식 버튼은 2차 버튼 그룹에 위치할 것이다.
표 A-93. GtkButtonBox 자식 프로퍼티


프로퍼티 타입 설명
x (y) gint GtkFixed 위젯 내에서 자식 위젯의 가로 및 세로 위치.
표 A-94. GtkFixed 자식 프로퍼티


프로퍼티 타입 설명
x (y) gint GtkLayout 위젯 내에서 자식 위젯의 가로 및 세로 위치.
표 A-95. GtkLayout 자식 프로퍼티


프로퍼티 타입 설명
bottom-attach gint 자식 위젯의 하단면이 붙은 행.
left-attach gint 자식 위젯의 좌측면이 붙은 열.
right-attach gint 자식 위젯의 우측면이 붙은 열.
top-attach gint 자식 위젯의 상단면이 붙은 행.
표 A-96. GtkMenu 자식 프로퍼티


프로퍼티 타입 설명
detachable gboolean TRUE로 설정 시, 사용자는 부모 노트북에서 탭을 분리할 수 있을 것이다.
menu-label gchararray 노트북의 탭 선택 메뉴에서 탭에 표시할 문자열.
position gint 노트북 내에서 자식의 현재 위치로, 0부터 색인된다.
reorderable gboolean TRUE로 설정 시, 사용자는 현재 탭의 위치를 변경할 수 있을 것이다.
tab-expand gboolean TRUE로 설정 시, 노트북에 할당된 추가 공간을 차지하도록 자식의 탭이 확장될 것이다.
tab-fill gboolean TRUE로 설정 시, 자식의 탭이 그에 할당된 추가 공간을 차지할 것이다.
tab-label gchararray 자식의 탭 라벨로 표시할 문자열. 자신만의 라벨 위젯을 생성하고자 한다면 이 프로퍼티를 설정하지 않은 채 남겨두어도 좋다.
tab-pack GtkPackType 자식을 추가하는 데에 사용된 패킹 타입.
표 A-97. GtkNotebook 자식 프로퍼티


프로퍼티 타입 설명
resize gboolean TRUE로 설정 시, 자식 위젯이 전체 패인을 차지하도록 크기가 조정될 것이다.
shrink gboolean TRUE로 설정 시, 요청된 자식 위젯의 크기보다 작은 크기로 패인을 조정할 수 있다.
표 A-98. GtkPaned 자식 프로퍼티


프로퍼티 타입 설명
bottom-attach guint 자식 위젯의 하단면이 붙은 행.
left-attach guint 자식 위젯의 좌측면이 붙은 열.
right-attach guint 자식 위젯의 우측면이 붙은 열.
top-attach guint 자식 위젯의 상단면이 붙은 행.
x-options (y-options) GtkAttachOptions 위젯에 제공된 수평 및 수직 부착(attach) 옵션.
x-padding (y-padding) guint 자식 위젯의 면들 중 한 면에 추가할 수평 또는 수직 패딩.
표 A-99. GtkTable 자식 프로퍼티


프로퍼티 타입 설명
expand gboolean TRUE로 설정 시, 툴바가 커지면 툴 항목은 공간이 추가될 것이다.
homogeneous gboolean TRUE로 설정 시, 툴 항목은 이 프로퍼티 집합을 가진 다른 모든 항목들과 크기가 무조건적으로(force) 같아질 것이다.
표 A-100. GtkToolbar 자식 프로퍼티


Notes