Vytvoření ovládacího prvku panelu nástrojů WPF

Článek
01/12/2024

Šablona ovládacího prvku sady nástrojů WPF (Windows Presentation Framework) umožňuje vytvořit ovládací prvky WPF, které se při instalaci rozšíření automaticky přidají do sady nástrojů . Tento názorný postup ukazuje, jak pomocí šablony vytvořit ovládací prvek Panel nástrojů , který můžete distribuovat ostatním uživatelům.

Vytvoření ovládacího prvku Panel nástrojů

Vytvoření rozšíření pomocí ovládacího prvku WPF Toolbox

Vytvořte projekt VSIX s názvem MyToolboxControl. Šablonu projektu VSIX najdete v dialogovém okně Nový projekt vyhledáním "vsix".
Po otevření projektu přidejte šablonu položky ovládacího prvku WPF Panel nástrojů s názvem MyToolboxControl. V Průzkumník řešení klikněte pravým tlačítkem myši na uzel projektu a vyberte Přidat>novou položku. V dialogovém okně Přidat novou položku přejděte do visual C#>Rozšiřitelnost a vyberte ovládací prvek WPF Toolbox. V poli Název v dolní části okna změňte název souboru příkazu na MyToolboxControl.cs.

Řešení teď obsahuje uživatelský ovládací prvek, ProvideToolboxControlAttribute RegistrationAttribute který přidá ovládací prvek do sady nástrojů a položku assetu Microsoft.VisualStudio.ToolboxControl v manifestu VSIX pro nasazení.

Vytvoření uživatelského rozhraní ovládacího prvku

Otevřete Soubor MyToolboxControl.xaml v návrháři.

Návrhář zobrazuje Grid ovládací prvek, který obsahuje Button ovládací prvek.
Uspořádejte rozložení mřížky. Když ovládací prvek vyberete Grid , zobrazí se modré řídicí pruhy v horní a levé části mřížky. Kliknutím na pruhy můžete do mřížky přidat řádky a sloupce.
Přidejte do mřížky podřízené ovládací prvky. Podřízený ovládací prvek můžete umístit přetažením z panelu nástrojů do oddílu mřížky nebo nastavením jeho Grid.Row a Grid.Column atributů v xaml. Následující příklad přidá dva popisky na horním řádku mřížky a tlačítko na druhém řádku.
```
<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>
```

Přejmenování ovládacího prvku

Ve výchozím nastavení se ovládací prvek zobrazí v sadě nástrojů jako MyToolboxControl ve skupině s názvem MyToolboxControl.MyToolboxControl. Tyto názvy můžete změnit v souboru MyToolboxControl.xaml.cs .

Otevřete MyToolboxControl.xaml.cs v zobrazení kódu.
MyToolboxControl Vyhledejte třídu a přejmenujte ji na TestControl. (Nejrychlejším způsobem, jak to udělat, je přejmenovat třídu a pak vybrat Přejmenujte z místní nabídky a proveďte kroky. (Další informace o Přejmenujte příkaz, viz Přejmenování refaktoringu (C#).)
Přejděte na ProvideToolboxControl atribut a změňte hodnotu prvního parametru na Test. Toto je název skupiny, která bude obsahovat ovládací prvek v sadě nástrojů.

Výsledný kód by měl vypadat takto:
```
[ProvideToolboxControl("Test", true)]
public partial class TestControl : UserControl
{
    public TestControl()
    {
        InitializeComponent();
    }
}
```

Sestavení, testování a nasazení

Při ladění projektu byste měli najít ovládací prvek nainstalovaný v sadě nástrojů experimentální instance sady Visual Studio.

Sestavení a otestování ovládacího prvku

Znovu sestavte projekt a spusťte ladění.
V nové instanci sady Visual Studio vytvořte projekt aplikace WPF. Ujistěte se, že je otevřený Návrhář XAML.
Najděte ovládací prvek v sadě nástrojů a přetáhněte ho na návrhovou plochu.
Spusťte ladění aplikace WPF.
Ověřte, že se zobrazí ovládací prvek.

Nasazení ovládacího prvku

Po sestavení otestovaného projektu najdete soubor .vsix ve složce *\bin\debug* projektu.
Můžete ho nainstalovat do místního počítače poklikáním na soubor .vsix a postupem instalace. Chcete-li ovládací prvek odinstalovat, přejděte do nástroje>Rozšíření a Aktualizace a vyhledejte rozšíření ovládacího prvku a klepněte na tlačítko Odinstalovat.
Nahrajte soubor .vsix do sítě nebo na web.

Pokud soubor nahrajete na web Visual Studio Marketplace, můžou ostatní uživatelé pomocí rozšíření a aktualizací nástrojů>v sadě Visual Studio najít ovládací prvek online a nainstalovat ho.

Sdílet prostřednictvím