# 控件类别

如果你想要创建自己的控件，Avalonia有三个主要的控件类别。在创建自定义控件之前，你需要根据使用场景选择一个最合适的控件类别。

### User Control

`UserControl` 是最简单的创建自定义控件的方法。这种类型的控件最适合创建特定于程序的“Views”或者“Pages” 。`UserControl`和创建Window的方法一样，创建一个新的UserControl，并向其添加控件即可。

### Templated Controls

`TemplatedControl`是最常使用的、能在多个程序之间共享的通用控件。它们在初始状态下没有外观，这意味着它们可以为不同的主题和应用程序重新设计外观。Avalonia定义的大多数标准控件都属于这一类。

{% hint style="info" %}
在 WPF/UWP 中你需要从 Control 类型继承来创建一个新的控件，但是在 Avalonia 中你需要从`TemplatedControl`继承。
{% endhint %}

{% hint style="info" %}
如果你想在一个单独的文件中为你创建的`TemplatedControl`提供一个`Style`，别忘记在你的应用程序中使用 [`StyleInclude`](https://docs.avaloniaui.net/docs/styling/styles) 导入这个文件。
{% endhint %}

### Basic Control

`Control`是用户界面的基础 - 它们通过重写`Visual.Render`方法来使用几何图形绘制自己。像`TextBlock`和 `Image`这样的控件就属于这一类。

{% hint style="info" %}
在 WPF/UWP 中你需要从 FrameworkElement 类型继承来创建一个新的控件，但是在 Avalonia 你需要从`Control`继承。
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://avaloniachina.gitbook.io/avalonia/docs/authoring-controls/types-of-control.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.