diff --git a/core/java/android/widget/package.html b/core/java/android/widget/package.html
index 7d94a4b71f849..91d327c4951b7 100644
--- a/core/java/android/widget/package.html
+++ b/core/java/android/widget/package.html
@@ -1,11 +1,16 @@
+
The widget package contains (mostly visual) UI elements to use
-on your Application screen. You can design your own
+on your Application screen. You can also design your own.
+
+
+
To create your own widget, extend {@link android.view.View} or a subclass. To
use your widget in layout XML, there are two additional files for you to
create. Here is a list of files you'll need to create to implement a custom
widget:
+
- Java implementation file - This is the file that implements the
behavior of the widget. If you can instantiate the object from layout XML,
@@ -19,14 +24,16 @@ another in their layout XML.
res/layout/ that describes the layout of your widget. You could also do
this in code in your Java file.
+
+
ApiDemos sample application has an example of creating a custom layout XML
tag, LabelView. See the following files that demonstrate implementing and using
-a custom widget:
+a custom widget:
+
- - LabelView.java - The implentation file
+ - LabelView.java - The implementation file
- res/values/attrs.xml - Definition file
- - res/layout/custom_view_1.xml - Layout
-file
+ - res/layout/custom_view_1.xml - Layout file