ProvideLanguageEditorOptionPageAttribute Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Zadejte obecnou metodu nastavení nástroje editoru jazyka na stránce možností.
public ref class ProvideLanguageEditorOptionPageAttribute sealed : Microsoft::VisualStudio::Shell::ProvideOptionDialogPageAttribute
public ref class ProvideLanguageEditorOptionPageAttribute sealed : Microsoft::VisualStudio::Shell::ProvideOptionDialogPageAttribute
[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)]
public sealed class ProvideLanguageEditorOptionPageAttribute : Microsoft.VisualStudio.Shell.ProvideOptionDialogPageAttribute
[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)>]
type ProvideLanguageEditorOptionPageAttribute = class
inherit ProvideOptionDialogPageAttribute
Public NotInheritable Class ProvideLanguageEditorOptionPageAttribute
Inherits ProvideOptionDialogPageAttribute
- Dědičnost
-
ProvideLanguageEditorOptionPageAttribute
- Atributy
Příklady
Tento příklad ukazuje, jak se tento uživatelem definovaný atribut používá k registraci dvou stránek vlastností ("Obecné" a "Odsazení") a uzlu stránky vlastností ("Formátování"), který obsahuje stránku vlastnosti Odsazení. Všimněte si, jak druhý parametr konstruktoru určuje pozici v registru vzhledem k uzlu.
Poznámka
Visual C# umožňuje zkrácenou formu uživatelem definovaného atributu vyřazením části "Attribute" názvu. Tato zkrácená forma se používá v tomto a všech ostatních příkladech v této třídě.
using Microsoft.VisualStudio.Shell;
namespace MyLanguagePackage
{
internal class MyConstants
{
public const string languageName = "MyLanguage";
public const string formattingNodeResIDAsString = "#108";
public const string generalPageResIDAsString = "#109";
public const string indentPageResIDAsString = "#110";
}
[ProvideLanguageEditorOptionPage(MyConstants.languageName,
"General", // property page
MyConstants.generalPageResIDAsString,
// Optional language service properties
OptionPageGuid = "{12434534-cecd-48e7-a866-45cad2e8b169}"
)]
[ProvideLanguageEditorOptionPage(MyConstants.languageName,
"Formatting", // property node
MyConstants.formattingNodeResIDAsString
)]
[ProvideLanguageEditorOptionPage(MyConstants.languageName,
@"Formatting\Indent", // property page
MyConstants.indentPageResIDAsString,
// Optional language service properties
OptionPageGuid = "{12434556-cecd-48e7-a866-45cad2e8b169}"
)]
class MyLanguagePackage
{
}
}
Poznámky
Tyto informace jsou uložené v klíči <registru RegistrationRoot>\Languages\Language Services\[language]\EditorToolsOptions, kde [language] je název jazyka.
V části EditorToolsOptions je strom stránek a dílčích stránek, které mohou vnořit libovolný počet úrovní. Tyto stránky odpovídají stránkám možností zobrazeným v Visual Studio Tools Možnosti pro editory (kde se pod názvem jazyka zobrazuje strom stránek možností, přičemž každá stránka obsahuje příslušné možnosti).
Každý klíč v seznamu stránek této možnosti obsahuje ID prostředku nebo řetězec literálu obsahující lokalizovaný název stránky. To je to, co se ve skutečnosti zobrazuje v dialogovém okně Možnosti nástrojů. Kromě toho obsahuje také identifikátor GUID balíčku a volitelně identifikátor GUID stránky možnosti.
Pokud neexistuje identifikátor GUID stránky možnosti, pak se klíč považuje za uzel ve stromu možností a nemá přidruženou stránku. Jinak je klíč listem ve stromu a zobrazí se stránka s možnostmi.
Může existovat více instancí tohoto atributu a každá instance určuje uzel nebo stránku vlastností. Atributy se můžou zobrazit v libovolném pořadí. Pokud je zadán identifikátor GUID stránky vlastností, zaregistruje se stránka vlastností, jinak se jedná o registrovaný uzel.
Následující uživatelem definované atributy se používají pro jazykové služby:
Atribut | Popis |
---|---|
ProvideLanguageServiceAttribute | Zaregistruje službu jazyka v sadě Visual Studio a určí podporované funkce. |
ProvideLanguageExtensionAttribute | Přidruží příponu souboru ke službě jazyka. |
ProvideLanguageEditorOptionPageAttribute | Určuje uzel vlastnosti nebo stránku pro dialogové okno Možnosti specifické pro službu jazyka. |
ProvideLanguageCodeExpansionAttribute | Určuje informace o umístění pro podporu fragmentů kódu ve službě jazyka. |
ProvideServiceAttribute | Zaregistruje službu jazyka jako službu sady Visual Studio. Tento atribut používají všechny služby poskytované ve spravovaném kódu. |
Poznámky pro dědice
Tuto třídu atributu nelze zdědit, takže není co implementovat.
Poznámky pro volající
Tato třída atributu se obvykle používá pro primární třídu VSPackage, i když se může zobrazit v jakékoli třídě. Tato třída atributu se může zobrazit vícekrát a v libovolném pořadí, jednou pro každou stránku vlastností a uzel ve stromu stránky vlastností.
Konstruktory
ProvideLanguageEditorOptionPageAttribute(Type, String, String, String, String, Int32) |
Vytvoří novou instanci ProvideLanguageEditorOptionPageAttribute. |
ProvideLanguageEditorOptionPageAttribute(Type, String, String, String, String, String) |
Vytvoří novou instanci ProvideLanguageEditorOptionPageAttribute. |
ProvideLanguageEditorOptionPageAttribute(Type, String, String, String, String, String[]) |
Vytvoří novou instanci ProvideLanguageEditorOptionPageAttribute. |
Vlastnosti
IsInUnifiedSettings |
Získá nebo nastaví hodnotu označující, zda nastavení na této stránce byly onboardovány do sjednoceného nastavení prostřednictvím vytvoření nové registrace. Pokud je hodnota true, stránka se při povolení sjednoceného nastavení skryje, takže její nastavení se nezduplikují. |
Keywords |
Získá klíčová slova. |
LanguageName |
Získá název jazyka. |
PageGuid |
Získá identifikátor GUID stránky možnosti. |
PageNameResourceId |
Získá název ID prostředku stránky. (Zděděno od ProvideOptionDialogPageAttribute) |
PageType |
Získá typ stránky. (Zděděno od ProvideOptionDialogPageAttribute) |
TypeId |
Přepište vlastnost TypeID, aby odvozené třídy RegistrationAttribute fungovaly se System.ComponentModel.TypeDescriptor.GetAttributes(...). Atribut odvozený z tohoto atributu bude muset přepsat tuto vlastnost pouze v případě, že potřebuje lepší kontrolu nad instancemi, které lze použít na třídu. (Zděděno od RegistrationAttribute) |
Metody
GetPackageRegKeyPath(Guid) |
Získá cestu registru (vzhledem ke kořenovému adresáři registru aplikace) VSPackage. (Zděděno od RegistrationAttribute) |
Register(RegistrationAttribute+RegistrationContext) |
Vytvoří všechny klíče registru a položky určené konstruktorem třídy. |
Unregister(RegistrationAttribute+RegistrationContext) |
Odebere všechny klíče a položky registru. |