# TextView (Python)

Sebastian Pölsterl
sebp@k-d-w.org 2011
Marta Maria Casetti
mmcasetti@gmail.com 2012
GtkTextBuffer를 나타내는 위젯
조성호
shcho@gnome.org 2017-2019.

# TextView

Gtk.TextView 예제입니다.

"enter" 키를 누르면 줄이 바뀝니다.

그러나 긴 문장을 쓸 경우 줄을 바꿀 수 있습니다(문장을 단어 단위로 나누어 줄을 바꿉니다).

기이이이이이이이이이이이이이이이이이이인

(길었다면)

단어가 있다면, 수평 스크롤 표시줄이 나타납니다.

# 예제 결과를 만드는 코드

from gi.repository import Gtk import sys

class MyWindow(Gtk.ApplicationWindow):

def __init__(self, app): Gtk.Window.__init__(self, title="TextView Example", application=app) self.set_default_size(300, 450)

# a scrollbar for the child widget (that is going to be the textview) scrolled_window = Gtk.ScrolledWindow() scrolled_window.set_border_width(5) # we scroll only if needed scrolled_window.set_policy( Gtk.PolicyType.AUTOMATIC, Gtk.PolicyType.AUTOMATIC)

# a text buffer (stores text) buffer1 = Gtk.TextBuffer()

# a textview (displays the buffer) textview = Gtk.TextView(buffer=buffer1) # wrap the text, if needed, breaking lines in between words textview.set_wrap_mode(Gtk.WrapMode.WORD)

# textview is scrolled scrolled_window.add(textview)

self.add(scrolled_window)

class MyApplication(Gtk.Application):

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

def do_activate(self): win = MyWindow(self) win.show_all()

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

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

# TextView 위젯에 쓸만한 메서드

`Gtk.TextView`는 `Gtk.TextBuffer`에 저장한 텍스트를 나타냅니다. 그러나, 대부분 텍스트 처리는 텍스트 버퍼의 두 문자간 위치 `Gtk.TextIter`로 표현하는 반복자로 끝냅니다. 반복자는 항상 유효한 존재는 아닙니다. 버퍼의 내용에 영향을 주어 버퍼의 내용이 바뀌면 이 부분을 알고 있든 반복자는 무효화 처리됩니다. 이 때문에, 반복자는 버퍼를 수정할 때 위치 정보를 보관할 목적으로 사용할 수 없습니다. 위치 정보를 어딘가에 보관할 때 `visible(True)` 함수로 눈에 띄게 나타낼 수 있는 `Gtk.TextMark`를 사용합니다. 텍스트 버퍼에는 자체적으로 내장한 "insert" 마크(커서 위치)와 "selection_bound"마크가 있습니다.

TextView 위젯의 메서드는 다음과 같습니다:

TextView 위젯은 기본적으로 편집할 수 있습니다. 편집할 수 없게 하려면 `set_editable(False)` 함수를 사용하십시오 버퍼에 편집할 수 있는 텍스트가 없다면, 마찬가지로 `set_cursor_visible(False)` 함수를 사용하시는것이 좋습니다.

텍스트 정렬은 `set_justification(Gtk.Justification.JUSTIFICATION)` 함수로 설정합니다. 여기서 `JUSTIFICATION`은 `LEFT, RIGHT, CENTER, FILL` 값 중 하나가 들어갑니다.

텍스트 줄 바꿈은 `set_wrap_mode(Gtk.WrapMode.WRAP)` 함수로 설정합니다. 여기서 `WRAP` 값은 `NONE` (텍스트 영역이 더 넓어짐), `CHAR` (커서가 나타날 수 있는 어디든 줄 바꿈), `WORD` (단어 사이 줄 바꿈), `WORD_CHAR` (단어 사이에 줄을 바꾸지만 문자를 더 넣을 여력이 안되면 문자 사이를 줄바꿈) 값 중 하나입니다.

TextBuffer 위젯의 메서드:

`get_insert()` 함수에서는 삽입 지점 커서를 나타내는 `Gtk.TextMark`를 반환합니다.

`get_selection_bound()` 함수는 선택 범위를 나타내는 `Gtk.TextMark`를 반환합니다.

