19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.widget; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.AttributeSet; 218a78fd4d9572dff95432fcc4ba0e87563415b728Svetoslav Ganovimport android.view.accessibility.AccessibilityEvent; 228a78fd4d9572dff95432fcc4ba0e87563415b728Svetoslav Ganovimport android.view.accessibility.AccessibilityNodeInfo; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.widget.RemoteViews.RemoteView; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 276ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * Represents a push-button widget. Push-buttons can be 286ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * pressed, or clicked, by the user to perform an action. 296ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main 306ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * <p>A typical use of a push-button in an activity would be the following: 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </p> 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 336ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * <pre> 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * public class MyActivity extends Activity { 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * protected void onCreate(Bundle icicle) { 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * super.onCreate(icicle); 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * setContentView(R.layout.content_layout_id); 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * final Button button = (Button) findViewById(R.id.button_id); 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * button.setOnClickListener(new View.OnClickListener() { 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * public void onClick(View v) { 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * // Perform action on click 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * } 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * }); 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * } 476ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * }</pre> 486ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * 496ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * <p>However, instead of applying an {@link android.view.View.OnClickListener OnClickListener} to 506ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * the button in your activity, you can assign a method to your button in the XML layout, 516ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * using the {@link android.R.attr#onClick android:onClick} attribute. For example:</p> 526ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * 536ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * <pre> 546ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * <Button 556ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * android:layout_height="wrap_content" 566ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * android:layout_width="wrap_content" 576ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * android:text="@string/self_destruct" 586ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * android:onClick="selfDestruct" /></pre> 596ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * 606ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * <p>Now, when a user clicks the button, the Android system calls the activity's {@code 616ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * selfDestruct(View)} method. In order for this to work, the method must be public and accept 626ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * a {@link android.view.View} as its only parameter. For example:</p> 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 646ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * <pre> 656ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * public void selfDestruct(View view) { 666ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * // Kabloey 676ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * }</pre> 686ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * 696ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * <p>The {@link android.view.View} passed into the method is a reference to the widget 706ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * that was clicked.</p> 716ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * 726ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * <h3>Button style</h3> 736ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * 746ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * <p>Every Button is styled using the system's default button background, which is often different 756ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * from one device to another and from one version of the platform to another. If you're not 766ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * satisfied with the default button style and want to customize it to match the design of your 776ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * application, then you can replace the button's background image with a <a 786ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * href="{@docRoot}guide/topics/resources/drawable-resource.html#StateList">state list drawable</a>. 796ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * A state list drawable is a drawable resource defined in XML that changes its image based on 806ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * the current state of the button. Once you've defined a state list drawable in XML, you can apply 816ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * it to your Button with the {@link android.R.attr#background android:background} 826ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * attribute. For more information and an example, see <a 836ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * href="{@docRoot}guide/topics/resources/drawable-resource.html#StateList">State List 846ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * Drawable</a>.</p> 856ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * 864c359b76f9a030f92a302ba74a528faa170bad4eScott Main * <p>See the <a href="{@docRoot}guide/topics/ui/controls/button.html">Buttons</a> 874c359b76f9a030f92a302ba74a528faa170bad4eScott Main * guide.</p> 8841ec65355bd6ded652769725b276d47c54a0d913Scott Main * 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p><strong>XML attributes</strong></p> 906ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * <p> 916ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * See {@link android.R.styleable#Button Button Attributes}, 926ec3d4f0dcc30879076fd3dd859de5005c045a43Scott Main * {@link android.R.styleable#TextView TextView Attributes}, 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.R.styleable#View View Attributes} 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </p> 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project@RemoteView 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class Button extends TextView { 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Button(Context context) { 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this(context, null); 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Button(Context context, AttributeSet attrs) { 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this(context, attrs, com.android.internal.R.attr.buttonStyle); 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 106617feb99a06e7ffb3894e86a286bf30e085f321aAlan Viverette public Button(Context context, AttributeSet attrs, int defStyleAttr) { 107617feb99a06e7ffb3894e86a286bf30e085f321aAlan Viverette this(context, attrs, defStyleAttr, 0); 108617feb99a06e7ffb3894e86a286bf30e085f321aAlan Viverette } 109617feb99a06e7ffb3894e86a286bf30e085f321aAlan Viverette 110617feb99a06e7ffb3894e86a286bf30e085f321aAlan Viverette public Button(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) { 111617feb99a06e7ffb3894e86a286bf30e085f321aAlan Viverette super(context, attrs, defStyleAttr, defStyleRes); 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1138a78fd4d9572dff95432fcc4ba0e87563415b728Svetoslav Ganov 1148a78fd4d9572dff95432fcc4ba0e87563415b728Svetoslav Ganov @Override 1158a78fd4d9572dff95432fcc4ba0e87563415b728Svetoslav Ganov public void onInitializeAccessibilityEvent(AccessibilityEvent event) { 1168a78fd4d9572dff95432fcc4ba0e87563415b728Svetoslav Ganov super.onInitializeAccessibilityEvent(event); 1178a78fd4d9572dff95432fcc4ba0e87563415b728Svetoslav Ganov event.setClassName(Button.class.getName()); 1188a78fd4d9572dff95432fcc4ba0e87563415b728Svetoslav Ganov } 1198a78fd4d9572dff95432fcc4ba0e87563415b728Svetoslav Ganov 1208a78fd4d9572dff95432fcc4ba0e87563415b728Svetoslav Ganov @Override 1218a78fd4d9572dff95432fcc4ba0e87563415b728Svetoslav Ganov public void onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo info) { 1228a78fd4d9572dff95432fcc4ba0e87563415b728Svetoslav Ganov super.onInitializeAccessibilityNodeInfo(info); 1238a78fd4d9572dff95432fcc4ba0e87563415b728Svetoslav Ganov info.setClassName(Button.class.getName()); 1248a78fd4d9572dff95432fcc4ba0e87563415b728Svetoslav Ganov } 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 126