| Button Class |
Represents a templated button control that interprets a Click user interaction.
Inheritance HierarchySystemObject
Windows.UI.XamlDependencyObject
Windows.UI.XamlUIElement
Windows.UI.XamlFrameworkElement
Windows.UI.Xaml.ControlsControl
Windows.UI.Xaml.ControlsContentControl
Windows.UI.Xaml.Controls.PrimitivesButtonBase
Windows.UI.Xaml.ControlsButton
Windows.UI.XamlDependencyObject
Windows.UI.XamlUIElement
Windows.UI.XamlFrameworkElement
Windows.UI.Xaml.ControlsControl
Windows.UI.Xaml.ControlsContentControl
Windows.UI.Xaml.Controls.PrimitivesButtonBase
Windows.UI.Xaml.ControlsButton
Namespace: Windows.UI.Xaml.Controls
Assembly: CSharpXamlForHtml5 (in CSharpXamlForHtml5.dll) Version: 1.0.0.0
SyntaxC#
public class Button : ButtonBase
The Button type exposes the following members.
ConstructorsMethods| Name | Description | |
|---|---|---|
 | CapturePointer |
Sets pointer capture to a UIElement.
(Inherited from UIElement.) |
| CreateDomChildWrapper |
When overriden, creates a dom wrapper for each child that is added to the UIElement.
(Inherited from UIElement.) |
| CreateDomElement | (Inherited from Control.) |
| Equals(Object) | (Inherited from Object.) |
| FindName |
Retrieves an object that has the specified identifier name.
(Inherited from FrameworkElement.) |
| Focus |
Attempts to set the focus on the control.
(Inherited from Control.) |
| GetChildsWrapper | (Inherited from UIElement.) |
| GetDomElementWhereToPlaceChild | (Inherited from UIElement.) |
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
 | GetTemplateChild |
