JavaTM 2
Platform
Std.  Ed.  v1. 4.0

javax.swing.text
클래스 Segment

java.lang.Object 
  |
  +--javax.swing.text.Segment
모든 구현 인터페이스:
CharacterIterator , Cloneable

public class Segment
extends Object
implements Cloneable , CharacterIterator

텍스트의 fragment를 나타내는 캐릭터 배열의 세그먼트(segment)입니다. 배열에 직접 액세스 할 수 있어도, 세그먼트(segment)를 변경하지 말아 주세요. 캐릭터를 카피하는 오버헤드가 없는 텍스트의 fragment에 빠르게 액세스 할 수 있습니다. 사실상, 보호되어 있지 않은 캐릭터 라인입니다.

Segment 는 텍스트를 캐릭터 라인에 카피하지 않고 국제화 (i18n) 서포트의 사용을 제공하기 위해서 java.text.CharacterIterator 인터페이스를 구현합니다.


필드의 개요
 char[] array
          처리 대상의 텍스트를 포함한 배열입니다.
 int count
          처리 대상의 텍스트를 구성하는 배열 요소의 수입니다.
 int offset
          목적의 텍스트가 시작되는 배열에의 오프셋(offset)입니다.
 
인터페이스 java.text. CharacterIterator 에서 상속받은 필드
DONE
 
생성자의 개요
Segment ()
          새로운 세그먼트(segment)를 작성합니다.
Segment (char[] array, int offset, int count)
          기존의 배열을 참조하는 새로운 세그먼트(segment)를 작성합니다.
 
메소드의 개요
 Object clone ()
          샤로코피를 작성합니다.
 char current ()
          현재 위치 (getIndex()에 의해 돌려주어지는 위치)에 있는 캐릭터를 취득합니다.
 char first ()
          위치를 getBeginIndex()로 설정해, 그 위치에 있는 캐릭터를 돌려줍니다.
 int getBeginIndex ()
          텍스트의 개시 인덱스를 돌려줍니다.
 int getEndIndex ()
          텍스트의 종료 인덱스를 돌려줍니다.
 int getIndex ()
          현재의 인덱스를 돌려줍니다.
 boolean isPartialReturn ()
          부분적 반환값이 유효한 것을 나타내는 플래그입니다.
 char last ()
          위치를 getEndIndex()-1 (텍스트가 비었을 경우는 getEndIndex())로 설정해, 그 위치에 있는 캐릭터를 돌려줍니다.
 char next ()
          반복자의 인덱스를 1 늘려, 새로운 인덱스에 있는 캐릭터를 돌려줍니다.
 char previous ()
          반복자의 인덱스를 1 줄여, 새로운 인덱스에 있는 캐릭터를 돌려줍니다.
 char setIndex (int position)
          위치가 지정된 텍스트의 위치로 설정해, 그 캐릭터를 돌려줍니다.
 void setPartialReturn (boolean p)
          부분적 반환값이 유효한 것을 나타내는 플래그입니다.
 String toString ()
          세그먼트(segment)를 캐릭터 라인으로 변환합니다.
 
클래스 java.lang. Object 에서 상속받은 메소드
equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait
 

필드의 상세

array

public char[] array
처리 대상의 텍스트를 포함한 배열입니다. 이 배열은 변경하지 말아 주세요. 효율을 향상시키기 (위해)때문에인 만큼 사용됩니다.


offset

public int offset
목적의 텍스트가 시작되는 배열에의 오프셋(offset)입니다.


count

public int count
처리 대상의 텍스트를 구성하는 배열 요소의 수입니다.

생성자의 상세

Segment

public Segment()
새로운 세그먼트(segment)를 작성합니다.


Segment

public Segment(char[] array,
               int offset,
               int count)
기존의 배열을 참조하는 새로운 세그먼트(segment)를 작성합니다.

파라미터:
array - 참조하는 배열
offset - 배열에의 오프셋(offset)
count - 캐릭터수
메소드의 상세

setPartialReturn

public void setPartialReturn(boolean p)
부분적 반환값이 유효한 것을 나타내는 플래그입니다. 플래그가 true 의 경우, 인터페이스 메소드 Document.getText(position, length, Segment)의 구현에서는 카피를 만들지 않고 가능한 한 많은 텍스트가 돌려주어집니다. 플래그의 디폴트 상태는 false 로, Document.getText(position, length, Segment)에 항상 같은 돌아와 동작을 실시하게 합니다. 이것은 요구에 의해 텍스트를 복제하는 경우로 하지 않는 경우가 있습니다.

