Insiemi Properties di DTE

Articolo
09/12/2008

Aggiornamento: novembre 2007

Le proprietà a livello di ambiente sono organizzate in categorie corrispondenti alla gerarchia visualizzata nella finestra di dialogo Opzioni. Per visualizzare la finestra di dialogo Opzioni, scegliere Opzioni dal menu Strumenti. Per ragioni di semplicità, questo argomento fa riferimento a questa finestra di dialogo come finestra di dialogo Opzioni del menu Strumenti. Ad esempio, DTE.Properties("TextEditor", "Basic") rappresenta le impostazioni presenti nel nodo Basic all'interno del nodo Editor di testo nella finestra di dialogo Opzioni del menu Strumenti. In molti casi, le impostazioni presenti nelle finestre di dialogo sono anche rappresentate da proprietà. Ad esempio, nella finestra di dialogo Opzioni, nodi Tabulazioni, Basic ed Editor di testo, è presente l'impostazione Dimensione tabulazione. Questa impostazione è rappresentata dalle proprietà TabSize e TabSize. Ogni elemento di proprietà dispone di uno o più valori rappresentati dalla proprietà Value. Per informazioni su come modificare i valori delle opzioni tramite le proprietà, vedere Controllo delle impostazioni relative alle opzioni.

Negli argomenti della sezione Vedere anche riportata di seguito vengono elencate le categorie predefinite fornite con Visual Studio. Tuttavia, i package di Visual Studio consentono di aggiungere proprie categorie (pagine delle opzioni degli strumenti) e di creare pagine delle opzioni degli strumenti personalizzate.

Nota:
Alcune pagine delle proprietà presenti nella finestra di dialogo Opzioni non supportano l'automazione. Le pagine delle proprietà che supportano l'automazione sono elencate in Determinazione dei nomi degli elementi delle proprietà nelle pagine delle opzioni.

È possibile accedere allo stesso oggetto dell'insieme Properties da posizioni diverse. È possibile accedere a un insieme Properties, ad esempio, per i tipi di carattere e i colori tramite DTE.Properties("Environment", "FontsAndColors") o DTE.Properties("TextEditor", "FontsAndColors").

Esempio

Nell'esempio riportato di seguito viene illustrato come visualizzare tutti gli elementi di proprietà accessibili nella finestra di dialogo Opzioni, nodi Generale, C#, Editor di testo. Si noti che nel codice il nodo "C#" deve essere rappresentato come "CSharp". Per ulteriori informazioni su come eseguire l'esempio del componente aggiuntivo, vedere Procedura: compilare ed eseguire gli esempi di codice del modello a oggetti di automazione.

' Add-in code.
Public Sub OnConnection(ByVal application As Object, ByVal connectMode _
As Extensibility.ext_ConnectMode, ByVal addInInst As Object, ByRef _
custom As System.Array) Implements Extensibility.IDTExtensibility2.OnConnection

    applicationObject = CType(application, EnvDTE.DTE)
    addInInstance = CType(addInInst, EnvDTE.AddIn)
    ' Pass the applicationObject member variable to the code example.
    PropertiesExample (applicationObject)
    End Sub

Sub PropertiesExample(ByVal dte As DTE)
    ' Create and initialize a variable to represent the C# 
    ' text editor options page.
    Dim txtEdCS As EnvDTE.Properties = _
    DTE.Properties("TextEditor", "CSharp")
    Dim prop As EnvDTE.Property
    Dim msg As String

    ' Loop through each item in the C# text editor options page. 
    For Each prop In txtEdCS
        msg += ("PROP NAME: " & prop.Name & "   VALUE: " & _
        prop.Value) & vbCr
    Next
    MsgBox(msg)
End Sub

// Add-in code.
Using System.Windows.Forms;
public void OnConnection(object application,
 Extensibility.ext_ConnectMode connectMode, object addInInst,
 ref System.Array custom)
{
    applicationObject = (_DTE)application;
    addInInstance = (AddIn)addInInst;
    // Pass the applicationObject member variable to the code example.
    PropertiesExample((DTE)applicationObject); 
}

public void PropertiesExample( DTE dte ) 
{ 
    // Create and initialize a variable to represent the C# 
    // text editor options page.
    EnvDTE.Properties txtEdCS =
 dte.get_Properties( "TextEditor", "CSharp" ); 
    EnvDTE.Property prop = null; 
    string msg = null; 

    // Loop through each item in the C# text editor options page. 
    foreach ( EnvDTE.Property temp in txtEdCS ) 
    { 
        prop = temp; 
        msg += ( "PROP NAME: " + prop.Name + "   VALUE: " 
+ prop.Value ) + "\n"; 
    }
    MessageBox.Show( msg); 
}

Una modifica di lieve entità al codice precedente consente di visualizzare le opzioni di un nodo nidificato, nel caso riportato di seguito la pagina Formattazione, C#, Editor di testo, Opzioni. È possibile eseguire questa operazione modificando il secondo valore del parametro Properties in base alle opzioni che si desidera visualizzare o modificare, ad esempio DTE.Properties("TextEditor", "Basic - Tabs") o DTE.Properties("Environment", "Help - Online"). I valori da utilizzare sono elencati all'inizio di questo argomento.

In questo caso, viene utilizzato "CSharp - Formattazione" per visualizzare le impostazioni delle opzioni Formattazione per l'Editor di testo C#.

' Add-in code.
Sub PropertiesExample()
    ' Create and initialize a variable to represent the C# 
    ' Formatting text editor options page.
    Dim txtEdCSFormat As EnvDTE.Properties = _
    DTE.Properties("TextEditor", "CSharp - Formatting")
    Dim prop As EnvDTE.Property
    Dim msg As String

    ' Loop through each item in the C# Formatting Options page. 
    For Each prop In txtEdCSFormat
        msg += ("PROP NAME: " & prop.Name & "   VALUE: " & _
        prop.Value) & vbCr
    Next
    MsgBox(msg)
End Sub

Vedere anche

Condividi tramite

Insiemi Properties di DTE

Esempio

Vedere anche

Attività

Concetti

Riferimenti

Risorse aggiuntive