안드로이드 에디트텍스트 속성. (Android EditText Attributes)

2016. 8. 24. 12:38


1. EditText 속성

EditText는 TextView로부터 상속받은 View 위젯이기 때문에, TextView가 가진 속성의 대부분을 그대로 사용할 수 있습니다. TextView에서 제공하는 폰트, 스타일, 색상, 최대 길이 등의 여러 가지 속성들을, EditText에서도 그대로 이용할 수 있는 것이죠.


TextView에서 살펴본 속성들을 여기서 다시 반복적으로 언급하는 것은 큰 의미가 없으므로, EditText에서 의미를 가지는 속성들에 대해서만 살펴보겠습니다. 그 외 TextView의 속성들에 대해서는, 속성 이름에 걸어놓은 링크를 통해 자세한 설명을 참고할 수 있습니다.

안드로이드 EditText


2. EditText 속성의 종류

EditText가 제공하는 속성(실질적으로 TextView에서 제공되는 속성)의 종류 및 설명은 다음과 같습니다.


속성 이름 설명
autoLink TextView를 링크 형태로 사용.
autoText 텍스트 입력 시, 자동 오타 수정 기능 사용.
breakStrategy TextView의 텍스트 줄넘김 정책 지정.
bufferType getText() 함수로 리턴되는 버퍼 타입 지정.
capitalize 알파벳 소문자 입력(표시) 시, 대문자로 자동 변환.
cursorVisible 텍스트 입력 커서를 보일지 말지 여부 지정.
digits TextView에 입력 가능한 문자 제한.
drawableBottom 텍스트를 기준으로 아래쪽에 이미지 출력.
drawableEnd 텍스트를 기준으로 끝 위치에 이미지 출력.
drawableLeft 텍스트를 기준으로 왼쪽에 이미지 출력.
drawablePadding 텍스트와 이미지 사이의 간격 설정.
drawableRight 텍스트를 기준으로 오른쪽에 이미지 출력.
drawableStart 텍스트를 기준으로 시작 위치에 이미지 출력.
drawableTint drawable을 혼합하기 위한 색조(Tint) 지정.
drawableTintMode drawable tint 혼합(blending) 모드 설정.
drawableTop 텍스트를 기준으로 위쪽에 이미지 출력.
editable 입력 가능 여부 지정.
editorExtras 텍스트 입력기에 추가 데이터 제공. (텍스트 입력기 구현에 한정)
elegantTextHeight elegant height metrics 플래그 켜기.
ellipsize 텍스트 생략기호(...) 또는 텍스트 흐르는 효과 주기.
ems EM 단위의 크기로 TextView의 고정 너비 설정.
fontFamily TextView의 텍스트 폰트 설정.
fontFeatureSettings Open Type 폰트(.otf)의 고급 설정 제어.
freezesText TextView의 상태(텍스트, 커서 등) 유지.
gravity TextView의 텍스트 정렬 방식 지정.
height TextView의 고정된 높이 지정.
hint TextView의 텍스트가 빈 상태일 때, 출력될 텍스트 설정.
hyphenationFrequency '-'(hyphen)이 추가되는 빈도 설정.
imeActionId 텍스트 입력기(IME) 액션 버튼이 눌려졌을 때의 이벤트 ID 지정.
imeActionLabel 텍스트 입력기(IME) 액션 버튼에 표시될 라벨 텍스트 지정.
imeOptions 텍스트 입력기(IME)의 표시 옵션 지정.
includeFontPadding Font 위/아래 padding 사용 여부 설정.
inputMethod 특정 유형의 입력 방법 지정.
inputType 텍스트 입력기(IME)에서 입력 가능한 데이터 유형, 방법, 기능 지정
letterSpacing 글자 간격 조절.
lineSpacingExtra 텍스트 줄 간격 조절. (텍스트 높이 상관 없이 지정 값 설정)
lineSpacingMultiplier 텍스트 줄 간격 조절. (텍스트 높이에 곱한 값 설정)
lines 정확히 텍스트 줄 단위로 TextView 높이 설정.
linksClickable 링크 클릭 시, 링크 연결 프로그램 실행 여부 지정.
marqueeRepeatLimit marquee(텍스트 흐르는 효과) 애니메이션 반복 횟수 지정.
maxEms TextView의 EM 단위 최대 너비 설정.
maxHeight TextView의 최대 높이 지정.
maxLength TextView의 텍스트 최대 길이 제한.
maxLines TextView의 줄(line) 단위 최대 높이 지정.
maxWidth TextView의 최대 너비 지정.
minEms TextView의 EM 단위 최소 너비 설정.
minHeight TextView의 최소 높이 지정.
minLines TextView의 줄(line) 단위 최소 높이 지정.
minWidth TextView의 최소 너비 지정.
numeric 숫자만 입력 가능하게 만들기.
password 입력되는 텍스트 감추기. (대신 '•'(password dot) 표시)
phoneNumber 전화번호만 입력 가능하게 만들기.
privateImeOptions 텍스트 입력기(IME)에 구현에 제한된(private) 옵션 지정.
scrollHorizontally TextView 가로 스크롤 가능하게 만들기.
selectAllOnFocus TextView가 Focus될 때, 자동으로 모든 텍스트 선택하기.
shadowColor 텍스트 아래에 표시될 희미한 그림자 색상 지정.
shadowDx 텍스트와 그림자 사이의 가로 방향(x 축) 간격 조절
shadowDy 텍스트와 그림자 사이의 세로 방향(y 축) 간격 조절
shadowRadius 그림자의 범위 조절.
singleLine 텍스트가 한 줄로 출력되도록 강제.
text 화면에 표시될 텍스트 지정.
textAllCaps 텍스트를 모두 대문자로 출력.
textAppearance color, typeface, size, style을 한번에 설정.
textColor 텍스트 색상 설정.
textColorHighlight 선택 텍스트의 배경 색상 설정.
textColorHint hint 텍스트의 글자 색상 지정.
textColorLink 링크로 사용되는 텍스트의 글자 색상 지정.
textIsSelectable TextView의 텍스트 선택 가능하도록 만들기.
textScaleX 텍스트 글자 너비 조절(늘리기/줄이기).
textSize 텍스트 폰트 크기 설정.
textStyle 텍스트 스타일(bold, italic) 지정.
typeface 텍스트 폰트 typeface 설정.
width TextView의 고정된 너비 지정.

3. 참고.


ANDROID 프로그래밍/EDITTEXT , , , , ,