Esta documentación está archivada y no tiene mantenimiento.

Button (Clase)

Actualización: noviembre 2007

Representa un control de botón de Windows.

Espacio de nombres:  System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)

[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
public class Button : ButtonBase, IButtonControl
/** @attribute ComVisibleAttribute(true) */
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
public class Button extends ButtonBase implements IButtonControl
public class Button extends ButtonBase implements IButtonControl

Se puede hacer clic en Button utilizando el mouse (ratón), la tecla ENTRAR o la BARRA ESPACIADORA si el botón tiene foco.

Se establece la propiedad AcceptButton o CancelButton de un objeto Form para permitir a los usuarios hacer clic en un botón presionando ENTRAR o ESCAPE incluso si el botón no tiene foco. Esto proporciona al formulario el comportamiento de un cuadro de diálogo.

Al mostrar un formulario mediante el método ShowDialog, se puede utilizar la propiedad DialogResult de un botón para especificar el valor devuelto de ShowDialog.

Es posible cambiar la apariencia del botón. Por ejemplo, para darle un aspecto liso a una página Web, hay que establecer la propiedad FlatStyle en FlatStyle.Flat. La propiedad FlatStyle también puede establecerse en FlatStyle.Popup, y el botón presentará un aspecto liso hasta que el puntero del mouse pase sobre el mismo, con lo cual a partir de ese momento el botón adoptará la apariencia de un botón estándar de Windows.

031c58k4.alert_note(es-es,VS.90).gifNota:

Si el control que tiene el foco acepta y procesa la acción de presionar la tecla ENTRAR, el control Button no lo procesa. Por ejemplo, si un control TextBox multilínea o cualquier otro botón tiene foco, dicho control procesa la acción de presionar la tecla ENTRAR en lugar del botón que representa la acción de Aceptar.

En el ejemplo siguiente se crea un control Button, se establece su propiedad DialogResult en DialogResult.OK y se agrega a un objeto Form.

private void InitializeMyButton()
 {
    // Create and initialize a Button.
    Button button1 = new Button();

    // Set the button to return a value of OK when clicked.
    button1.DialogResult = DialogResult.OK;

    // Add the button to the form.
    Controls.Add(button1);
 }



private void InitializeMyButton()
{
    // Create and initialize a Button.
    Button button1 = new Button();

    // Set the button to return a value of OK when clicked.
    button1.set_DialogResult(get_DialogResult().OK);

    // Add the button to the form.
    get_Controls().Add(button1);
} //InitializeMyButton


private function InitializeMyButton()
 {
    // Create and initialize a Button.
    var button1 : Button = new Button();

    // Set the button to return a value of OK when clicked.
    button1.DialogResult = System.Windows.Forms.DialogResult.OK;

    // Add the button to the form.
    Controls.Add(button1);
 }



Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Pocket PC

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 3.5, 2.0, 1.0
Mostrar: