主题资源

Windows Phone 对主题资源使用资源字典，它是一个键控对象字典，可在 XAML 和代码中使用。本节提供有关 Windows Phone 资源字典中提供的特定主题属性的信息。您的应用程序可以访问此处显示的属性，并使用 XAML 代码将其绑定到控件。在运行时，这些资源会被添加到应用程序中。

---

下表列出了并定义 Windows Phone 中提供的主题属性。可以在设计器中使用控件属性或使用 {StaticResource} 标记扩展通过 XAML 应用它们。后者通过计算对已定义资源的引用来为任何 XAML 属性 (Property) 的属性 (Attribute) 提供值。有关如何将这些资源绑定到控件的信息，请参见如何应用 Windows Phone 的主题资源。

本主题包含下列主题属性：

1. 画笔资源

2. 颜色资源

3. 字体名称

4. 粗细

5. 字体大小

6. 文本样式

7. 主题可见性和不透明度

画笔资源

本表列出并介绍了可以应用的各种画笔。

 

名称	类型	描述
PhoneAccentBrush	SolidColorBrush	所选目标项的前景色
PhoneForegroundBrush	SolidColorBrush	默认的前景和边框颜色
PhoneBackgroundBrush	SolidColorBrush	页面和其他控件的默认背景
PhoneContrastBackgroundBrush	SolidColorBrush	对比元素的背景
PhoneContrastForegroundBrush	SolidColorBrush	对比元素的前景
PhoneDisabledBrush	SolidColorBrush	禁用的前景和颜色
PhoneSubtleBrush	SolidColorBrush	细微前景和边框
TransparentBrush	SolidColorBrush	用于背景和触控目标的 100% 透明画笔
PhoneSemitransparentBrush	SolidColorBrush	用于提供图像背景对比度的部分透明背景画笔
PhoneChromeBrush	SolidColorBrush	用于匹配应用程序栏颜色

TextBox 画笔

 

名称	类型	描述
PhoneTextBoxBrush	SolidColorBrush	TextBox 控件画笔
PhoneTextCaretBrush	SolidColorBrush	TextBox 中符号画笔
PhoneTextBoxForegroundBrush	SolidColorBrush	TextBox 控件前景画笔
PhoneTextBoxEditBackgroundBrush	SolidColorBrush	TextBox 控件编辑前景画笔
PhoneTextBoxEditBorderBrush	SolidColorBrush	TextBox 控件编辑边框画笔
PhoneTextBoxReadOnlyBrush	SolidColorBrush	TextBox 控件只读状态画笔。
PhoneTextBoxSelectionForegroundBrush	SolidColorBrush	TextBox 控件选择内容前景画笔

RadioButton 和 CheckBox 画笔

 

名称	类型	描述
PhoneRadioCheckBoxBrush	SolidColorBrush	RadioButton 和 CheckBox 画笔
PhoneRadioCheckBoxDisabledBrush	SolidColorBrush	禁用的 RadioButton 和 CheckBox 状态画笔
PhoneRadioCheckBoxCheckBrush	SolidColorBrush	CheckBox 选中画笔
PhoneRadioCheckBoxCheckDisabledBrush	SolidColorBrush	禁用的 CheckBox 选中画笔
PhoneRadioCheckBoxPressedBrush	SolidColorBrush	RadioButton 和 CheckBox 按下状态画笔
PhoneRadioCheckBoxPressedBorderBrush	SolidColorBrush	RadioButton 和 CheckBox 按下状态画笔

颜色资源

本表列出并介绍了可以通过画笔资源应用的各种颜色。

注意：

您应该尝试使用画笔资源，而不是直接使用或修改颜色。这是因为在您的应用程序中只能修改画笔值，而不能修改颜色。

 

名称	类型	描述
PhoneBackgroundColor	Color	页面和其他控件的默认背景
PhoneForegroundColor	Color	默认的前景和边框颜色
PhoneDisabledColor	Color	禁用的前景和颜色
PhoneSubtleColor	Color	细微前景和边框
PhoneAccentColor	Color	所选目标项的前景色
PhoneContrastBackgroundColor	Color	对比元素的背景
PhoneContrastForegroundColor	Color	对比元素的前景
PhoneChromeColor	Color	状态栏和应用程序栏的颜色
PhoneSemitransparentColor	Color	用于提供图像背景对比度的部分透明色

TextBox 颜色

 

名称	类型	描述
PhoneTextBoxColor	Color	TextBox 控件的颜色
PhoneTextCaretColor	Color	TextBox 中符号的颜色
PhoneTextBoxForegroundColor	Color	TextBox 控件前景颜色
PhoneTextBoxEditBackgroundColor	Color	TextBox 控件编辑背景颜色
PhoneTextBoxEditBorderColor	Color	TextBox 控件编辑边框颜色
PhoneTextBoxReadOnlyColor	Color	TextBox 控件只读状态颜色。
PhoneTextBoxSelectionForegroundColor	Color	TextBox 控件选择内容前景颜色

RadioButton 和 CheckBox 颜色

 

名称	类型	描述
PhoneRadioCheckBoxColor	Color	RadioButton 和 CheckBox 颜色
PhoneRadioCheckBoxDisabledColor	Color	禁用的 RadioButton 和 CheckBox 状态颜色
PhoneRadioCheckBoxCheckColor	Color	CheckBox 选中的颜色
PhoneRadioCheckBoxCheckDisabledColor	Color	禁用的 CheckBox 选中的颜色
PhoneRadioCheckBoxPressedColor	Color	RadioButton 和 CheckBox 按下状态颜色
PhoneRadioCheckBoxPressedBorderColor	Color	RadioButton 和 CheckBox 按下状态颜色

