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ę ProvideToolboxControlAttribute RegistrationAttribute , 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 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 Narzędzia>Rozszerzenia 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 będą mogli użyć rozszerzeń narzędzi>i aktualizacji w programie Visual Studio, aby znaleźć kontrolkę w trybie online i zainstalować ją.

Udostępnij za pośrednictwem

Tworzenie kontrolki przybornika WPF