Tworzenie kontrolki przybornika WPF

Artykuł
01/12/2024

Szablon kontrolki przybornika WPF (Windows Presentation Framework) umożliwia tworzenie kontrolek WPF, które są automatycznie dodawane do przybornika po zainstalowaniu rozszerzenia. W tym przewodniku pokazano, jak za pomocą szablonu utworzyć kontrolkę Przybornik , którą można dystrybuować do innych użytkowników.

Tworzenie kontrolki przybornika

Tworzenie rozszerzenia za pomocą kontrolki przybornika WPF

Utwórz projekt VSIX o nazwie MyToolboxControl. Szablon projektu VSIX można znaleźć w oknie dialogowym Nowy projekt , wyszukując frazę "vsix".
Po otwarciu projektu dodaj szablon elementu kontrolki przybornika WPF o nazwie MyToolboxControl. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy węzeł projektu i wybierz polecenie Dodaj>nowy element. W oknie dialogowym Dodawanie nowego elementu przejdź do pozycji Visual C#>Rozszerzalność i wybierz pozycję Kontrolka przybornika WPF. W polu Nazwa w dolnej części okna zmień nazwę pliku polecenia na MyToolboxControl.cs.

Rozwiązanie zawiera teraz kontrolkę użytkownika, kontrolkę ProvideToolboxControlAttributeRegistrationAttribute , która dodaje kontrolkę do przybornika, oraz wpis Elementu zawartości Microsoft.VisualStudio.ToolboxControl w manifeście VSIX na potrzeby wdrożenia.

Aby utworzyć interfejs użytkownika kontrolki

Otwórz plik MyToolboxControl.xaml w projektancie.

Projektant wyświetla kontrolkę Grid zawierającą kontrolkę Button .
Rozmieść układ siatki. Po wybraniu kontrolki Grid niebieskie paski sterowania są wyświetlane u góry i lewej krawędzi siatki. Wiersze i kolumny można dodać do siatki, klikając paski.
Dodaj kontrolki podrzędne do siatki. Kontrolkę podrzędną można umieścić, przeciągając ją z przybornika do sekcji siatki lub ustawiając jej Grid.Row atrybuty i Grid.Column w języku XAML. W poniższym przykładzie dodano dwie etykiety w górnym wierszu siatki i przycisk w drugim wierszu.
```
<Grid>
    <Label Grid.Row="0" Grid.Column="0" Name="label1" />
    <Label Grid.Row="0" Grid.Column="1" Name="label2" />
    <Button Name="button1" Click="button1_Click" Grid.Row="1" Grid.ColumnSpan="2" />
</Grid>
```

Zmiana nazwy kontrolki

Domyślnie kontrolka będzie wyświetlana w przyborniku jako MyToolboxControl w grupie o nazwie MyToolboxControl.MyToolboxControl. Te nazwy można zmienić w pliku MyToolboxControl.xaml.cs .

Otwórz plik MyToolboxControl.xaml.cs w widoku kodu.
Znajdź klasę MyToolboxControl i zmień jej nazwę na TestControl. (Najszybszym sposobem wykonania tej czynności jest zmiana nazwy klasy, a następnie wybierz pozycję Zmień nazwę z menu kontekstowego i wykonaj kroki. (Aby uzyskać więcej informacji na temat Zmień nazwę polecenia, zobacz Zmiana nazwy refaktoryzacji (C#)).
Przejdź do atrybutu ProvideToolboxControl i zmień wartość pierwszego parametru na Test. Jest to nazwa grupy, która będzie zawierać kontrolkę w przyborniku.

Wynikowy kod powinien wyglądać następująco:
```
[ProvideToolboxControl("Test", true)]
public partial class TestControl : UserControl
{
    public TestControl()
    {
        InitializeComponent();
    }
}
```

Kompilowanie, testowanie i wdrażanie

Podczas debugowania projektu należy znaleźć kontrolkę zainstalowaną w przyborniku eksperymentalnego wystąpienia programu Visual Studio.

Aby skompilować i przetestować kontrolkę

Skompiluj projekt i rozpocznij debugowanie.
W nowym wystąpieniu programu Visual Studio utwórz projekt aplikacji WPF. Upewnij się, że Projektant XAML jest otwarty.
Znajdź kontrolkę w przyborniku i przeciągnij ją na powierzchnię projektową.
Rozpocznij debugowanie aplikacji WPF.
Sprawdź, czy kontrolka jest wyświetlana.

Aby wdrożyć kontrolkę

Po utworzeniu przetestowanego projektu można znaleźć plik vsix w folderze *\bin\debug* projektu.
Można go zainstalować na komputerze lokalnym, klikając dwukrotnie plik vsix i wykonując procedurę instalacji. Aby odinstalować kontrolkę, przejdź do pozycji Rozszerzenia narzędzi>i Aktualizacje i poszukaj rozszerzenia kontrolki, a następnie kliknij przycisk Odinstaluj.
Przekaż plik vsix do sieci lub witryny sieci Web.

Jeśli przekażesz plik do witryny sieci Web witryny Visual Studio Marketplace, inni użytkownicy mogą używać rozszerzeń narzędzi>i Aktualizacje w programie Visual Studio, aby znaleźć kontrolkę w trybie online i zainstalować ją.

Tworzenie kontrolki przybornika WPF