FoundationsofGTKDevelopment:Appendix A
- 부록 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 자식 프로퍼티 |