詳解Android Fragment之六：Fragment實例

       上一節講了Fragment與Activity的通信，本節將給大家演示Fragment的實例。

       把條目添加到動作欄

       你的fragment們可以向activity的菜單（按Manu鍵時出現的東西）添加項，同時也可向動作欄（界面中頂部的那個區域）添加條目，這都需通過實現方法onCreateOptionManu()來完成。

       你從fragment添加到菜單的任何條目，都會出現在現有菜單項之後。Fragment之後可以通過方法onOptionsItemSelected()來響應自己的菜單項被選擇的事件。

       你也可以在fragemnt中注冊一個view來提供快捷菜單（上下文菜單）。當用戶要打開快捷菜單時，fragment的onCreateContextMenu()方法會被調用。當用戶選擇其中一項時，fragemnt的onContextItemSelected()方法會被調用。

       注：盡管你的fragment可以分別收到它所添加的菜單項的選中事件，但是activity才是第一個接收這些事件的家伙，只有當activity對某個事件置之不理時，fragment才能接收到這個事件，對於菜單和快捷菜單都是這樣。

       下例中實驗了之前所講的所有內容。此例有一個activity，其含有兩個fragment。一個顯示莎士比亞劇的播放曲目，另一個顯示選中曲目的摘要。此例還演示了如何跟據屏幕大小配置fragment。

       MainActivity：

1. @Override     
2. protectedvoid onCreate(Bundle savedInstanceState) {     
3.    super.onCreate(savedInstanceState);     
4.      
5.    setContentView(R.layout.fragment_layout);     
6. }   

       Layout.xml：

1. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
2.         android:orientation="horizontal"     
3.         android:layout_width="match_parent" android:layout_height="match_parent">          
4.         <fragment class="com.example.android.apis.app.FragmentLayout$TitlesFragment"     
5.                 android:id="@+id/titles" android:layout_weight="1"     
6.                 android:layout_width="0px" android:layout_height="match_parent" />           
7.         <FrameLayout android:id="@+id/details" android:layout_weight="1"     
8.                 android:layout_width="0px" android:layout_height="match_parent"     
9.                 android:background="?android:attr/detailsElementBackground" />           
10. </LinearLayout>    

       系統在activity加載此layout時初始化TitlesFragment（用於顯示標題列表），TitlesFragment的右邊是一個FrameLayout，用於存放顯示摘要的fragment，但是現在它還是空的，fragment只有當用戶選擇了一項標題後，摘要fragment才會被放到FrameLayout中。

       然而，並不是所有的屏幕都有足夠的寬度來容納標題列表和摘要。所以，上述layout只用於橫屏，現把它存放於ret/layout-land/fragment_layout.xml。

       之外，當用於豎屏時，系統使用下面的layout，它存放於ret/layout/fragment_layout.xml：

1. <FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"     
2.     android:layout_width="match_parent" android:layout_height="match_parent">     
3.     <fragment class="com.example.android.apis.app.FragmentLayout$TitlesFragment"     
4.             android:id="@+id/titles"     
5.             android:layout_width="match_parent" android:layout_height="match_parent" />     
6. </FrameLayout>   

       這個layout只包含TitlesFragment。這表示當使用豎屏時，只顯示標題列表。當用戶選中一項時，程序會啟動一個新的activity去顯示摘要，而不是加載第二個fragment。
下一步，你會看到Fragment類的實現。第一個是TitlesFragment，它從ListFragment派生，大部分列表的功能由ListFragment提供。

       當用戶選擇一個Title時，代碼需要做出兩種行為，一種是在同一個activity中顯示創建並顯示摘要fragment，另一種是啟動一個新的activity。