Retrieves the named element in the instantiated ControlTemplate visual tree.
(Inherited from Control.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| GetValue |
Returns the current effective value of a dependency property from a DependencyObject.
(Inherited from DependencyObject.) |
| GetVisualStateValue | (Inherited from DependencyObject.) |
| INTERNAL_GetVisualStateGroups | (Inherited from Control.) |
| ManageIsEnabled | (Inherited from Control.) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| OnAfterApplyHorizontalAlignmentAndWidth | (Inherited from FrameworkElement.) |
| OnAfterApplyVerticalAlignmentAndWidth | (Inherited from FrameworkElement.) |
| OnApplyTemplate | (Inherited from Control.) |
| OnContentChanged |
Invoked when the value of the Content property changes.
(Inherited from ContentControl.) |
| OnGotFocus |
Raises the GotFocus event
(Inherited from UIElement.) |
| OnKeyDown |
Raises the KeyDown event
(Inherited from UIElement.) |
| OnKeyUp |
Raises the KeyUp event
(Inherited from UIElement.) |
| OnLostFocus |
Raises the LostFocus event
(Inherited from UIElement.) |
| OnPointerEntered |
Raises the PointerEntered event
(Inherited from UIElement.) |
| OnPointerExited |
Raises the PointerExited event
(Inherited from UIElement.) |
| OnPointerMoved | (Inherited from UIElement.) |
| OnPointerPressed |
Raises the PointerPressed event
(Inherited from UIElement.) |
| OnPointerReleased |
Raises the PointerReleased event
(Inherited from UIElement.) |
| OnTapped |
Raises the Tapped event
(Inherited from UIElement.) |
| ReadLocalValue |
Returns the local value of a dependency property, if a local value is set.
(Inherited from DependencyObject.) |
| RegisterName | (Inherited from Control.) |
| ReleasePointerCapture |
Releases pointer captures for capture of one specific pointer by this UIElement.
(Inherited from UIElement.) |
| SetBinding |
Attaches a binding to a FrameworkElement, using the provided binding object.
(Inherited from DependencyObject.) |
| SetInheritedValue |
Sets the inherited value of a dependency property on a DependencyObject. Do not use this method.
(Inherited from DependencyObject.) |
| SetLocalValue |
Sets the local value of a dependency property on a DependencyObject while not overriding a hypothetical Binding (example: when the user writes in a TextBox with a two way Binding on its Text property).
(Inherited from DependencyObject.) |
| SetValue |
Sets the local value of a dependency property on a DependencyObject.
(Inherited from DependencyObject.) |
| SetVisualStateValue | (Inherited from DependencyObject.) |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
| TransformToVisual |
Returns a transform object that can be used to transform coordinates from
the UIElement to the specified object.
(Inherited from UIElement.) |
| UnregisterName | (Inherited from Control.) |
Fields| Name | Description | |
|---|---|---|
 | _disableBaseControlHandlingOfVisualStates | (Inherited from Control.) |
| _forceClickEventToBeTheLastEventRaised | (Inherited from ButtonBase.) |
Properties| Name | Description | |
|---|---|---|
 | ActualHeight |
Gets the rendered height of a FrameworkElement. The FrameworkElement must be in the visual tree,
otherwise this property will return double.NaN.
(Inherited from FrameworkElement.) |
| ActualWidth |
Gets the rendered width of a FrameworkElement. The FrameworkElement must be in the visual tree,
otherwise this property will return double.NaN.
(Inherited from FrameworkElement.) |
| Background |
Gets or sets a brush that provides the background of the control.
(Inherited from Control.) |
| BorderBrush |
Gets or sets a brush that describes the border background of a control.
(Inherited from Control.) |
| BorderThickness |
Gets or sets the thickness of the border.
(Inherited from Control.) |
| Command |
Gets or sets the command to invoke when this button is pressed.
(Inherited from ButtonBase.) |
| CommandParameter |
Gets or sets the parameter to pass to the Command property.
(Inherited from ButtonBase.) |
| Content |
Gets or sets the content of a ContentControl.
(Inherited from ContentControl.) |
| ContentTemplate |
Gets or sets the data template that is used to display the content of the
ContentControl.
(Inherited from ContentControl.) |
| Cursor |
Gets or sets the cursor that displays when the mouse pointer is over this
element.
(Inherited from FrameworkElement.) |
| DataContext |
Gets or sets the data context for a FrameworkElement when it participates
in data binding.
(Inherited from FrameworkElement.) |
| Dispatcher |
Gets the CoreDispatcher that this object is associated with.
(Inherited from DependencyObject.) |
| Effect | (Inherited from UIElement.) |
| FontFamily |
Gets or sets the font used to display text in the control.
(Inherited from Control.) |
| FontSize |
Gets or sets the size of the text in this control.
(Inherited from Control.) |
| FontWeight |
Gets or sets the thickness of the specified font.
(Inherited from Control.) |
| Foreground |
Gets or sets a brush that describes the foreground color.
(Inherited from Control.) |
| Height |
Gets or sets the suggested height of a FrameworkElement.
(Inherited from FrameworkElement.) |
| HorizontalAlignment |
Gets or sets the horizontal alignment characteristics that are applied to
a FrameworkElement when it is composed in a layout parent, such as a panel
or items control.
(Inherited from FrameworkElement.) |
| HorizontalContentAlignment |
Gets or sets the horizontal alignment of the control's content.
(Inherited from Control.) |
| IsEnabled |
Gets or sets a value indicating whether the user can interact with the control.
(Inherited from FrameworkElement.) |
| IsHitTestVisible |
Gets or sets whether the contained area of this UIElement can return true
values for hit testing.
(Inherited from FrameworkElement.) |
| IsLoaded |
Gets a value that indicates whether this element is in the Visual Tree, that is, if it has been loaded for presentation.
(Inherited from FrameworkElement.) |
| Margin |
Gets or sets the outer margin of a FrameworkElement.
(Inherited from FrameworkElement.) |
| Name |
Gets or sets the identifying name of the object. When a XAML processor creates
the object tree from XAML markup, run-time code can refer to the XAML-declared
object by this name.
(Inherited from FrameworkElement.) |
| Opacity |
Gets or sets the degree of the object's opacity.
A value between 0 and 1.0 that declares the opacity factor, with 1.0 meaning
full opacity and 0 meaning transparent. The default value is 1.0.
(Inherited from UIElement.) |
| Padding |
Gets or sets the distance between the border and its child object.
(Inherited from Control.) |
| RenderTransform |
Gets or sets transform information that affects the rendering position of
a UIElement.
(Inherited from UIElement.) |
| RenderTransformOrigin | (Inherited from UIElement.) |
| Resources |
Gets the locally defined resource dictionary. In XAML, you can establish
resource items as child object elements of a frameworkElement.Resources property
element, through XAML implicit collection syntax.
(Inherited from FrameworkElement.) |
| Style |
Gets or sets an instance Style that is applied for this object during rendering.
(Inherited from FrameworkElement.) |
| TabIndex |
Gets or sets a value that determines the order in which elements receive
focus when the user navigates through controls by pressing the Tab key.
The default value is MaxValue
(Inherited from Control.) |
| Tag |
Gets or sets an arbitrary object value that can be used to store custom information
about this object.
(Inherited from FrameworkElement.) |
| Template |
Gets or sets a control template.
(Inherited from Control.) |
| UseLayoutRounding |
Gets or sets a value that determines whether rendering for the object and
its visual subtree should use rounding behavior that aligns rendering to
whole pixels.
(Inherited from UIElement.) |
| VerticalAlignment |
Gets or sets the vertical alignment characteristics that are applied to a
FrameworkElement when it is composed in a parent object such as a panel or
items control.
(Inherited from FrameworkElement.) |
| VerticalContentAlignment |
Gets or sets the vertical alignment of the control's content.
(Inherited from Control.) |
| Visibility |
Gets or sets the visibility of a UIElement. A UIElement that is not visible
is not rendered and does not communicate its desired size to layout.
(Inherited from UIElement.) |
| Width |
Gets or sets the width of a FrameworkElement.
(Inherited from FrameworkElement.) |
Events| Name | Description | |
|---|---|---|
 | Click |
Occurs when a button control is clicked.
(Inherited from ButtonBase.) |
| GotFocus |
Occurs when the pointer device that previously initiated a Press action is
pressed, while within this element.
Note that ONLY sender's informations are currently filled (not pointer's)
(Inherited from UIElement.) |
| KeyDown |
Occurs when a keyboard key is pressed while the UIElement has focus.
(Inherited from UIElement.) |
| KeyUp |
Occurs when a keyboard key is released while the UIElement has focus.
(Inherited from UIElement.) |
| Loaded |
Occurs when a FrameworkElement has been constructed and added to the object tree.
(Inherited from FrameworkElement.) |
| LostFocus |
Occurs when a UIElement loses focus.
(Inherited from UIElement.) |
| PointerEntered |
Occurs when a pointer enters the hit test area of this element.
(Inherited from UIElement.) |
| PointerExited |
Occurs when a pointer leaves the hit test area of this element.
(Inherited from UIElement.) |
| PointerMoved |
Occurs when the pointer device that previously initiated a Press action is
moved, while within this element.
(Inherited from UIElement.) |
| PointerPressed |
Occurs when the pointer device that previously initiated a Press action is
pressed, while within this element.
(Inherited from UIElement.) |
| PointerReleased |
Occurs when the pointer device that previously initiated a Press action is
released, while within this element.
(Inherited from UIElement.) |
| Tapped |
Occurs when an otherwise unhandled Tap interaction occurs over the hit test
area of this element.
(Inherited from UIElement.) |
| Unloaded |
Occurs when this object is no longer connected to the main object tree.
(Inherited from FrameworkElement.) |
ExamplesC#
void MyButton_Click(object sender, RoutedEventArgs e) { MessageBox.Show("You clicked me."); Window.Current.IsEnabled = false; }
XAML
<Button Content="Click me" Margin="0,5,0,0" Foreground="White" Background="#FFE44D26" HorizontalAlignment="Left" Click="MyButton_Click" />
See Also