Insiemi Properties di DTE

Le proprietà a livello di ambiente sono organizzate in categorie corrispondenti alla gerarchia visualizzata nella finestra di dialogo Opzioni. Ad esempio, DTE.Properties("TextEditor", "Basic") rappresenta le impostazioni presenti nel nodo Basic sotto il nodo Editor di testo nella finestra di dialogo Opzioni del menu Strumenti. In molti casi, le impostazioni presenti sulle pagine nella finestra di dialogo sono anche rappresentate da proprietà. Ad esempio, nella pagina Tabulazioni nel nodo Basic al di sotto del nodo 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 che sono rappresentati dalla proprietà Value. Per informazioni su come modificare i valori tramite le proprietà, vedere Controllo delle impostazioni relative alle opzioni.

Nei documenti seguenti sono elencate le categorie predefinite delle impostazioni incluse in Visual Studio.

• Pagina delle opzioni, Proprietà del nodo Ambiente

• Pagina delle opzioni, Proprietà del nodo Tipi di carattere e colori

• Pagina delle opzioni, Proprietà del nodo Editor di testo

• Formattazione, C#, Editor di testo, finestra di dialogo Opzioni

Per aggiungere impostazioni a una pagina Opzioni esistente o per aggiungere una pagina personalizzata alla finestra di dialogo Opzioni, utilizzare Visual Studio SDK. Per ulteriori informazioni, vedere il sito Web Development Tools Ecosystem Partner Portal .

Nota

Alcune pagine presenti nella finestra di dialogo Opzioni non supportano l'automazione. Per ulteriori informazioni su quali pagine delle proprietà supportano l'automazione, vedere Determinazione dei nomi degli elementi delle proprietà nelle pagine delle opzioni.

Per aprire la finestra di dialogo Opzioni nell'ambiente di sviluppo integrato (IDE, Integrated Development Environment), scegliere Opzioni dal menu Strumenti.

Esempio

Nell'esempio riportato di seguito viene illustrato come visualizzare tutti gli elementi di proprietà accessibili nella pagina Generale del nodo C# nel nodo Editor di testo della finestra di dialogo Opzioni. 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); 
}

Nell'esempio riportato di seguito, che contiene una breve modifica dell'esempio precedente, è possibile visualizzare le impostazioni di un nodo annidato, in questo caso, il nodo Formattazione nel nodo C# sotto il nodo Editor di testo. Per effettuare la modifica, cambiare il valore del secondo parametro Properties sull'impostazione da visualizzare o modificare, ad esempio DTE.Properties("TextEditor", "Basic-Specific") o DTE.Properties("Environment", "ProjectsAndSolution"). I valori da utilizzare sono elencati all'inizio di questo documento.

In questo caso, viene utilizzato "CSharp - Formattazione" per visualizzare le impostazioni 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-Specific")
    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

Attività

Procedura: creare pagine delle opzioni personalizzate

Concetti

Controllo delle impostazioni relative alle opzioni

Determinazione dei nomi degli elementi delle proprietà nelle pagine delle opzioni