Aggiungere e rimuovere pagine delle proprietà

  • Articolo

Progettazione progetti offre una posizione centralizzata per la gestione delle proprietà, delle impostazioni e delle risorse del progetto in Visual Studio. Viene visualizzato come una singola finestra nell'ambiente di sviluppo integrato (IDE) di Visual Studio e contiene un numero di riquadri a destra a cui si accede tramite le schede a sinistra. I riquadri (spesso definiti pagine delle proprietà) in Progettazione progetti variano in base al tipo di progetto e alla lingua. È possibile accedere a Progettazione progetti con il comando Proprietà dal menu Progetto .

Un sottotipo di progetto deve spesso visualizzare pagine di proprietà aggiuntive in Progettazione progetti. Analogamente, alcuni sottotipi di progetto potrebbero richiedere la rimozione delle pagine delle proprietà predefinite. A tale scopo, il sottotipo di progetto deve implementare l'interfaccia ed eseguire l'override IVsHierarchy del GetProperty metodo . Eseguendo l'override di questo metodo e usando propId un parametro contenente uno dei valori dell'enumerazione __VSHPROPID2 , è possibile filtrare, aggiungere o rimuovere le proprietà del progetto. Ad esempio, potrebbe essere necessario aggiungere una pagina alle pagine delle proprietà dipendenti dalla configurazione. A tale scopo, è necessario filtrare le pagine delle proprietà dipendenti dalla configurazione e quindi aggiungere una nuova pagina all'elenco esistente.

Aggiungere e rimuovere pagine delle proprietà in Progettazione progetti

Rimuovere una pagina delle proprietà

  1. Eseguire l'override del GetProperty(uint itemId, int propId, out object property) metodo per filtrare le pagine delle proprietà e ottenere un clsids elenco.

    protected override int GetProperty(uint itemId, int propId, out object property)
{
    //Use propId to filter configuration-independent property pages.
    switch (propId)
    {
        . . . .

        case (int)__VSHPROPID2.VSHPROPID_PropertyPagesCLSIDList:
            {
                //Get a semicolon-delimited list of clsids of the configuration-independent property pages
                ErrorHandler.ThrowOnFailure(base.GetProperty(itemId, propId, out property));
                string propertyPagesList = ((string)property).ToUpper(CultureInfo.InvariantCulture);
                //Remove the property page here
                . . . .
            }
         . . . .
     }
        . . . .
    return base.GetProperty(itemId, propId, out property);
}

  2. Rimuovere la pagina Eventi di compilazione dall'elenco ottenuto clsids .

    string buildEventsPageGuid = "{1E78F8DB-6C07-4D61-A18F-7514010ABD56}";
int index = propertyPagesList.IndexOf(buildEventsPageGuid);
if (index != -1)
{
    // GUIDs are separated by ';' so if you remove the last GUID, also remove the last ';'
    int index2 = index + buildEventsPageGuid.Length + 1;
    if (index2 >= propertyPagesList.Length)
        propertyPagesList = propertyPagesList.Substring(0, index).TrimEnd(';');
    else
        propertyPagesList = propertyPagesList.Substring(0, index) + propertyPagesList.Substring(index2);
}
//New property value
property = propertyPagesList;

Aggiungere una pagina delle proprietà

  1. Creare una pagina delle proprietà da aggiungere.

    class DeployPropertyPage : Form, Microsoft.VisualStudio.OLE.Interop.IPropertyPage
{
    . . . .
    //Summary: Return a structure describing your property page.
    public void GetPageInfo(Microsoft.VisualStudio.OLE.Interop.PROPPAGEINFO[] pPageInfo)
    {
        PROPPAGEINFO info = new PROPPAGEINFO();
        info.cb = (uint)Marshal.SizeOf(typeof(PROPPAGEINFO));
        info.dwHelpContext = 0;
        info.pszDocString = null;
        info.pszHelpFile = null;
        info.pszTitle = "Deployment";  //Assign tab name
        info.SIZE.cx = this.Size.Width;
        info.SIZE.cy = this.Size.Height;
        if (pPageInfo != null && pPageInfo.Length > 0)
            pPageInfo[0] = info;
    }
}

  2. Registrare la nuova pagina delle proprietà.

    [MSVSIP.ProvideObject(typeof(DeployPropertyPage), RegisterUsing = RegistrationMethod.CodeBase)]

  3. Eseguire l'override del GetProperty(uint itemId, int propId, out object property) metodo per filtrare le pagine delle proprietà, ottenere un clsids elenco e aggiungere una nuova pagina delle proprietà.

    protected override int GetProperty(uint itemId, int propId, out object property)
{
    //Use propId to filter configuration-dependent property pages.
    switch (propId)
    {
        . . . .
        case (int)__VSHPROPID2.VSHPROPID_CfgPropertyPagesCLSIDList:
            {
                //Get a semicolon-delimited list of clsids of the configuration-dependent property pages.
                ErrorHandler.ThrowOnFailure(base.GetProperty(itemId, propId, out property));
                //Add the Deployment property page.
                property += ';' + typeof(DeployPropertyPage).GUID.ToString("B");
            }
     }
        . . . .
    return base.GetProperty(itemId, propId, out property);
}

Contenuto correlato