AndroidPro4_004_UI_and_Controls

# Build UI 
    Layout object can contain any type of view - even other layouts.
    

setContentView(R.layout.main); 
 
TextView nameValue = (TextView)findViewById(R.id.nameValue); 
nameValue.setText("John Doe"); 
TextView addrValue = (TextView)findViewById(R.id.addrValue); 
addrValue.setText("911 Hollywood Blvd.")

    Load the resource by calling setContentView(R.layout.main) before calling findViewById()—we cannot get references to views if they have not been loaded yet. 
    但是如果是纯XML或者纯Code模式，setContentView()就必须放在后面，除非需要先对views进行引用:

    @Override 
     public  void onCreate(Bundle savedInstanceState) 
    { 
         super.onCreate(savedInstanceState); 
        createNameContainer(); 
        createAddressContainer(); 
        createParentContainer(); 
        setContentView(parentContainer); 
    }

# FILL_PARENT vs. MATCH_PARENT
    Android 2.2 之后 FILL_PARENT 已弃用，转而使用 MATCH_PARENT ,  这只是严格意义上的名称变更，他们的值不变，还是 -1 .
    所以，可以直接用-1 避免版本上的差异。

# Text Controls
    \ TextView use the setText() method to set value, The TextView display text but not allow to editing.

< TextView   android:autoLink ="email|web"    />

    如果用户点击到这个highlight items, 系统会使用邮件程序打开邮件 | 或者用浏览器打开指定的网页。
    set autoLink in code:

TextView tv =(TextView) this.findViewById(R.id.tv)
tv.setAutoLinkMask(Linkify.ALL);
tv.setText("Please visit my website, http://www.androidbook.com or email me at davemac327@gmail.com.");

    set  the link before set text, because setAutoLinkMask won't affect the existing text.
# AutoCompleteTextView

<AutoCompleteTextView android:id="@+id/actv" 
    android:layout_width="fill_parent" 
    android:layout_height="wrap_content" /> 

AutoCompleteTextView actv = (AutoCompleteTextView)  this.findViewById(R.id.actv);  
ArrayAdapter<String> aa =  new ArrayAdapter<String>( this, 
            android.R.layout.simple_dropdown_item_1line, 
             new String[] {"English", "Hebrew", "Hindi","Spanish", "German", "Greek" });  
actv.setAdapter(aa); 

# Button Control

<Button android:id="@+id/button1" 
    android:text="@string/basicBtnLabel" 
    android:layout_width="fill_parent" 
    android:layout_height="wrap_content" /> 
 
Button button1 = (Button) this.findViewById(R.id.button1); 
button1.setOnClickListener( new OnClickListener() 
{ 
      public  void onClick(View v) 
     { 
        Intent intent =  new Intent(Intent.ACTION_VIEW,Uri.parse("http://www.androidbook.com")); 
        startActivity(intent); 
     } 
}); 

# Android1.6之后可以更简便的设置handler

