如何使用包含的样式

本指南向您展示了如何从一个单独的样式文件中共享样式（该文件已包含在您的应用程序中）。这种方法允许您在多个应用程序之间共享样式。

要实现这一点，您需要在一个新的XAML文件中定义样式。在这里，根元素必须是Style或Styles元素之一。例如：

<Styles xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <Style Selector="TextBlock.h1">
        <Setter Property="FontSize" Value="24"/>
        <Setter Property="FontWeight" Value="Bold"/>
    </Style>
</Styles>

Avalonia UI 解决方案模板提供了一种快速添加样式文件到您的项目的方法。按照以下步骤进行操作：

• 在解决方案资源管理器中，右键单击您的项目。
• 点击添加和新建项
• 在Avalonia项目中，点击 Styles(Avalonia)
• 为您的样式文件输入一个名称

要使用在一个单独文件中定义的样式，您需要通过StyleInclude元素来引用它。source属性定义了样式文件的位置。您可以选择在哪个级别添加这个元素。

例如，要使用在名为AppStyles.axaml的文件中定义的样式（保存在/Styles文件夹中），您可以在窗口中添加如下的StyleInclude元素：

<Window ... >
    <Window.Styles>
        <StyleInclude Source="/Styles/AppStyles.axaml" />
    </Window.Styles>

    <StackPanel>
       <TextBlock Classes="h1">Heading 1</TextBlock>
       <TextBlock>This is not a heading and will not be changed.</TextBlock>
    </StackPanel>
</Window>

然而，更常见的是在App.axaml文件中引用样式文件，如下所示：

<Application... > 
    <Application.Styles>
        <FluentTheme Mode="Light"/>
        <StyleInclude Source="/AppStyles.axaml"/>
    </Application.Styles>
</Application>

这样将允许您在整个应用程序中使用来自单独文件的样式。

您还可以通过使用 avares:// 前缀来包含另一个程序集的样式：

<Application... > 
    <Application.Styles>
        <FluentTheme Mode="Light"/>
        <StyleInclude Source="avares://MyApp.Shared/Styles/CommonAppStyles.axaml"/>
    </Application.Styles>
</Application>

将引用 MyApp.Shared 项目中的 /Styles/CommonAppStyles.axaml 文件。