`length`에 양의 정수 또는 `-1`을 넣을 수 있는 `set_text("some text", length)` 함수는 `"some text"` 텍스트를 처음 `length` 글자 만큼 버퍼에 내용을 넣습니다. `length` 값을 생략하거나 `-1`로 두면, 텍스트를 전부 넣습니다. 어떤 값이 들어가면 버퍼의 내용을 해체합니다.

`iter` 에 텍스트 반복자가 들어가고 `length`에 양의 정수 또는 `-1`을 넣을 수 있는 `insert(iter, "some text", length)` 함수에는 `"some text"` 텍스트 중 처음 `length` 글자를 버퍼의 `iter` 위치에 삽입합니다. `length` 값을 생략하거나 `-1`로 두면, 텍스트를 전부 넣습니다.

`insert_at_cursor("some text", length)` 함수는 `insert(iter, "some text", length)` 함수와 동일한 동작을 취하지만 현재 커서 위치를 `iter`로 취합니다.

`iter`는 `Gtk.TextIter`이고, `left_gravity` 값은 부울린 값인 `create_mark("mark_name", iter, left_gravity)` 함수는 `Gtk.TextMark`를 `iter` 위치에 만듭니다. `"mark_name"`을 `None`으로 설정하면, 익명으로 표시합니다. 그렇지 않으면 `get_mark()` 함수를 활용할 때 지정 이름으로 표시 항목을 가져올 수 있습니다. 마크가 왼쪽 정렬 상태고 마크 현재 위치에 텍스트를 넣으면, 마크는 새로 넣은 텍스트의 왼편으로 갑니다. `left_gravity` 매개변수 값을 생략하면 기본값은 `False`로 들어갑니다.

버퍼에 임의의 텍스트를 특정 형식으로 지정하려면, 형식 정보를 유지하는 태그를 지정해야하며, 다음과 같이 `create_tag("tag name", property)` 함수와 `apply_tag(tag, start_iter, end_iter)` 함수로 태그를 텍스트 영역에 적용해야합니다:

tag = textbuffer.create_tag("orange_bg", background="orange") textbuffer.apply_tag(tag, start_iter, end_iter)

다음은 텍스트에 적용하는 일반 모양새 일부입니다:

배경 색상("background" 속성)

전경 색상("foreground" 속성)

밑줄("underline" 속성)

굵게("weight" 속성)

기울임("style" 속성)

취소선("strikethrough" 속성)

양쪽배분("justification" 속성)

크기("size"와 "size-points" 속성)

텍스트 줄바꿈("wrap-mode" 속성)

`remove_tag()` 함수로 태그 일부를 삭제하거나 `remove_all_tags()` 함수를 호출하여 주어진 영역의 모든 태그를 삭제할 수 있습니다.

TextIter 위젯 메서드

`forward_search(needle, flags, limit)`는 `needle`을 앞방향으로 검색합니다. `Gtk.TextIter`에서 지정한 한계값에 도달하면 검색을 계속하지 않습니다. `flags` 는 `0`(결과 일치 내용이 정확해야함), `Gtk.TextSearchFlags.VISIBLE_ONLY` (보이지 않는 글자가 needle에 있을 수도 있음); `Gtk.TextSearchFlags.TEXT_ONLY` (일치 범위에 있는 내용에 픽셀 버퍼 또는 하위 위젯의 조합으로 이루어짐); `Gtk.TextSearchFlags.CASE_INSENSITIVE` (대소문자 관계 없이 일치하면 됨)값 중 하나로 지정하거나 비트-OR 연산자 `|`로 지정할 수 있습니다. 메서드에서는 시작 지점을 가리키는 `Gtk.TextIter`와 일치 결과를 찾은 지점 다음의 첫번째 문자를 튜플 형태로 반환합니다. 만약 일치 결과가 없으면 `None`을 반환합니다.

`backward_search(needle, flags, limit)` 함수는 `forward_search()`와 동일하게 동작하지만 뒷 방향으로 검색합니다.

# API 참고서

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

GtkTextView

GtkTextBuffer

GtkTextTag

GtkScrolledWindow

표준 서수형 값 목록