ClickMode 列舉

定義

命名空間:

Microsoft.UI.Xaml.Controls

指定控件應該引發 Click 事件的時間。

public enum class ClickMode

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
enum class ClickMode

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
public enum ClickMode

Public Enum ClickMode

<object property="enumMemberName"/>

繼承

Enum

ClickMode

屬性

ContractVersionAttribute

欄位

Hover	2	指定當滑鼠指標移到控件上方時，應該引發 Click 事件。
Press	1	指定按下滑鼠按鈕且滑鼠指標位於控件上方時，應該引發 Click 事件。 如果您使用鍵盤，指定按下SPACEBAR或 ENTER 鍵且控制件具有鍵盤焦點時，應該引發 Click 事件。
Release	0	指定按下並放開滑鼠左鍵時，應該引發 Click 事件，而滑鼠指標位於控件上方。 如果您使用鍵盤，請指定當SPACEBAR或 ENTER 鍵按下並放開時，應該引發 Click 事件，而控件具有鍵盤焦點。

範例

下列範例示範 ClickMode 列舉。

• 暫留 - 當滑鼠指標停留在第一個按鈕上時，按鈕的前景色彩會變更。
• 按下 - 按下滑鼠左鍵時，按下第二個按鈕時，按鈕的前景色彩會變更。
• 釋放 - 按下滑鼠按鈕並在第三個按鈕上方放開時，按鈕會將其他兩個按鈕的前景色彩重設為其原始色彩。

<StackPanel x:Name="LayoutRoot" Margin="10">
  <Button x:Name="btn1" Content="Hover to Click"
          Click="OnClick1" ClickMode="Hover"
          Margin="5" Width="150"
          HorizontalAlignment="Left"
          Foreground="Green"/>
  <TextBlock x:Name="text1" Margin="5,8,0,0" />
  
  <Button x:Name="btn2" Content="Press to Click"
          Click="OnClick2" ClickMode="Press"
          Margin="5,5,5,5" Width="150" 
          HorizontalAlignment="Left" 
          Foreground="Blue"/>
  <TextBlock x:Name="text2" Margin="5,8,0,0" />
  
  <Button x:Name="btn3" Content="Reset"
          Click="OnClick3" ClickMode="Release"
          Margin="5,5,5,5" Width="150"
          HorizontalAlignment="Left"/>
  <TextBlock x:Name="text3" Margin="5,8,0,0" />
</StackPanel>

void OnClick1(object sender, RoutedEventArgs e)
{
    btn1.Foreground = new SolidColorBrush(Windows.UI.Colors.Blue);
    text1.Text = "Click event occurs on Hover.";
    text2.Text = "";
    text3.Text = "";
}

void OnClick2(object sender, RoutedEventArgs e)
{
    btn2.Foreground = new SolidColorBrush(Windows.UI.Colors.Green);
    text1.Text = "";
    text2.Text = "Click event occurs on Press.";
    text3.Text = "";
}

void OnClick3(object sender, RoutedEventArgs e)
{
    btn1.Foreground = new SolidColorBrush(Windows.UI.Colors.Green);
    btn2.Foreground = new SolidColorBrush(Windows.UI.Colors.Blue);
    text1.Text = "";
    text2.Text = "";
    text3.Text = "Click event occurs on Release.";
}