안드로이드 에디트텍스트 속성. (Android EditText Attributes)
2016. 8. 24. 12:38
1. EditText 속성
EditText는 TextView로부터 상속받은 View 위젯이기 때문에, TextView가 가진 속성의 대부분을 그대로 사용할 수 있습니다. TextView에서 제공하는 폰트, 스타일, 색상, 최대 길이 등의 여러 가지 속성들을, EditText에서도 그대로 이용할 수 있는 것이죠.
TextView에서 살펴본 속성들을 여기서 다시 반복적으로 언급하는 것은 큰 의미가 없으므로, EditText에서 의미를 가지는 속성들에 대해서만 살펴보겠습니다. 그 외 TextView의 속성들에 대해서는, 속성 이름에 걸어놓은 링크를 통해 자세한 설명을 참고할 수 있습니다.
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. 참고.
- TextView 속성에 대한 자세한 도움말.
- [안드로이드 개발 참조문서 TextView 항목] 내용을 참고하세요.
- R.attr에 대한 도움말.
- [안드로이드 개발 참조문서. R.attr 항목]의 내용을 참고하세요.
- TextView 속성
- [안드로이드 텍스트뷰 속성] 내용을 참고하세요.