파라미터:
p - 부분적 반환값이 유효한가 어떤가
도입된 버젼:
1.4

isPartialReturn

public boolean isPartialReturn()
부분적 반환값이 유효한 것을 나타내는 플래그입니다.

반환값:
부분적 반환값이 유효한가 어떤가
도입된 버젼:
1.4

toString

public String  toString()
세그먼트(segment)를 캐릭터 라인으로 변환합니다.

오버라이드(override):
클래스 Object 내의 toString
반환값:
캐릭터 라인

first

public char first()
위치를 getBeginIndex()로 설정해, 그 위치에 있는 캐릭터를 돌려줍니다.

정의:
인터페이스 CharacterIterator 내의 first
반환값:
텍스트내의 선두 캐릭터. 텍스트가 비었을 경우는 DONE
관련 항목:
getBeginIndex()

last

public char last()
위치를 getEndIndex()-1 (텍스트가 비었을 경우는 getEndIndex())로 설정해, 그 위치에 있는 캐릭터를 돌려줍니다.

정의:
인터페이스 CharacterIterator 내의 last
반환값:
텍스트내의 마지막 캐릭터. 텍스트가 비었을 경우는 DONE
관련 항목:
getEndIndex()

current

public char current()
현재 위치 (getIndex()에 의해 돌려주어지는 위치)에 있는 캐릭터를 취득합니다.

정의:
인터페이스 CharacterIterator 내의 current
반환값:
현재 위치에 있는 캐릭터. 현재 위치가 텍스트의 마지막을 지나고 있는 경우는 DONE
관련 항목:
getIndex()

next

public char next()
반복자의 인덱스를 1 늘려, 새로운 인덱스에 있는 캐릭터를 돌려줍니다. 결과의 인덱스가 getEndIndex()보다 큰지 거기에 동일한 경우, 현재의 인덱스가 getEndIndex()에 리셋트 되어 값 DONE 가 돌려주어집니다.

정의:
인터페이스 CharacterIterator 내의 next
반환값:
새로운 위치에 있는 캐릭터. 새로운 위치가 텍스트 범위의 마지막을 지나고 있는 경우는 DONE

previous

public char previous()
반복자의 인덱스를 1 줄여, 새로운 인덱스에 있는 캐릭터를 돌려줍니다. 현재의 인덱스가 getBeginIndex()의 경우, 인덱스는 getBeginIndex()인 채 변함없이, 값 DONE 가 돌려주어집니다.

정의:
인터페이스 CharacterIterator 내의 previous
반환값:
새로운 위치에 있는 캐릭터. 현재의 위치가 getBeginIndex()에 동일한 경우는 DONE

setIndex

public char setIndex(int position)
위치가 지정된 텍스트의 위치로 설정해, 그 캐릭터를 돌려줍니다.

정의:
인터페이스 CharacterIterator 내의 setIndex
파라미터:
position - 테스트내의 위치. 이 값은 getBeginIndex() ~ getEndIndex()의 범위내에 없으면 안 된다. 무효인 값을 지정하면(자), IllegalArgumentException 가 슬로우 된다
반환값:
지정된 위치에 있는 캐릭터. 지정된 위치가 getEndIndex()에 동일한 경우는 DONE

getBeginIndex

public int getBeginIndex()
텍스트의 개시 인덱스를 돌려줍니다.

정의:
인터페이스 CharacterIterator 내의 getBeginIndex
반환값:
텍스트가 시작되는 위치의 인덱스

getEndIndex

public int getEndIndex()
텍스트의 종료 인덱스를 돌려줍니다. 이 인덱스는 텍스트의 마지막의 다음의 캐릭터의 인덱스입니다.

정의:
인터페이스 CharacterIterator 내의 getEndIndex
반환값:
텍스트내의 마지막 캐릭터의 다음의 인덱스

getIndex

public int getIndex()
현재의 인덱스를 돌려줍니다.

정의:
인터페이스 CharacterIterator 내의 getIndex
반환값:
현재의 인덱스

clone

public Object  clone()
샤로코피를 작성합니다.

정의:
인터페이스 CharacterIterator 내의 clone
오버라이드(override):
클래스 Object 내의 clone
반환값:
카피

JavaTM 2
Platform
Std.  Ed.  v1. 4.0

버그의 보고와 기능의 리퀘스트
이외의 API 레퍼런스 및 개발자용 문서에 대해서는 Java 2 SDK SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.