Interfaz de usuario de propiedades de proyecto
Un subtipo de proyecto puede usar los elementos del cuadro de diálogo Páginas de propiedades del proyecto tal como los proporciona el proyecto base, ocultar o hacer controles de solo lectura y páginas completas tal como se proporcionan o agregar páginas específicas del subtipo del proyecto al cuadro de diálogo Páginas de propiedades.
Extensión del cuadro de diálogo Propiedad del proyecto
Un subtipo de proyecto implementa extensores de automatización y objetos de exploración de la configuración del proyecto. Estos extensores implementan la IFilterProperties interfaz para que determinadas propiedades se oculten o de solo lectura. El cuadro de diálogo Páginas de propiedades del proyecto base, implementado por el proyecto base, respeta el filtrado realizado por los extensores de Automation.
El proceso de extensión de un cuadro de diálogo Propiedad del proyecto se describe a continuación:
El proyecto base recupera los extensores del subtipo del proyecto mediante la implementación de la IInternalExtenderProvider interfaz . La exploración, la automatización del proyecto y la configuración del proyecto examinan objetos del proyecto base todas implementan esta interfaz.
La implementación de IInternalExtenderProvider para el objeto browse del proyecto y el delegado del objeto de automatización del proyecto a la IInternalExtenderProvider implementación del agregador de subtipos del proyecto (es decir, para
QueryInterfaceIInternalExtenderProvider en el objeto de IVsHierarchy proyecto).El objeto de exploración de la configuración del proyecto base también se IInternalExtenderProvider implementa para conectar directamente en el extensor de Automation desde el objeto de configuración de subtipo del proyecto. Su implementación delega a la IInternalExtenderProvider interfaz implementada por el agregador de subtipo del proyecto.
GetProjectItem, implementado por el objeto browse de configuración del proyecto, devuelve el IVsHierarchy objeto .
GetCfg, también implementado por el objeto browse de configuración del proyecto, devuelve el IVsCfg objeto .
Un subtipo de proyecto puede determinar los CATID adecuados para los distintos objetos extensibles del proyecto base en tiempo de ejecución recuperando los siguientes __VSHPROPID2 valores:
Para determinar los CATID para el ámbito del proyecto, el subtipo del proyecto recupera las propiedades anteriores para VSITEMID. Raíz de .VSITEMID typedef Un subtipo de proyecto también puede querer controlar qué páginas de cuadro de diálogo páginas de propiedades se muestran para el proyecto, tanto dependientes de la configuración como independientes de la configuración. Es posible que algunos subtipos de proyecto necesiten quitar páginas integradas y agregar páginas específicas del subtipo de proyecto. Para habilitar esto, el proyecto de cliente administrado llama al GetProperty método para las siguientes propiedades:
VSHPROPID_PropertyPagesCLSIDList: una lista delimitada por punto y coma de CLSID de páginas de propiedades independientes de la configuración.VSHPROPID_CfgPropertyPagesCLSIDList —una lista delimitada por punto y coma de CLSID de páginas de propiedades dependientes de la configuración.
Dado que el subtipo del proyecto agrega el IVsHierarchy objeto, puede invalidar la definición de estas propiedades para controlar los cuadros de diálogo Páginas de propiedades que se muestran. El subtipo del proyecto puede recuperar estas propiedades del proyecto base interno y, a continuación, agregar o quitar CLSID según sea necesario.
Las nuevas páginas de propiedades agregadas por un subtipo de proyecto se entregan a un objeto browse de configuración del proyecto desde la implementación del proyecto base. Este objeto de exploración de configuración del proyecto admite extensores de Automation. Para obtener más información sobre AutomationExtenders, consulte Implementación y uso de extensores de Automation. Las páginas de propiedades implementadas por la llamada Extender[] de subtipo del proyecto para recuperar su propio objeto de examen de configuración del subtipo de proyecto que extiende el objeto de exploración de configuración del proyecto base.