ProvideLanguageEditorOptionPageAttribute Třída

Reference

Definice

Obor názvů:: Microsoft.VisualStudio.Shell

Sestavení:: Microsoft.VisualStudio.Shell.14.0.dll

Sestavení:: Microsoft.VisualStudio.Shell.15.0.dll

Balíček:: Microsoft.VisualStudio.Shell.15.0 v17.9.37000

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: Attribute

RegistrationAttribute

ProvideOptionDialogPageAttribute
ProvideLanguageEditorOptionPageAttribute

Atributy: AttributeUsageAttribute

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.

Platí pro