[android:windowSoftInputMode] soft keyboard 설정 옵션들

작성일 : 2013-03-12

작성자 : hanburn

 

 

1. android:windowSoftInputMode 이란?

Activity의 main window가 soft keyboard와 어떻게 interact 하는지 설정 할 수 있다.

설정할 수 있는 것은 2가지 이다.

 

첫째, 소프트키보드의 visible 상태를 설정

둘째, activity의 윈도우 조절 옵션 ( resize 하거나 pan 하거나 등등 )

 

아래에서는 state 계열과 adjust 계열의 속성으로 구분하였는데, 그 이유는.. 각 계열마다 하나의 속성만 정의 해야 한다. 만약 stat 계열의 속성을 복수로 지정하면 그 동작은 undefined 되어 있다고 한다. 복수로 지정할 수 있는 것은 stat 계열 1개와 adjust 계열 1개의 조합만 가능하다.

 

올바른 예

<activity android:windowSoftInputMode="stateVisible|adjustResize" >

 

잘못된 예

<activity android:windowSoftInputMode="stateVisible|adjustResize|stateHidden" >

위의 예처럼 state 계열은 visible 에 대한 것이므로 상반된 2개의 속성을 표시하면 안드로이드는 랜덤하게 동작하게 된다.

 

 

2. state 계열 속성

 

Value	Description
"stateUnspecified"	soft keyboard 를 보일지 말지 정하지 않고, system 이 theme에 따라서 선택하도록 한다. 이 설정이 기본 설정값이다.
"stateUnchanged"	soft keyboard 가 마지막 상태를 유지하도록 한다.
"stateHidden"	soft keyboard 가 hidden 상태가 되게 한다. 다른 activity에서 back 버튼으로 활성화 되는경우보다 forward 로 활성화 되는 경우( 즉 새로 activity가 뜨는 경우)
"stateAlwaysHidden"	soft keyboard 가 항상 hidden 상태로 ( Activity의 main window가 foucus될때 )
"stateVisible"	soft keyboard 가 visible 상태로 ( navigateing forward to )
"stateAlwaysVisible"	soft keyboard 가 visible 상태로 ( 뒤로가기 제외 )

 stateHidden은 다른 액티비티에서 뒤로가기 버튼으로 navigation 되었을때는 동작을 않하게 된다. 반면에 stateAlwaysHidden은 뒤로가기 버튼으로 해당 액티비티가 foreground 되어도 동작한다.

 

3. adjust 계열 속성

 

Value	Description
"adjustUnspecified"	Resize 나 pan 을 정하지 않고 system이 설정에 따라서 자동으로 선택하게 한다. 기본 설정값이다.
"adjustResize"	화면의 soft keyboard에 맞춰서 항상 resize 되도록 한다. (EditText 이 안보일 수도 있음. )
"adjustPan"	EditText 창을 가리지 않고, EditText 부분이 화면에 보이도록 레이아웃이 위로 스크롤된다.

 

늘 그렇듯이 android의 developer page를 항상 참고해야 한다.

참고 : http://developer.android.com/guide/topics/manifest/activity-element.html#wsoft

 

추가로 Keyboard가 가로모드시 화면을 모두 덮어 버리면, EditText의 android:imeOptions="flagNoExtractUI" 를 설정