ContextMenu 樣式和範本

發行項
08/12/2011

更新：2011 年 4 月

本主題說明 ContextMenu 控制項的樣式和範本。您可以修改預設的 ControlTemplate，讓控制項擁有獨特的外觀。如需詳細資訊，請參閱透過建立 ControlTemplate 自訂現有控制項的外觀。

ContextMenu 組件

ContextMenu 控制項沒有任何具名組件。

當您建立 ContextMenu 的 ControlTemplate 時，您的範本可能包含以 ScrollViewer 包住的 ItemsPresenter (ItemsPresenter 會顯示 ContextMenu 中的每一個項目，而 ScrollViewer 會啟用控制項內的捲動功能)。如果 ItemsPresenter 不是 ScrollViewer 的直接子系，您必須將 ItemsPresenter 命名為 ItemsPresenter。

ContextMenu 狀態

下表列出 ContextMenu 控制項的可見狀態。

VisualState 名稱	VisualStateGroup 名稱	描述
Valid	ValidationStates	控制項使用 Validation 類別，且 Validation.HasError 附加屬性為 false。
InvalidFocused	ValidationStates	Validation.HasError 附加屬性為 true 且控制項擁有焦點。
InvalidUnfocused	ValidationStates	Validation.HasError 附加屬性為 true 且控制項沒有焦點。

ContextMenu ControlTemplate 範例

下列範例顯示如何定義 ContextMenu 控制項的 ControlTemplate。

<Style TargetType="{x:Type ContextMenu}">
  <Setter Property="SnapsToDevicePixels"
          Value="True" />
  <Setter Property="OverridesDefaultStyle"
          Value="True" />
  <Setter Property="Grid.IsSharedSizeScope"
          Value="true" />
  <Setter Property="HasDropShadow"
          Value="True" />
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="{x:Type ContextMenu}">
        <Border x:Name="Border"
                Background="{StaticResource MenuPopupBrush}"
                BorderThickness="1">
          <Border.BorderBrush>
            <SolidColorBrush Color="{StaticResource BorderMediumColor}" />
          </Border.BorderBrush>
          <StackPanel IsItemsHost="True"
                      KeyboardNavigation.DirectionalNavigation="Cycle" />
        </Border>
        <ControlTemplate.Triggers>
          <Trigger Property="HasDropShadow"
                   Value="true">
            <Setter TargetName="Border"
                    Property="Padding"
                    Value="0,3,0,3" />
            <Setter TargetName="Border"
                    Property="CornerRadius"
                    Value="4" />
          </Trigger>
        </ControlTemplate.Triggers>
      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>

ControlTemplate 使用下列資源。

<!--Control colors.-->
<Color x:Key="WindowColor">#FFE8EDF9</Color>
<Color x:Key="ContentAreaColorLight">#FFC5CBF9</Color>
<Color x:Key="ContentAreaColorDark">#FF7381F9</Color>

<Color x:Key="DisabledControlLightColor">#FFE8EDF9</Color>
<Color x:Key="DisabledControlDarkColor">#FFC5CBF9</Color>
<Color x:Key="DisabledForegroundColor">#FF888888</Color>

<Color x:Key="SelectedBackgroundColor">#FFC5CBF9</Color>
<Color x:Key="SelectedUnfocusedColor">#FFDDDDDD</Color>

<Color x:Key="ControlLightColor">White</Color>
<Color x:Key="ControlMediumColor">#FF7381F9</Color>
<Color x:Key="ControlDarkColor">#FF211AA9</Color>

<Color x:Key="ControlMouseOverColor">#FF3843C4</Color>
<Color x:Key="ControlPressedColor">#FF211AA9</Color>


<Color x:Key="GlyphColor">#FF444444</Color>
<Color x:Key="GlyphMouseOver">sc#1, 0.004391443, 0.002428215, 0.242281124</Color>

<!--Border colors-->
<Color x:Key="BorderLightColor">#FFCCCCCC</Color>
<Color x:Key="BorderMediumColor">#FF888888</Color>
<Color x:Key="BorderDarkColor">#FF444444</Color>

<Color x:Key="PressedBorderLightColor">#FF888888</Color>
<Color x:Key="PressedBorderDarkColor">#FF444444</Color>

<Color x:Key="DisabledBorderLightColor">#FFAAAAAA</Color>
<Color x:Key="DisabledBorderDarkColor">#FF888888</Color>

<Color x:Key="DefaultBorderBrushDarkColor">Black</Color>

<!--Control-specific resources.-->
<Color x:Key="HeaderTopColor">#FFC5CBF9</Color>
<Color x:Key="DatagridCurrentCellBorderColor">Black</Color>
<Color x:Key="SliderTrackDarkColor">#FFC5CBF9</Color>

<Color x:Key="NavButtonFrameColor">#FF3843C4</Color>

<LinearGradientBrush x:Key="MenuPopupBrush"
                     EndPoint="0.5,1"
                     StartPoint="0.5,0">
  <GradientStop Color="{DynamicResource ControlLightColor}"
                Offset="0" />
  <GradientStop Color="{DynamicResource ControlMediumColor}"
                Offset="0.5" />
  <GradientStop Color="{DynamicResource ControlLightColor}"
                Offset="1" />
</LinearGradientBrush>

<LinearGradientBrush x:Key="ProgressBarIndicatorAnimatedFill"
                     StartPoint="0,0"
                     EndPoint="1,0">
  <LinearGradientBrush.GradientStops>
    <GradientStopCollection>
      <GradientStop Color="#000000FF"
                    Offset="0" />
      <GradientStop Color="#600000FF"
                    Offset="0.4" />
      <GradientStop Color="#600000FF"
                    Offset="0.6" />
      <GradientStop Color="#000000FF"
                    Offset="1" />
    </GradientStopCollection>
  </LinearGradientBrush.GradientStops>
</LinearGradientBrush>

如需完整範例，請參閱使用 ControlTemplates 設定樣式範例 (英文)。

請參閱

變更記錄

日期	記錄	原因
2011 年 4 月	加入有關在 ControlTemplate 中包含 ItemsPresenter 和 ScrollViewer 的說明。	資訊加強。
2010 年 8 月	新增 ControlTemplate 範例。	資訊加強。

2011 年 4 月

加入有關在 ControlTemplate 中包含 ItemsPresenter 和 ScrollViewer 的說明。

資訊加強。

2010 年 8 月

新增 ControlTemplate 範例。