Ovládací prvky obsahu
Ovládací prvky obsahu poskytují způsob pro vás návrh dokumentů a šablon, které mají tyto funkce:
Uživatelské rozhraní (UI), který byl řízen vstupní formulář, atd.
Omezení, které brání uživatelům úpravy chráněné oddíly dokumentu nebo šablony.Další informace naleznete v Ochrana částí dokumentů pomocí ovládacích prvků pomocí obsahu.
Vázání ke zdroji datDalší informace naleznete v Vazby dat ovládacích prvků obsahu.
Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu i na úrovni aplikace ve Wordu 2013 a ve Wordu 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.
.gif "odkaz na video")
Související video ukázku naleznete v tématu Vazby dat Word 2007 obsah ovládací prvky pomocí Visual Studio Tools pro systém Office (3.0).
Přehled ovládacích prvků obsahu
Ovládací prvky obsahu poskytují uživatelské rozhraní, která je optimalizována pro oba uživatele vstupní a tisku.Pokud přidáte ovládací prvek obsahu dokumentu, ovládací prvek je identifikován ohraničení, název a dočasné text, který může poskytnout pokyny pro uživatele.Ohraničení a titulek ovládacího prvku nezobrazí v tištěné verze dokumentu.
Například pokud chcete, aby uživatel zadat datum v části dokumentu, můžete přidat ovládací prvek obsahu pro výběr data v dokumentu.Když uživatelé klepnou na ovládací prvek Výběr data standardního uživatelského rozhraní zobrazí.Můžete také nastavit vlastnosti ovládacího prvku nastavit místní kalendáře, který je zobrazen a určete formát data.Poté, co uživatel vybere datum, skryté UI ovládacího prvku a pokud uživatel vytiskne dokument, zobrazí se pouze datum.
Obsah se řídí také Nápověda, proveďte následující:
Zabráníte uživatelům v úpravách nebo odstraňování částí dokumentu.To je užitečné, pokud máte informace v dokumentu nebo šablony, který by měl být schopen číst, ale nikoli upravovat uživatelé nebo uživatelé moci upravit ovládací prvky obsahu, ale k jejich odstranění.
Části dokumentu nebo šablony lze vázat na data.Můžete svázat ovládací prvky obsahu pole v databázi, spravované objekty v .NET Framework, elementy XML, které jsou uloženy v dokumentu a jiných zdrojů dat.
V projekty na úrovni dokumentu můžete přidat ovládací prvky obsahu dokumentu v době návrhu nebo za běhu.V projektech aplikace můžete přidat ovládací prvky obsahu do libovolného dokumentu otevřeného v době běhu.Další informace naleznete v tématu Postupy: Přidání ovládacích prvků obsahu do dokumentů aplikace Word.
[!POZNÁMKA]
Ovládací prvky obsahu můžete použít pouze v dokumentech, které jsou uloženy ve formátu Open XML.Ovládací prvky obsahu nelze použít v dokumentech, které jsou uloženy ve formátu DOC aplikace Word 97-2003.
Typy ovládacích prvků obsahu
Existuje devět různých typů ovládacích prvků obsahu, které lze přidat do dokumentů.Většina ovládacích prvků obsahu mají odpovídající typ v Microsoft.Office.Tools.Word oboru názvů.Můžete také použít obecný ContentControl, které představují, všechny dostupné ovládací prvky obsahu.Návod, který demonstruje použití všech dostupných ovládacích prvků obsahu, viz Návod: Vytvoření šablony s použitím ovládacích prvků obsahu.
Galerie stavebních bloků
Galerie stavebních bloků umožňuje uživatelům vybrat ze seznamu stavební bloky dokumentu vložit do dokumentu.Stavební blok dokumentu je část obsahu, který byl vytvořen použít vícekrát jako společné titulní stránky, formátované tabulky nebo záhlaví.Další informace naleznete BuildingBlockGalleryContentControl typu.Další informace o stavební bloky, viz Co je nového pro vývojáře v aplikaci Word 2007.
Zaškrtávací políčko
Zaškrtávací políčko poskytuje uživatelské rozhraní, které představuje binární stav: vybrána nebo vymazána.
Na rozdíl od jiných typů ovládacích prvků obsahu Visual Studio Tools for Office runtime neposkytuje konkrétní typ, který představuje ovládací prvek obsahu zaškrtávacího políčka.Jinými slovy, není žádná CheckBoxContentControl typu.Však můžete přesto vytvořit ovládací prvek obsahu políčko přidáním obecný ContentControl dokumentu programově.Další informace naleznete v Ovládací prvky obsahu políčko v projektech aplikace Word.
Pole se seznamem
Pole se seznamem zobrazí seznam položek, které mohou uživatelé vybrat.Na rozdíl od rozevíracího seznamu pole se seznamem umožňuje uživatelům přidávat vlastní položky.Další informace naleznete ComboBoxContentControl typu.
Výběr data
Výběr data poskytuje uživatelské rozhraní kalendáře pro výběr data.Kalendář se zobrazí, pokud koncový uživatel klepne na šipku rozevíracího seznamu v ovládacím prvku.Můžete použít místní kalendáře a různé formáty.Další informace naleznete DatePickerContentControl typu.
Rozevírací seznam
Rozevírací seznam zobrazí seznam položek, které mohou uživatelé vybrat.Na rozdíl od pole se seznamem rozevírací seznam neumožňuje uživatelům přidat nebo upravit položky.Další informace naleznete DropDownListContentControl typu.
Skupiny
Definuje prvek skupiny chráněné oblasti dokumentu, který nelze upravit nebo odstranit uživatele.Ovládací prvek skupiny může obsahovat všechny položky, dokumentu, například textu, tabulek, grafiky a jiných ovládacích prvků obsahu.Další informace naleznete GroupContentControl typu.
Obrázek
Ovládací prvek obrázek se zobrazí obrázek.Můžete určit obraz v době návrhu nebo za běhu nebo klepnutím vyberte obrázek do dokumentu vložit tento ovládací prvek.Další informace naleznete PictureContentControl typu.
RTF
Ovládací prvek RTF obsahuje text nebo jiné položky, například tabulek, obrázků nebo jiných ovládacích prvků obsahu.Další informace naleznete RichTextContentControl typu.
Prostý Text
Ovládací prvek prostý text obsahuje text.Ovládací prvek prostý text nemůže obsahovat jiné položky, například tabulek, obrázků nebo jiných ovládacích prvků obsahu.Veškerý text v ovládacím prvku ve formátu prostého textu, má stejné formátování.Například pokud jste kurzívu jednoho slova, věty, která je v ovládacím prvku ve formátu prostého textu, celý text uvnitř ovládacího prvku kurzívou.Další informace naleznete PlainTextContentControl typu.
Obecný ovládací prvek obsahu
Obecný ovládací prvek obsahu je ContentControl objekt, který může představovat dostupné typy ovládacích prvků obsahu.Můžete změnit ContentControl objekt pomocí chovat jako jiný typ ovládacího prvku obsahu Type vlastnost.Vytvoříte-li například ContentControl objekt řízení představuje prostý text, lze jej změnit za běhu, takže se chová podobně jako pole se seznamem.
Můžete vytvořit ContentControl objekty pouze za běhu, nikoli v době návrhu.Další informace naleznete v tématu Postupy: Přidání ovládacích prvků obsahu do dokumentů aplikace Word.
Běžné funkce ovládacích prvků obsahu
Většina obsahu prvky sdílet sadu členů, které lze použít k provedení běžných úkolů.Následující tabulka popisuje některé úkoly, které lze provést pomocí těchto členů.
Pro tento úkol: |
Postupujte takto: |
|---|---|
Získat nebo nastavit text zobrazený v ovládacím prvku. |
Použijte vlastnost Text.
|
Získání nebo nastavení dočasných text zobrazený v ovládacím prvku, dokud uživatel upravuje ovládací prvek, ovládací prvek je naplněn daty ze zdroje dat nebo odstraněn obsah ovládacího prvku. |
Použijte vlastnost PlaceholderText.
|
Získat nebo nastavit název, který je zobrazen v okraj obsahu ovládacího prvku, když uživatel klikne. |
Použijte vlastnost Title. |
Ovládací prvek z dokumentu odeberte automaticky po uživatel upravuje ovládacího prvku.(Text v ovládacím prvku zůstane v dokumentu). |
Použijte vlastnost Temporary. |
Spusťte kód, když uživatel klikne na ovládací prvek obsahu nebo kurzor je přesunut do obsahu ovládacího prvku programově. |
Zpracování Entering události ovládacího prvku. |
Po kliknutí mimo ovládací prvek obsahu nebo kurzor mimo ovládací prvek obsahu programově přesunout spusťte kód. |
Zpracování Exiting události ovládacího prvku. |
Po přidání ovládacího prvku obsahu dokumentu z znovu spustit kód nebo operaci vrátit zpět. |
Zpracování Added události ovládacího prvku. |
Ovládací prvek obsahu je odstranit z dokumentu před spusťte kód. |
Zpracování Deleting události ovládacího prvku. |
Ochrana částí dokumentů pomocí ovládacích prvků obsahu
Pokud uzamknete část dokumentu, můžete zabránit uživatelům v změna nebo odstranění obsahu v části dokumentu.Části dokumentu lze zabezpečit pomocí ovládacích prvků obsahu několika způsoby.
Pokud oblast, kterou chcete chránit je uvnitř ovládacího prvku obsahu, můžete použít vlastnosti ovládacího prvku obsahu uživatelům úpravy nebo odstranění ovládacího prvku:
LockContents Vlastnost zabraňuje uživatelům upravovat obsah.
LockContentControl Vlastnost zabraňuje uživatelům v odstranění ovládacího prvku.
Pokud chcete chránit oblasti není uvnitř ovládacího prvku obsahu nebo pokud chcete chránit oblast, která obsahuje ovládací prvky obsahu a jiných typů obsahu, můžete umístit celou oblast GroupContentControl.Na rozdíl od ostatních ovládacích prvků obsahu GroupContentControl poskytuje žádné uživatelské rozhraní, která je pro uživatele viditelné.Jeho účelem je pouze definovat oblast, který uživatelé nemohou upravovat.
[!POZNÁMKA]
Pokud vytvoříte GroupContentControl , která obsahuje vložené ovládací prvky obsahu, nejsou automaticky chráněny vložené ovládací prvky obsahu.Je nutné použít LockContents vlastnost každý vložený ovládací prvek zabránit uživatelům v úpravách jejich obsah.
Další informace o použití ovládacích prvků obsahu chránit části dokumentů, viz Postupy: Ochrana částí dokumentů pomocí ovládacích prvků obsahu.
Navázání dat na ovládací prvky obsahu
Vazbou obsahu ovládacího prvku zdroje dat můžete zobrazit data v dokumentech.Při aktualizaci zdroje dat na ovládací prvek obsahu odráží změny.Zpět do zdroje dat můžete také uložit změny.
Ovládací prvky obsahu poskytují následující možnosti vázání dat:
Můžete svázat ovládací prvky obsahu polí databáze nebo spravované objekty pomocí stejný model vázání dat jako model Windows Forms.
Můžete svázat ovládací prvky obsahu prvků v kusech XML (také s názvem vlastní části XML) vložené do dokumentu.
Přehled vázání hostitele ovládací prvky na data v řešeních Office, naleznete v Vázání dat k ovládacím prvkům v řešeních pro systém Office.
Pomocí model Windows Forms datové vazby modelu
Většina obsahu ovládací prvky podporují model jednoduché datové vazby, který používá model Windows Forms.Jednoduché datové vazby znamená, že je ovládací prvek vázán na jeden datový prvek, například hodnota ve sloupci tabulky dat.Další informace naleznete v tématu Datové vazby a rozhraní Windows Forms.
V projekty na úrovni dokumentu, můžete svázat datové ovládací prvky obsahu pomocí Zdroje dat okna Visual Studio.Další informace o přidání ovládacích prvků vázaných na data obsahu dokumentů, viz Postupy: Naplnění dokumentů daty z databáze a Postupy: Naplnění dokumentů daty z objektů.
V následující tabulce jsou uvedeny ovládací prvky obsahu, které svážete každý typ dat v Zdroje dat okna.
Typ dat |
Výchozí ovládací prvek obsahu |
Ostatní ovládací prvky obsahu, které mohou být vázány na tento datový typ |
|---|---|---|
|
Bytepole |
Žádná |
V projektu dokumentu úrovni a na úrovni aplikace, můžete svázat ovládací prvek obsahu zdroje dat programově pomocí Add metoda DataBindings vlastnost ovládacího prvku.Pokud můžete předat řetězec textu se propertyName parametr Add metoda.Text Je výchozí vlastnost vazby dat ovládacích prvků obsahu.
Ovládací prvky obsahu také podporují obousměrné datové vazby, aktualizaci změn v ovládacím prvku zdroje dat.Další informace naleznete v tématu Postupy: Aktualizace zdroje dat s použitím dat z hostitelského ovládacího prvku.
[!POZNÁMKA]
Ovládací prvky obsahu nepodporují komplexní datové vazby.Pokud svážete DropDownListContentControl nebo ComboBoxContentControl ke zdroji dat pomocí datového modelu model Windows Forms uživatelé uvidí pouze jednu hodnotu po klepnutí na ovládací prvek.Pokud chcete vázat na sadu datových hodnot, které uživatelé mohou vybírat z těchto ovládacích prvků, můžete tyto prvky svázat s prvky vlastní část XML.
Ovládací prvky obsahu vazby na vlastní části XML
Některé ovládací prvky obsahu lze vázat na prvky vlastní části XML, které jsou vloženy do dokumentu.Další informace o vlastní části XML naleznete v Přehled vlastních částí XML.
Vlastní část XML prvek svázat ovládací prvek obsahu, použijte XMLMapping vlastnost ovládacího prvku.Následující příklad kódu ukazuje, jak vytvořit vazbu PlainTextContentControl na Price elementu Product uzel vlastní části XML, který již byl přidán do dokumentu.
plainTextContentControl1.XMLMapping.SetMapping("/Product/Price")
plainTextContentControl1.XMLMapping.SetMapping("/Product/Price", String.Empty, null);
Návod, který ukazuje, jak svázat ovládací prvky obsahu vlastní části XML podrobněji, viz Návod: Svázání ovládacích prvků obsahu s vlastními částmi XML.
Pokud svážete ovládací prvek obsahu vlastní část XML, je automaticky povolena obousměrné datové vazby.Pokud uživatel upravuje text v ovládacím prvku, odpovídající prvky XML jsou automaticky aktualizovány.Podobně změně hodnoty vlastní části XML element ovládací prvky obsahu, které jsou vázány na prvky XML se zobrazí nová data.
Následující typy ovládacích prvků obsahu lze navázat na vlastní části XML:
Událostí datových vazeb pro ovládací prvky obsahu
Všechny ovládací prvky obsahu poskytují sadu událostí, které lze zpracovávat k provádění úloh týkajících se dat, například ověření, že text v ovládacím prvku splňuje určitá kritéria, před aktualizací zdroje dat.Následující tabulka uvádí související datové vazby události ovládacího prvku obsahu.
Úloha |
Událost |
|---|---|
Aplikace Word automaticky aktualizuje textu v obsahu prvku, který je vázán na vlastní část XML před spusťte kód. |
|
Ovládací prvek obsahu běhu kódu aplikace Word automaticky aktualizuje vlastní části XML s vazbou na data před (po změně textu v obsahu prvku). |
|
Spuštění vlastního kódu k ověření obsahu ovládacího prvku podle vlastních kritérií. |
|
Po úspěšném ověření obsahu ovládacího prvku, spusťte kód. |
Omezení ovládacích prvků obsahu
Při použití ovládacích prvků obsahu v projektech systému Office, uvědomte následující omezení.
Rozdíly mezi návrhu a čas spuštění
Mnoho omezení, které aplikace Microsoft Office Word ukládá za běhu ovládací prvky obsahu nejsou vynucena v době návrhu.Při návrhu uživatelského rozhraní řešení úrovni dokumentu v Visual Studio, nezapomeňte změnit ovládací prvky obsahu pouze způsoby, které jsou podporovány v době běhu.
Při úpravě obsahu ovládacího prvku v době návrhu tak, aby ovládací prvek nepodporuje v době běhu Visual Studio designer nebude upozornění nepodporované změn.Však při ladění nebo spustit projekt nebo pokud uložíte a znovu otevřete projekt aplikace Word zobrazit chybové zprávy a žádosti oprávněním dokument.Při opravě dokumentu aplikace Word odstraní všechny nepodporované obsahu a formátování z ovládacího prvku.
Například slovo nezabrání při přidání tabulky do PlainTextContentControl v době návrhu.Nicméně protože PlainTextContentControl objekty nemohou obsahovat tabulky za běhu, aplikace Word se zobrazí chybová zpráva při otevření dokumentu.
Všimněte si také, že mnoho vlastností, které určují chování ovládacích prvků obsahu mít žádný účinek v době návrhu.Například pokud nastavíte LockContents vlastnost ovládacího prvku obsahu pro True v době návrhu můžete upravit text v ovládacím prvku Visual Studio Návrhář.Tato vlastnost zabrání uživatelům pouze úprav ovládacího prvku za běhu.
Omezení událostí
Ovládací prvky obsahu neposkytují události, která je vyvolána, když uživatel změní text nebo jiné položky v ovládacím prvku.Například je žádná událost, která je vyvolána, když uživatel vybere jinou položku v DropDownListContentControl nebo ComboBoxContentControl.
Určit, kdy uživatel upravuje obsah ovládacího prvku obsahu, můžete svázat ovládací prvek vlastní část XML a poté zpracovávat StoreUpdating události.Tato událost je aktivována, když uživatel změní obsah ovládacího prvku, který je vázán k vlastní části XML.Návod, který ukazuje, jak svázat ovládací prvek obsahu vlastní část XML, viz Návod: Svázání ovládacích prvků obsahu s vlastními částmi XML.
Ovládací prvky obsahu políčko v projektech aplikace Word
Word 2010 zaveden nový typ obsahu ovládacího prvku, který představuje zaškrtávací políčko.Nicméně Visual Studio Tools for Office runtime neposkytuje odpovídající CheckBoxContentControl typu, můžete použít v projektech systému Office.Vytvořit zaškrtávací políčko ovládací prvek obsahu v Word 2013 nebo Word 2010 projektu, použijte AddContentControl metoda vytvořit ContentControl objekt a předat wdContentControlCheckBox hodnotu metody pro určení obsahu ovládacího prvku zaškrtávací políčko.Následující příklad kódu ukazuje jak toto provést.
Me.Paragraphs(1).Range.InsertParagraphBefore()
Me.Paragraphs(1).Range.Select()
Dim checkBoxControl1 As Microsoft.Office.Tools.Word.ContentControl =
Me.Controls.AddContentControl("checkBoxControl1", Word.WdContentControlType.wdContentControlCheckBox)
checkBoxControl1.Checked = True
this.Paragraphs[1].Range.InsertParagraphBefore();
this.Paragraphs[1].Range.Select();
Microsoft.Office.Tools.Word.ContentControl checkBoxControl1 =
this.Controls.AddContentControl("checkBoxControl1", Word.WdContentControlType.wdContentControlCheckBox);
checkBoxControl1.Checked = true;
Viz také
Úkoly
Postupy: Přidání ovládacích prvků obsahu do dokumentů aplikace Word
Návod: Vytvoření šablony s použitím ovládacích prvků obsahu
Koncepty
Automatizace v aplikaci Word s použitím rozšířených objektů
Programová omezení hostitelských položek a hostitelských ovládacích prvků