字体名称

本表列出并介绍了可以应用的各种字体名称。属性 = FontFamily

 

名称	类型	值
PhoneFontFamilyNormal	Font Family	Segoe WP
PhoneFontFamilyLight	Font Family	Segoe WP Light
PhoneFontFamilySemiLight	Font Family	Segoe WP Semilight
PhoneFontFamilySemiBold	Font Family	Segoe WP Semibold

粗细

本表列出并介绍了应用到 UI 元素的粗细。属性 = BorderThickness、Margin、Padding

 

名称	类型	值
PhoneHorizontalMargin	BorderThickness、Margin、Padding	12、0
PhoneVerticalMargin	BorderThickness、Margin、Padding	0、12
PhoneMargin	BorderThickness、Margin、Padding	12
PhoneTouchTargetOverhang	BorderThickness、Margin、Padding	12
PhoneTouchTargetLargeOverhang	BorderThickness、Margin、Padding	12、20
PhoneTextBoxInnerMargin	BorderThickness、Margin、Padding	1,2
PhonePasswordBoxInnerMargin	BorderThickness、Margin、Padding	3,2
PhoneBorderThickness	BorderThickness、Margin、Padding	3
PhoneStrokeThickness	BorderThickness、Margin、Padding	3

字体大小

本表列出并介绍了可以应用的各种字体大小。属性 = FontSize

 

名称	类型	描述
PhoneFontSizeSmall	Double	18.667
PhoneFontSizeNormal	Double	20
PhoneFontSizeMedium	Double	22.667
PhoneFontSizeMediumLarge	Double	25.333
PhoneFontSizeLarge	Double	32
PhoneFontSizeExtraLarge	Double	42.667
PhoneFontSizeExtraExtraLarge	Double	72
PhoneFontSizeHuge	Double	186.667

文本样式

下表提供了您可以应用到 TextBlock 控件的文本样式选项。属性 = 样式。

提示：

您可以使用 Blend for Visual Studio 预览文本样式，然后将其应用到对象。有关更多信息，请参见 Blend for Visual Studio 2012。

 

名称	适用于：	类型	描述
PhoneTextBlockBase	TextBlock	Style	FontFamily：PhoneFontFamilyNormal FontSize：PhoneFontSizeNormal 前景：PhoneForegroundBrush 边距： PhoneHorizontalMargin
PhoneTextNormalStyle	TextBlock	Style	BasedOn：PhoneTextBlockBase
PhoneTextSubtleStyle	TextBlock	Style	BasedOn：PhoneTextBlockBase 前景：PhoneSubtleBrush
PhoneTextTitle1Style	TextBlock	Style	BasedOn：PhoneTextBlockBase FontFamily：PhoneFontFamilySemiLight FontSize：PhoneFontSizeExtraExtraLarge
PhoneTextTitle2Style	TextBlock	Style	BasedOn：PhoneTextBlockBase FontFamily:PhoneFontFamilySemiLight FontSize：PhoneFontSizeLarge
PhoneTextTitle3Style	TextBlock	Style	BasedOn：PhoneTextBlockBase FontFamily：PhoneFontFamilySemiLight FontSize：PhoneFontSizeMedium
PhoneTextSmallStyle	TextBlock	Style	BasedOn：PhoneTextBlockBase FontSize：PhoneFontSizeSmall 前景：PhoneSubtleBrush
PhoneTextLargeStyle	TextBlock	Style	BasedOn：PhoneTextBlockBase FontFamily：PhoneFontFamilySemiLight FontSize：PhoneFontSizeLarge
PhoneTextExtraLargeStyle	TextBlock	Style	BasedOn：PhoneTextBlockBase FontFamily：PhoneFontFamilySemiLight FontSize：PhoneFontSizeExtraLarge
PhoneTextGroupHeaderStyle	TextBlock	Style	BasedOn：PhoneTextBlockBase FontFamily：PhoneFontFamilySemiLight FontSize：PhoneFontSizeLarge 前景：PhoneSubtleBrush
PhoneTextContrastStyle	TextBlock	Style	BasedOn：PhoneTextBlockBase FontFamily：PhoneFontFamilySemiBold 前景：PhoneContrastForegroundBrush
PhoneTextAccentStyle	TextBlock	Style	BasedOn：PhoneTextBlockBase FontFamily：PhoneFontFamilySemiBold 前景：PhoneAccentBrush
PhoneTextHugeStyle	TextBlock	Style	BasedOn：PhoneTextBlockBase FontFamily：PhoneFontFamilyLight FontSize：PhoneFontSizeHuge

主题可见性和不透明度

别外还有一些可用来调整深色和浅色主题背景可见性和不透明度的资源：

Visibility

 

名称	类型	描述
PhoneDarkThemeVisibility	Visibility	在深色主题中可见，而在浅色主题中会折叠
PhoneLightThemeVisibility	Visibility	在浅色主题中可见，而在深色主题中会折叠

Opacity

 

名称	类型	描述
PhoneDarkThemeOpacity	Double	1 表示深色主题，0 表示浅色主题
PhoneLightThemeOpacity	Double	0 表示深色主题，1 表示浅色主题