Seçenekler ve Seçenekler Sayfaları

Araçlar menüsünde Seçenekler'i seçtiğinizde Seçenekler bölmesi açılır. Bu bölmeden erişilebilen ayar kategorileri, topluca seçenek sayfaları olarak adlandırılır.

Bölmenin sol bölümünde üst düzey kategoriler (veya bölümler) ve bunların alt bölümleri için gezinti sağlanır. Her bölüm ve alt bölüm bir seçenekler sayfasıdır. Bölmenin sağ bölümünde belirli seçenekler veya ayarlar görüntülenir. Seçenekler sayfalarında, VSPackage'ın durumunu belirleyen seçenekler ve ayarların değerlerini değiştirebilirsiniz.

Seçenekler Sayfaları desteği

sınıfı, Package seçenek sayfaları ve seçenek kategorileri oluşturmak için destek sağlar. DialogPage sınıfı bir seçenekler sayfası uygular.

varsayılan uygulaması DialogPage , genel bir özellik kılavuzundaki kullanıcıya ortak özelliklerini sunar. Kendi kullanıcı arabirimine (UI) sahip bir özel seçenekler sayfası oluşturmak için sayfadaki çeşitli yöntemleri geçersiz kılarak bu davranışı özelleştirebilirsiniz. Daha fazla bilgi için bkz. Seçenekler Sayfası Oluşturma.

sınıfı, DialogPage seçenek sayfaları ve ayrıca kullanıcı ayarları için kalıcılık sağlayan öğesini uygular IProfileManager. özelliği bir dizeye LoadSettingsFromStorage ve dizeden dönüştürülebiliyorsa ve SaveSettingsToStorage yöntemlerinin varsayılan uygulamaları özelliği kayıt defterinin kullanıcı bölümüne dönüşür.

Seçenekler Sayfası Kayıt Defteri Yolu

Varsayılan olarak, seçenekler sayfası tarafından yönetilen özelliklerin kayıt defteri yolu, DialogPage sözcüğü ve seçenekler sayfası sınıfının tür adı birleştirilerek UserRegistryRootbelirlenir. Örneğin, seçenekler sayfası sınıfı aşağıdaki gibi tanımlanabilir.

C#

namespace Company.OptionsPage
{
    public class OptionsPageGeneral : DialogPage
    {
    }
}

VB

Namespace Company.OptionsPage
    Public Class OptionsPageGeneral
        Inherits DialogPage
    End Class
End Namespace

UserRegistryRootHKEY_CURRENT_USER\Software\Microsoft\VisualStudio\8.0Expise, özellik adı ve değer çiftleri HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\8.0Exp\DialogPage\Company.OptionsPage.OptionsPageGeneralalt anahtarlarıdır.

Seçenekler sayfasının kayıt defteri yolu, sözcüğü, ToolsOptionsPages ve seçenekler sayfası kategorisi ve adı birleştirilerek ApplicationRegistryRootbelirlenir. Örneğin, Özel seçenekler sayfasında Seçenek Sayfalarım kategorisi varsa ve ApplicationRegistryRoot HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\8.0Expise seçenekler sayfasında kayıt defteri anahtarı HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\8.0Exp\ToolsOptionsPages\My Option Pages\Custom.

Araçlar/Seçenekler Sayfa Öznitelikleri ve Düzeni

özniteliği, ProvideOptionPageAttribute Özel seçenekler sayfalarının Seçenekler gezinti ağacında kategoriler halinde gruplandırılması işlemini belirler. özniteliği, ProvideOptionPageAttribute bir seçenekler sayfasını arabirimi sağlayan VSPackage ile ilişkilendirir. Aşağıdaki kod parçasını göz önünde bulundurun:

C#

[ProvideOptionPage(typeof(OptionsPageGeneral),"My Option Pages", "General", 101, 106, true)]
[ProvideOptionPage(typeof(OptionsPageCustom), "My Option Pages", "Custom", 101, 107, true)]
[Guid("B0002DC2-56EE-4931-93F7-70D6E9863940")]
public class MyPackage : Package

VB

<ProvideOptionPage(GetType(OptionsPageGeneral), "My Option Pages", "General", 101, 106, True),
 ProvideOptionPage(GetType(OptionsPageCustom), "My Option Pages", "Custom", 101, 107, True),
 Guid("B0002DC2-56EE-4931-93F7-70D6E9863940")>
Public Class MyPackage
    Inherits Package

Bu, MyPackage'ın OptionsPageGeneral ve OptionsPageCustom olarak iki seçenek sayfası sağladığını bildirir. Seçenekler'in altında, her iki seçenek sayfası da Seçenek Sayfalarım kategorisinde sırasıyla Genel ve Özel olarak görünür.

Seçenek Öznitelikleri ve Düzeni

Sayfanın sağladığı kullanıcı arabirimi (UI), özel seçenekler sayfasındaki seçeneklerin görünümünü belirler. Genel seçenekler sayfasındaki seçeneklerin düzeni, etiketlemesi ve açıklaması aşağıdaki öznitelikler tarafından belirlenir:

• CategoryAttribute seçeneğin kategorisini belirler.

• DisplayNameAttribute seçeneğin görünen adını belirler.

• DescriptionAttribute seçeneğin açıklamasını belirler.

  Uyarı

  Eşdeğer öznitelikler, SRCategory, LocDisplayName ve SRDescription, yerelleştirme için dize kaynaklarını kullanır ve yönetilen proje örneğinde tanımlanır.

  Aşağıdaki kod parçasını göz önünde bulundurun:

  C#

  [Category("My Options")]
  [DisplayName("Integer Option")]
  [Description("My integer option")]
  public int OptionInteger { get; set; }
  

  VB

  Private _optionInt As Integer
  
  <Category("My Options"),
  DisplayName("Integer Option"),
  Description("My integer option")>
  Public Property OptionInteger() As Integer
      Get
          Return _optionInt
      End Get
      Set(ByVal value As Integer)
          _optionInt = value
      End Set
  End Property
  

---

OptionInteger seçeneği seçenekler sayfasında Seçeneklerim kategorisinde Tamsayı Seçeneği olarak görüntülenir. Seçenek belirlenirse, açıklama kutusunda Tamsayım seçeneği adlı açıklama bulunur.

Başka bir VSPackage'dan Seçenekler Sayfalarına Erişme

Bir seçenek sayfasını barındıran ve yöneten bir VSPackage'a otomasyon modeli kullanılarak başka bir VSPackage'dan program aracılığıyla erişilebilir. Örneğin, aşağıdaki kodda bir VSPackage bir seçenek sayfasını barındırarak kaydedilir.

C#

[ProvideOptionPage(typeof(MyOptionPage), "My Category", "My Grid Page", 0, 0, true)]
[Guid("6bb6942e-014c-489e-a612-a935680f703d")]
public sealed class MyToolsOptions : Package

VB

<ProvideOptionPage(GetType(MyOptionPage), "My Category", "My Grid Page", 0, 0, True)>
<Guid("6bb6942e-014c-489e-a612-a935680f703d")>
Public NotInheritable Class MyToolsOptions
    Inherits Package

Aşağıdaki kod parçası, MyOptionPage'den OptionInteger değerini alır:

C#

DTE dte = (DTE)GetService(typeof(DTE));
EnvDTE.Properties props = dte.get_Properties("My Category", "My Grid Page");
int n = (int)props.Item("OptionInteger").Value;

VB

Dim dte As DTE = CType(GetService(GetType(DTE)), DTE)
Dim props As EnvDTE.Properties = dte.get_Properties("My Category", "My Grid Page")
Dim n As Integer = CInt(Fix(props.Item("OptionInteger").Value))

ProvideOptionPageAttribute Öznitelik bir seçenekler sayfasını kaydettiğinde, özniteliğin truebağımsız değişkeni ise SupportsAutomation sayfa AutomationProperties anahtarı altında kaydedilir. Otomasyon, ilişkili VSPackage'ı bulmak için bu kayıt defteri girdisini inceler ve ardından otomasyon, barındırılan seçenekler sayfasından (bu örnekte "Kılavuz Sayfam" olan) özelliğine erişir.

Otomasyon özelliğinin kayıt defteri yolu , sözcüğü, AutomationProperties ve seçenekler sayfası kategorisi ve adı birleştirilerek ApplicationRegistryRootbelirlenir. Örneğin, seçenekler sayfasında "Kategorim" kategorisi, "Kılavuz Sayfam" adı ve ApplicationRegistryRoot, HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\8.0Expvarsa otomasyon özelliği HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\8.0Exp\AutomationProperties\My Category\My Grid Pagekayıt defteri anahtarına sahiptir.

Uyarı

"Category.My Kılavuz Sayfam" kurallı adı, bu anahtarın Name alt anahtarının değeridir.