ButtonBase.ClickMode Property
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Gets or sets when the Click event occurs.
Assembly: System.Windows (in System.Windows.dll)
XMLNS for XAML: Not mapped to an xmlns.
<button ClickMode="clickModeValue"/>
XAML Values
Property Value
Type: System.Windows.Controls.ClickModeWhen the Click event occurs. The default value is ClickMode.Release.
Dependency property identifier field: ClickModeProperty
Use this property to set what type of user interaction is required to raise a Click event. When a button's click mode is Hover, the Click event cannot be raised by using the keyboard.
The following example shows three buttons that respond to taps in three different ways based on their ClickMode property value.
Hover - When the finger is pressed to the screen outside of the control and then moves over first button, the foreground color of the button changes.
Press - When the finger makes contact with the second button, the foreground color of the button changes.
Release - When the finger presses and releases the third button, the button resets the foreground color of the other two buttons to their original color.
void OnClick1(object sender, RoutedEventArgs e) { btn1.Foreground = new SolidColorBrush(Colors.Blue); text1.Text = "Click event handled on Hover."; text2.Text = ""; text3.Text = ""; } void OnClick2(object sender, RoutedEventArgs e) { btn2.Foreground = new SolidColorBrush(Colors.Green); text1.Text = ""; text2.Text = "Click event handled on Press."; text3.Text = ""; } void OnClick3(object sender, RoutedEventArgs e) { btn1.Foreground = new SolidColorBrush(Colors.Green); btn2.Foreground = new SolidColorBrush(Colors.Blue); text1.Text = ""; text2.Text = ""; text3.Text = "Click event handled on Release."; }
<StackPanel x:Name="LayoutRoot" Background="Transparent" Margin="10">
<Button x:Name="btn1" Margin ="5"
HorizontalAlignment="Left"
Foreground="Green" Width="240" Click="OnClick1"
Content="Hover to Click" ClickMode="Hover" />
<TextBlock x:Name="text1" Margin ="0,8,0,0" />
<Button x:Name="btn2" Margin ="5,5,5,5"
HorizontalAlignment="Left"
Foreground="Blue" Width="240" Click="OnClick2"
Content="Press to Click" ClickMode="Press" />
<TextBlock x:Name="text2" Margin="0,8,0,0" />
<Button x:Name="btn3" Margin ="5,5,5,5"
HorizontalAlignment="Left"
Click="OnClick3" Width="240" Content="Reset"
ClickMode="Release"/>
<TextBlock x:Name="text3" Margin ="0,8,0,0" />
</StackPanel>