Položky registru pro doplňky na úrovni aplikací
Je nutné vytvořit konkrétní sady položek registru, když nasadíte doplňků, které jsou vytvořeny pomocí Visual Studio 2013.Tyto položky registru obsahují informace, které umožňuje zjišťovat a načíst doplněk aplikace Microsoft Office.
Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni aplikace v Microsoft Office 2013 a Microsoft Office 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.
Při vytváření projektu sady Visual Studio vytvoří tyto položky registru na vývojovém počítači, takže můžete snadno spustit a ladit doplněk upthe.Pokud používáte ClickOnce pro nasazení tohoto doplňku, položky registru jsou automaticky vytvářeny v počítači koncového uživatele.Pokud použijete k nasazení tohoto doplňku Instalační služby systému Windows, je nutné nakonfigurovat projekt InstallShield Limited Edition vytvoření položky registru v počítači koncového uživatele.
Další informace o tom, jak se používají položky registru během procesu načtení pro doplňky, naleznete v části Architektura doplňků na úrovni aplikace.
[!POZNÁMKA]
V tomto tématu, text ID doplněk představuje jedinečné ID pro doplněk.Ve výchozím nastavení je ID název doplňku sestavení.
Registrace doplňky pro vs aktuálního uživatele.Všichni uživatelé
Pokud doplněk je nainstalován, lze registrovat dvěma způsoby:
Pro aktuálního uživatele (to znamená, že je k dispozici pouze pro uživatele, který se přihlásí počítače při instalaci doplňku).V takovém případě položky registru jsou vytvářeny HKEY_CURRENT_USER.
Pro všechny uživatele (to znamená, že všechny uživatele, aby se přihlásí na počítači pomocí doplňku).V takovém případě položky registru jsou vytvářeny pod klíčem HKEY_LOCAL_MACHINE.
Všechny moduly, které vytvoříte pomocí Visual Studio 2013 lze registrovat pro aktuálního uživatele.Doplňky však může být registrováno pro všechny uživatele pouze v určitých scénářů.Tyto scénáře, závisí na verzi sady Microsoft Office v počítači a jak nasazena doplňku.
Verze aplikace Microsoft Office
Aplikace Microsoft Office 2010 a Microsoft Office 2013 aplikace můžete načíst doplňků, které jsou registrovány pod HKEY_LOCAL_MACHINE nebo HKEY_CURRENT_USER.
Načíst doplňků, které jsou registrovány pod klíčem HKEY_LOCAL_MACHINE, musí mít počítače balíčku aktualizací 976477 nainstalován.Další informace naleznete v tématu https://go.microsoft.com/fwlink/?LinkId=184923.
Typ nasazení
Pokud používáte ClickOnce k instalaci doplňku, doplňku lze registrovat pouze pro aktuálního uživatele.To je způsobeno ClickOnce podporuje pouze vytváření klíče HKEY_CURRENT_USER.Pokud chcete k registraci doplněk pro všechny uživatele v počítači, musíte použít instalační služby systému Windows k nasazení doplňku.Další informace o těchto typů nasazení, naleznete v části Nasazení řešení Office s použitím technologie ClickOnce a Nasazení řešení Office s použitím Instalační služby systému Windows.
Položky registru
Požadované doplněk položky registru jsou umístěny v následující klíč registru pro všechny aplikace s výjimkou aplikace Visio, kde kořenový je HKEY_CURRENT_USER nebo HKEY_LOCAL_MACHINE.
Všechny aplikace s výjimkou aplikace Visio
Verze systému Office |
Konfigurační cesta |
---|---|
32bitová |
Kořenový\Software\Microsoft\Office\název aplikace\Addins\ID doplněk |
64bitová |
Kořenový\Software\Wow6432Node\Microsoft\Office\název aplikace\Addins\ID doplněk |
Visio
Verze systému Office |
Konfigurační cesta |
---|---|
32bitová |
Kořenový\Software\Microsoft\Visio\Addins\ID doplněk |
64bitová |
Kořenový\Software\Wow6432Node\Visio\Addins\ID doplněk |
V následující tabulce jsou uvedeny položky v tomto klíči registru.
Položka |
Typ |
Hodnota |
---|---|---|
Description |
REG_SZ |
Požadováno.Stručný popis doplňku. Tento popis se zobrazí, když uživatel vybere doplněk v Add-Ins podokna Možnosti dialogové okno v aplikaci Microsoft Office. |
FriendlyName |
REG_SZ |
Požadováno.Popisný název tohoto doplňku, který se zobrazí v Doplňky modelu COM dialogové okno v aplikaci Microsoft Office.Výchozí hodnota je identifikátor. |
LoadBehavior |
REG_DWORD |
Požadováno.Hodnota, která určuje, kdy se aplikace pokusí načíst doplněk a aktuální stav doplňku (načíst nebo odpojeno). Tato položka je ve výchozím nastavení, nastavena na hodnotu 3, který určuje, že doplněk je načtena při spuštění.Další informace naleznete v tématu LoadBehavior hodnoty.
|
Manifest |
REG_SZ |
Požadováno.Úplná cesta manifestu nasazení pro doplněk.Cesta může být umístění v místním počítači, síťové sdílené složce (UNC) nebo na webový server (HTTP). Pokud používáte Instalační služby systému Windows můžete nasadit řešení, je nutné přidat předponu file:/// k manifestu cestu.Rovněž musíte přidat řetězec |vstolocal (to znamená, znakem|Následuje vstolocal) za účelem této cesty.To zajistí, že vaše řešení je načten z instalační složky, nikoli mezipaměti ClickOnce.Další informace naleznete v tématu Nasazení řešení Office s použitím Instalační služby systému Windows.
|
Položky registru pro oblasti formulářů aplikace Outlook
Pokud vytvoříte vlastního formuláře oblast v doplňku pro aplikaci Outlook, další registru položky se používají k registraci oblast formuláře s aplikací Outlook.Tyto položky jsou vytvářeny pod klíčem registru pro každou třídu zpráv, který podporuje oblast formuláře.Tyto klíče registru jsou v následujícím umístění, kde kořenový je HKEY_CURRENT_USER nebo HKEY_LOCAL_MACHINE.
Kořenový\Software\Microsoft\Office\Outlook\FormRegions\Třída zprávy
Podobně jako ostatní položky registru sdíleny všechny doplňky, Visual Studio vytvoří formulář položky registru oblast na vývojovém počítači při vytváření vašeho projektu.Pokud používáte ClickOnce pro nasazení tohoto doplňku, položky registru jsou automaticky vytvářeny v počítači koncového uživatele.Pokud použijete k nasazení tohoto doplňku Instalační služby systému Windows, je nutné nakonfigurovat projekt InstallShield Limited Edition vytvoření položky registru v počítači koncového uživatele.
Další informace o položky registru oblast formuláře, naleznete v části Určení oblasti formulářů v registru systému Windows.Další informace o oblasti formulářů aplikace Outlook, naleznete v části Vytváření oblastí formulářů aplikace Outlook.
LoadBehavior hodnoty
LoadBehavior Položku kořenový\Software\Microsoft\Office\název aplikace\Addins\ID doplněk klíč obsahuje bitová kombinace hodnot, které určují chování běhu doplňku.Nejnižší bit pořadí (hodnoty 0 a 1) označuje, zda doplňku je aktuálně odpojeno nebo načíst.Ostatní bity signalizují, že se aplikace pokusí načíst doplněk.
Obvykle LoadBehavior položka má být nastavena na hodnotu 0, 3 nebo 16 (v desetinné číslo) při doplňku instalaci do počítačů koncových uživatelů.Ve výchozím nastavení sady Visual Studio LoadBehavior vstupu tohoto doplňku 3 při vytváření nebo při publikování.
V následující tabulce jsou uvedeny všechny možných hodnot LoadBehavior položka.Některé popisy v této tabulce naleznete načítání doplňku ručně nebo programově.Chcete-li načíst doplněk ručně, zaškrtněte políčko vedle doplňku v Doplňky modelu COM dialogové okno v aplikaci.Chcete-li načíst doplněk programově, nastavte Connect vlastnost COMAddIn objekt, který představuje doplněk pro true.
Hodnota (v desetinné číslo) |
Doplněk stav |
Načtení doplňku chování |
Popis |
---|---|---|---|
0 |
uvolněné |
Nebudou načteny automaticky |
Nikdy se aplikace snaží načíst doplněk automaticky.Může uživatel provést ručně načíst doplněk nebo doplňku mohou být načteny programově. Pokud je doplněk úspěšně načten, LoadBehavior hodnota zůstane 0, ale stav doplněk v Doplňky modelu COM dialogového okna se aktualizuje označuje, že doplňku bude načten. |
1 |
načteno |
Nebudou načteny automaticky |
Nikdy se aplikace snaží načíst doplněk automaticky.Může uživatel provést ručně načíst doplněk nebo doplňku mohou být načteny programově. I když Doplňky modelu COM dialogové okno označuje, že doplněk je načten po spuštění aplikace, doplňku není ve skutečnosti načíst dokud nebude vložen ručně nebo programově. Pokud aplikace úspěšně doplňku, načte LoadBehavior hodnota se změní na 0 a zůstává na 0 po ukončení aplikace. |
2 |
uvolněné |
Načíst při spuštění |
Aplikace se nepokouší načíst doplněk automaticky.Může uživatel provést ručně načíst doplněk nebo doplňku mohou být načteny programově. Pokud aplikace úspěšně doplňku, načte LoadBehavior hodnota se změní na 3 a zůstává na 3 po ukončení aplikace. |
3 |
načteno |
Načíst při spuštění |
Aplikace se snaží načíst doplněk při spuštění aplikace.Toto je výchozí hodnota při vytváření nebo publikování doplněk v sadě Visual Studio. Pokud aplikace úspěšně doplňku, načte LoadBehavior hodnota zůstane 3.Pokud dojde k chybě při načítání doplňku, LoadBehavior hodnota se změní na 2 a zůstává na 2 po ukončení aplikace. |
8 |
uvolněné |
Načíst na požádání |
Aplikace se nepokouší načíst doplněk automaticky.Může uživatel provést ručně načíst doplněk nebo doplňku mohou být načteny programově. Pokud aplikace úspěšně doplňku, načte LoadBehavior hodnota se změní na 9. |
9 |
načteno |
Načíst na požádání |
Doplněk bude načten pouze v případě, že aplikace vyžaduje, jako je například když uživatel klikne na prvek uživatelského rozhraní, který používá funkce add-in (například vlastní tlačítko na pásu karet). Pokud aplikace úspěšně načte doplněk, LoadBehavior hodnota zůstane 9, ale stav doplněk v Doplňky modelu COM dialogového okna se aktualizuje označuje, že doplněk je aktuálně zaveden.Pokud dojde k chybě při načítání doplňku, LoadBehavior hodnota se změní na 8. |
16 |
načteno |
První doba načítání a poté načíst na požádání |
Tuto hodnotu nastavte, pokud chcete, aby doplněk mají být načtena na vyžádání.Když uživatel spustí aplikaci pro první načtení doplňku aplikace.Při příštím spuštění aplikace, aplikace načte všechny prvky uživatelského rozhraní, které jsou definovány doplňku, ale doplněk není načtou, dokud se uživatel klikne na prvek uživatelského rozhraní, který je přidružen k doplňku. Když se aplikace se úspěšně načte doplněk poprvé, LoadBehavior hodnota zůstane 16 načítání doplňku.Po ukončení aplikace, LoadBehavior hodnota se změní na 9. |
Viz také
Koncepty
Architektura doplňků na úrovni aplikace
Další zdroje
Architektura řešení pro systém Office v sadě Visual Studio