<Button        android:onClick="myClickHandler"       /> 
     public  void myClickHandler(View target) { 
         switch(target.getId()) { 
         case R.id.button1: 
          

# Image Button 2种方法设置Image:

<ImageButton android:id="@+id/imageButton2" 
    android:layout_width="wrap_content" android:layout_height="wrap_content" 
    android:onClick="myClickHandler" 
    android:src="@drawable/icon"  /> 

ImageButton imageButton2 = (ImageButton) this.findViewById(R.id.imageButton2); 
imageButton2.setImageResource(R.drawable.icon);

    ImageButton可设置focus. You can direct focus to a button using the arrow keys on the keypad or D-pad.
    可设置pressed.  Pressed means that the button’s appearance changes when it has been pressed but before the user has let go. 

<? xml version="1.0" encoding="utf-8" ?> 
     < selector  xmlns:android ="http://schemas.android.com/apk/res/android" > 
      < item  android:state_pressed ="true"  
           android:drawable ="@drawable/button_pressed"   />  <!--  pressed  --> 
      < item  android:state_focused ="true"  
           android:drawable ="@drawable/button_focused"   />  <!--  focused  --> 
      < item  android:drawable ="@drawable/icon"   />  <!--  default  --> 
     </ selector > 

    Note: 第一，这段XML在drawable中配置，因此不需要加上<resources> tag; 
             第二，default状态要放在最后，因为会按照顺序测试状态，而default测试总是成功的
             android:state_selected是选中
             android:state_focused是获得焦点
             android:state_pressed是点击
             android:state_enabled是设置是否响应事件,指所有事件
             根据这些状态同样可以设置button的selector效果。也可以设置selector改变button中的文字状态
    然后在layout中设置 selector

<Button        android:src="@drawable/imagebuttonselector"        />

# ToggleButton Control

< ToggleButton  android:id ="@+id/cctglBtn"  
        android:layout_width ="wrap_content"  
        android:layout_height ="wrap_content"    
        android:text ="Toggle Button"  
        android:textOn ="Stop"    
        android:textOff ="Run" />

    因为toggle button有两种状态显示TEXT，所以android:text不是很必要，尽管toggle button从TextView中继承了这个属性。

# Check Boxes

< LinearLayout  xmlns:android ="http://schemas.android.com/apk/res/android"  
        android:orientation ="vertical"  android:layout_width ="fill_parent"  
        android:layout_height ="fill_parent" >  
< CheckBox  android:id ="@+id/chickenCB"   android:text ="Chicken"  android:checked ="true"
    android:layout_width =“wrap_content"  android:layout_height ="wrap_content"   />  
< CheckBox  android:id ="@+id/fishCB"   android:text ="Fish"  
    android:layout_width ="wrap_content"  android:layout_height ="wrap_content"   /> 
< CheckBox  android:id ="@+id/steakCB"   android:text ="Steak"  android:checked ="true"  
    android:layout_width ="wrap_content"  android:layout_height ="wrap_content"   /> 
</ LinearLayout > 

    Note：如果android:checked未设置，默认是false.
    设置check状态函数： setChecked() or toggle(), 获取当前状态 isChecked();

public  class CheckBoxActivity  extends Activity { 
         /**  Called when the activity is first created.  */ 
        @Override 
         public  void onCreate(Bundle savedInstanceState) { 
             super.onCreate(savedInstanceState); 
            setContentView(R.layout.checkbox); 
            CheckBox fishCB = (CheckBox)findViewById(R.id.fishCB); 
             if(fishCB.isChecked()) 
                fishCB.toggle();      //  flips the checkbox to unchecked if it was checked 
            fishCB.setOnCheckedChangeListener( 
                         new CompoundButton.OnCheckedChangeListener() { 
                @Override 
                 public  void onCheckedChanged(CompoundButton arg0,  boolean isChecked) { 
                    Log.v("CheckBoxActivity", "The fish checkbox is now " 
                            + (isChecked?"checked":"not checked")); 
                }}); 
        } 
}

    除了用CompoundButton.onCheckedChangeListener()外，也可以用onClick()函数，当然在函数中要设置checked状态，或者用isCheck() method来检测。
    如果在XML中加入了android:onClick="myClickerHandler", 可以像BUTTON一样统一设定一个处理click的函数:

public  void myClickHandler(View view) { 
     switch(view.getId()) { 
     case R.id.steakCheckBox: 
        Log.v("CheckBoxActivity", "The steak checkbox is now " + 
                (((CheckBox)view).isChecked()?"checked":"not checked")); 
    } 
} 

# Radio Button 单选按钮

< LinearLayout  xmlns:android ="http://schemas.android.com/apk/res/android"  android:orientation ="vertical"  android:layout_width ="fill_parent"  android:layout_height ="fill_parent" > 
  < RadioGroup  android:id ="@+id/rBtnGrp"  android:layout_width ="wrap_content"  android:layout_height ="wrap_content"   android:orientation ="vertical"   > 
     < RadioButton  android:id ="@+id/chRBtn"  android:text ="Chicken"  android:layout_width ="wrap_content"   android:layout_height ="wrap_content" /> 
     < RadioButton  android:id ="@+id/fishRBtn"  android:text ="Fish"  android:checked ="true"  android:layout_width ="wrap_content"   android:layout_height ="wrap_content" /> 
     < RadioButton  android:id ="@+id/stkRBtn"  android:text ="Steak"  android:layout_width ="wrap_content"   android:layout_height ="wrap_content" /> 
</ RadioGroup > 
</ LinearLayout > 

    除了android:checked外，也可以在代码中用setChecked()

RadioButton steakBtn = (RadioButton) this.findViewById(R.id.stkRBtn); 
steakBtn.setChecked( true); 

    Also use toggle() method to toggle checked or unchecked state.
    一样可以使用onCheckedChangeListener(),但和前面不同，这里要使用RadioGroup.onCheckedChangeListener()
    RadioGroup只能影响group内的RadioButton, group外的RadioButton和group内的非RadioButton都无法影响。

RadioGroup radGrp = (RadioGroup)findViewById(R.id.radGrp); 
RadioButton newRadioBtn =  new RadioButton( this); 
newRadioBtn.setText("Pork"); 
radGrp.addView(newRadioBtn); 

    一旦用户checked某个RadioButton,就不能uncheck by click it again, 唯一清除这个group选择情况的方法就是通过编码形式调用clearCheck().
    不用逐个检查RadioButton是否checked,可以直接调用getCheckedRadioButtonId();

RadioGroup radGrp = (RadioGroup)findViewById(R.id.radGrp); 
int checkedRadioButtonId = radGrp.getCheckedRadioButtonId(); 

    getCheckedRadioButton() returns -1 if nothing is checked.

# ImageView

<ImageView android:id="@+id/image1" 
    android:layout_width="wrap_content"  
    android:layout_height="wrap_content" 
    android:src="@drawable/icon" /> 
<ImageView android:id="@+id/image2" 
    android:layout_width="125dip"  
    android:layout_height="25dip" 
    android:src="#555555" /> 
<ImageView android:id="@+id/image3" 
    android:layout_width="wrap_content"  
    android:layout_height="wrap_content" /> 
<ImageView android:id="@+id/image4" 
    android:layout_width="wrap_content"  
    android:layout_height="wrap_content" 
    android:src="@drawable/manatee02" 
    android:scaleType="centerInside" 
    android:maxWidth="35dip"  android:maxHeight="50dip" /> 

  ImageView imgView = (ImageView)findViewById(R.id.image3);  
  imgView.setImageResource( R.drawable.icon ); 
  imgView.setImageBitmap(BitmapFactory.decodeResource( 
               this.getResources(), R.drawable.manatee14) );  
  imgView.setImageDrawable( Drawable.createFromPath("/mnt/sdcard/dave2.jpg") );  
  imgView.setImageURI(Uri.parse("file://mnt/sdcard/dave2.jpg")); 

    setImageURI只能取得本地图片，如果要通过http协议获得，最好的办法还是用BitmapFactory和InputStream.

# Adapter

# SimpleCursorAdapter

SimpleCursorAdapter( Context context,  int childLayout, Cursor c, String[] from,  int[] to );

    from 和 to 的数量必须相同。
    Android不会为每一行数据建立adapter,而只会根据view可显示的数量，在以childLayout形式建立adapter,并且会比同屏可显示的多一些（类似缓冲，提高浏览速度）。

# ArrayAdapter
    ArrayAdapter is simpler than SimpleCursorAdapter

ArrayAdapter<String> adapter =  new ArrayAdapter<String>( this, 
                android.R.layout.simple_list_item_1,  
                 new string[]{"Dave","Satya","Dylan"}); 

    和SimpleCursorAdapter一样需要pass context(this), childLayout(android.R.layout.simple_list_item_1) pram.
    不同的是只pass了一组array as the actual data，没有pass a cursor or a "to array".
    当childLayout对象不是TextView时，可以传递资源ID和TextView资源ID来接收数据。如果没有现成的string array, 可以用createFromResource()函数。

<Spinner android:id="@+id/spinner" 
    android:layout_width="wrap_content"  android:layout_height="wrap_content" /> 

Spinner spinner = (Spinner) findViewById(R.id.spinner); 
ArrayAdapter<CharSequence> adapter = ArrayAdapter.createFromResource( this, 
        R.array.planets, android.R.layout.simple_spinner_item); 
adapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item);
spinner.setAdapter(adapter); 

<?xml version="1.0" encoding="utf-8"?> 
<!-- This file is /res/values/planets.xml --> 
<resources> 
  <string-array name="planets"> 
    <item>Mercury</item> 
    <item>Venus</item> 
    <item>Earth</item> 
    <item>Mars</item> 
    <item>Jupiter</item> 
    <item>Saturn</item> 
    <item>Uranus</item> 
    <item>Neptune</item> 
  </string-array> 
</resources>

    ArrayAdapter允许动态调整特定数据，add()函数可在array末尾添加新data, insert()插入，remove()删除指定.
        另外：sort()可以重新排序array，当然这样会失去data array和ListView之间的同步，因此还要call notifyDataSetChanged() 来resync the ListView with the adapter.

# Adapters that Android provides:

ArrayAdapter<T>  // This is an adapter on top of a generic array of arbitrary objects. It's meant to be used with a ListView.

CursorAdapter  // This adapter, also meant to be used in a ListView, provides data to the list via a cursor.

SimpleAdapter  // As the name suggests, this adapter is a simple adapter. It is generally used to populate a list with static data(possibly from resources).

ResourceCursorAdapter  // This adapter extends CursorAdapter and knows how to create views from resources.

SimpleCursorAdapter  // This adapter extends ResourceCursorAdapter and creates TextView/ImageView view from the columns in the cursor. The views are defined in resources.

# Using Adapter with AdapterView

# ListView: set data by calling setListAdapter() method.

public  class ListViewActivity  extends ListActivity 
{ 
    @Override 
     protected  void onCreate(Bundle savedInstanceState) 
    { 
         super.onCreate(savedInstanceState); 
 
        Cursor c = managedQuery(Contacts.CONTENT_URI, 
                         null,  null,  null, Contacts.DISPLAY_NAME + " ASC"); 
         
        String[] cols =  new String[] {Contacts.DISPLAY_NAME}; 
         int[]    views =  new  int[]   {android.R.id.text1}; 
 
        SimpleCursorAdapter adapter =  new SimpleCursorAdapter( this,  
                        android.R.layout.simple_list_item_1, 
                        c, cols, views); 
         this.setListAdapter(adapter); 
    } 
}

    Note: ListActivity包含了一个ListView,因此只要用this.setListAdapter()，也没有设置setContentView().

# Creating Custom Adapters

<?xml version="1.0" encoding="utf-8"?>
<!-- This file is at /res/layout/gridviewcustom.xml -->
<GridView xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/gridview"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:padding="10dip"
    android:verticalSpacing="10dip"
    android:horizontalSpacing="10dip"
    android:numColumns="auto_fit"
    android:gravity="center"
/>

public  class GridViewCustomAdapter  extends Activity
{
    @Override
     protected  void onCreate(Bundle savedInstanceState)
    {
         super.onCreate(savedInstanceState);
        setContentView(R.layout.gridviewcustom);
        GridView gv = (GridView)findViewById(R.id.gridview);
        ManateeAdapter adapter =  new ManateeAdapter( this);
        gv.setAdapter(adapter);
    }
     public  static  class ManateeAdapter  extends BaseAdapter {
     private  static  final String TAG = "ManateeAdapter";
     private  static  int convertViewCounter = 0;
     private Context mContext;
     private LayoutInflater mInflater;
     static  class ViewHolder {
        ImageView image;
    }
     private  int[] manatees = {
        R.drawable.manatee00, R.drawable.manatee01,
        R.drawable.manatee03, R.drawable.manatee04,
        R.drawable.manatee06, R.drawable.manatee07,
        R.drawable.manatee09, R.drawable.manatee10,
        R.drawable.manatee12, R.drawable.manatee13,
        R.drawable.manatee15, R.drawable.manatee16,
        R.drawable.manatee18, R.drawable.manatee19,
        R.drawable.manatee21, R.drawable.manatee22,
        R.drawable.manatee24, R.drawable.manatee25,
        R.drawable.manatee27, R.drawable.manatee28,
        R.drawable.manatee30, R.drawable.manatee31,
        R.drawable.manatee33
     };
     private Bitmap[] manateeImages =  new Bitmap[manatees.length];
     private Bitmap[] manateeThumbs =  new Bitmap[manatees.length];
     public ManateeAdapter(Context context) {
        Log.v(TAG, "Constructing ManateeAdapter");
         this.mContext = context;
        mInflater = LayoutInflater.from(context);
         for( int i=0; i<manatees.length; i++) {
            manateeImages[i] = BitmapFactory.decodeResource(
            context.getResources(), manatees[i]);
            manateeThumbs[i] = Bitmap.createScaledBitmap(manateeImages[i],
            100, 100,  false);
        }
    }
    @Override
     public  int getCount() {
        Log.v(TAG, "in getCount()");
         return manatees.length;
    }
     public  int getViewTypeCount() {
        Log.v(TAG, "in getViewTypeCount()");
         return 1;
    }
     public  int getItemViewType( int position) {
        Log.v(TAG, "in getItemViewType() for position " + position);
         return 0;
    }
    @Override
     public View getView( int position, View convertView, ViewGroup parent) {
        ViewHolder holder;
        Log.v(TAG, "in getView for position " + position +", convertView is " + ((convertView ==  null)?"null":"being recycled"));
         if (convertView ==  null) {
            convertView = mInflater.inflate(R.layout.gridimage,  null);
            convertViewCounter++;
            Log.v(TAG, convertViewCounter + " convertViews have been created");
            holder =  new ViewHolder();
            holder.image = (ImageView) convertView.findViewById(R.id.gridImageView);
             convertView.setTag(holder);
        }  else {
             holder = (ViewHolder) convertView.getTag();
        }
        holder.image.setImageBitmap( manateeThumbs[position] );
         return convertView;
    }
    @Override
     public Object getItem( int position) {
        Log.v(TAG, "in getItem() for position " + position);
         return manateeImages[position];
    }
    @Override
     public  long getItemId( int position) {
        Log.v(TAG, "in getItemId() for position " + position);
         return position;
    }
    }
}