1. public static class TitlesFragment extends ListFragment {     
2.     boolean mDualPane;     
3.     int mCurCheckPosition = 0;     
4.      
5.     @Override     
6.     public void onActivityCreated(Bundle savedInstanceState) {     
7.         super.onActivityCreated(savedInstanceState);     
8.      
9.         // Populate list with our static array of titles.     
10.         setListAdapter(new ArrayAdapter<String>(getActivity(),     
11.                 android.R.layout.simple_list_item_activated_1, Shakespeare.TITLES));     
12.      
13.         // Check to see if we have a frame in which to embed the details     
14.         // fragment directly in the containing UI.     
15.         View detailsFrame = getActivity().findViewById(R.id.details);     
16.         mDualPane = detailsFrame != null && detailsFrame.getVisibility() == View.VISIBLE;     
17.      
18.         if (savedInstanceState != null) {     
19.             // Restore last state for checked position.     
20.             mCurCheckPosition = savedInstanceState.getInt("curChoice", 0);     
21.         }     
22.      
23.         if (mDualPane) {     
24.             // In dual-pane mode, the list view highlights the selected item.     
25.             getListView().setChoiceMode(ListView.CHOICE_MODE_SINGLE);     
26.             // Make sure our UI is in the correct state.     
27.             showDetails(mCurCheckPosition);     
28.         }     
29.     }     
30.      
31.     @Override     
32.     public void onSaveInstanceState(Bundle outState) {     
33.         super.onSaveInstanceState(outState);     
34.         outState.putInt("curChoice", mCurCheckPosition);     
35.     }     
36.      
37.     @Override     
38.     public void onListItemClick(ListView l, View v, int position, long id) {     
39.         showDetails(position);     
40.     }     
41.      
42.     /**   
43.      * Helper function to show the details of a selected item, either by   
44.      * displaying a fragment in-place in the current UI, or starting a   
45.      * whole new activity in which it is displayed.   
46.      */     
47.     void showDetails(int index) {     
48.         mCurCheckPosition = index;     
49.      
50.         if (mDualPane) {     
51.             // We can display everything in-place with fragments, so update     
52.             // the list to highlight the selected item and show the data.     
53.             getListView().setItemChecked(index, true);     
54.      
55.             // Check what fragment is currently shown, replace if needed.     
56.             DetailsFragment details = (DetailsFragment)     
57.                     getFragmentManager().findFragmentById(R.id.details);     
58.             if (details == null || details.getShownIndex() != index) {     
59.                 // Make new fragment to show this selection.     
60.                 details = DetailsFragment.newInstance(index);     
61.      
62.                 // Execute a transaction, replacing any existing fragment     
63.                 // with this one inside the frame.     
64.                 FragmentTransaction ft = getFragmentManager().beginTransaction();     
65.                 ft.replace(R.id.details, details);     
66.                 ft.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_FADE);     
67.                 ft.commit();     
68.             }     
69.      
70.         } else {     
71.             // Otherwise we need to launch a new activity to display     
72.             // the dialog fragment with selected text.     
73.             Intent intent = new Intent();     
74.             intent.setClass(getActivity(), DetailsActivity.class);     
75.             intent.putExtra("index", index);     
76.             startActivity(intent);     
77.         }     
78.     }    

       第二個fragment，DetailsFragment顯示被選擇的Title的摘要：

1. public static class DetailsFragment extends Fragment {     
2.     /**   
3.      * Create a new instance of DetailsFragment, initialized to   
4.      * show the text at 'index'.   
5.      */     
6.     public static DetailsFragment newInstance(int index) {     
7.         DetailsFragment f = new DetailsFragment();     
8.      
9.         // Supply index input as an argument.     
10.         Bundle args = new Bundle();     
11.         args.putInt("index", index);     
12.         f.setArguments(args);     
13.      
14.         return f;     
15.     }     
16.      
17.     public int getShownIndex() {     
18.         return getArguments().getInt("index", 0);     
19.     }     
20.      
21.     @Override     
22.     public View onCreateView(LayoutInflater inflater, ViewGroup container,     
23.             Bundle savedInstanceState) {     
24.         if (container == null) {     
25.             // We have different layouts, and in one of them this     
26.             // fragment's containing frame doesn't exist.  The fragment     
27.             // may still be created from its saved state, but there is     
28.             // no reason to try to create its view hierarchy because it     
29.             // won't be displayed.  Note this is not needed -- we could     
30.             // just run the code below, where we would create and return     
31.             // the view hierarchy; it would just never be used.     
32.             return null;     
33.         }     
34.      
35.         ScrollView scroller = new ScrollView(getActivity());     
36.         TextView text = new TextView(getActivity());     
37.         int padding = (int)TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP,     
38.                 4, getActivity().getResources().getDisplayMetrics());     
39.         text.setPadding(padding, padding, padding, padding);     
40.         scroller.addView(text);     
41.         text.setText(Shakespeare.DIALOGUE[getShownIndex()]);     
42.         return scroller;     
43.     }     
44. }    

       如果當前的layout沒有R.id.detailsView（它被用於DetailsFragment的容器），那麼程序就啟動DetailsActivity來顯示摘要。

       下面是DetailsActivity，它只是簡單地嵌入DetailsFragment來顯示摘要。

1. public static class DetailsActivity extends Activity {     
2.      
3.     @Override     
4.     protected void onCreate(Bundle savedInstanceState) {     
5.         super.onCreate(savedInstanceState);     
6.      
7.         if (getResources().getConfiguration().orientation     
8.                 == Configuration.ORIENTATION_LANDSCAPE) {     
9.             // If the screen is now in landscape mode, we can show the     
10.             // dialog in-line with the list so we don't need this activity.     
11.             finish();     
12.             return;     
13.         }     
14.      
15.         if (savedInstanceState == null) {     
16.             // During initial setup, plug in the details fragment.     
17.             DetailsFragment details = new DetailsFragment();     
18.             details.setArguments(getIntent().getExtras());     
19.             getFragmentManager().beginTransaction().add(android.R.id.content, details).commit();     
20.         }     
21.     }     
22. }    

       注意這個activity在檢測到是豎屏時會結束自己，於是主activity會接管它並顯示出TitlesFragment和DetailsFragment。這可以在用戶在豎屏時顯示在TitleFragment，但用戶旋轉了屏幕，使顯示變成了橫屏。