Ejemplo ATLPages: implementa una página de propiedades mediante IPropertyPageImpl
Actualización: noviembre 2007
El ejemplo ATLPages muestra la implementación de una página de propiedades mediante IPropertyPageImpl.
Este ejemplo está compuesto por:
Una clase de página de propiedades, CDocumentProperties, que utiliza la interfaz EnvDTE::Document para mostrar (y permitir cambios en) las propiedades de un documento de texto.
Un componente auxiliar, CHelper, que expone un contenedor simplificado a la API OleCreatePropertyFrame para lenguajes de secuencia de comandos.
Una macro de prueba sencilla, Test, del proyecto ATLPages.vsmacros, que utiliza el componente auxiliar para mostrar la página de propiedades para el documento activo dentro del editor de Visual C++.
.gif "Nota de seguridad") Nota de seguridad: |
|---|
Este código de ejemplo se proporciona para ilustrar un concepto y no debe utilizarse en aplicaciones o sitios Web, ya que quizás no ilustre las prácticas de codificación más seguras. Microsoft no asume ninguna responsabilidad por daños incidentales o consecuentes en caso de que el código de ejemplo se utilice para propósitos distintos de aquellos para los que se concibió. |
Para obtener ejemplos e instrucciones para su instalación:
En el menú Ayuda de Visual Studio, haga clic en Ejemplos.
Para obtener más información, vea Localizar archivos de ejemplo.
La lista de ejemplos completa con la versión más reciente está disponible en línea en la página Visual Studio 2008 Samples.
También encontrará ejemplos en el disco duro de su equipo. De manera predeterminada, los ejemplos y el archivo Léame se copian en una carpeta bajo \Archivos de programa\Visual Studio 9.0\Samples\. Para las versiones Express de Visual Studio, todos los ejemplos están en línea.
Generar y ejecutar el ejemplo
Para ejecutar el ejemplo, deberá generar la solución y, a continuación, ejecutar la macro de prueba.
Para generar este ejemplo
Abra el archivo de solución ATLPages7.sln.
En el menú Generar, haga clic en Generar solución.
Para ejecutar la macro
Abra un documento de texto en el editor. Por ejemplo, abra uno de los archivos de código fuente del ejemplo ATLPages.
En el menú Herramientas, elija Macros y después haga clic en Explorador de macros. Esto abrirá la ventana del Explorador de macros.
En el menú Herramientas, elija Macros y después haga clic en Cargar proyecto de macros. Esto abrirá el cuadro de diálogo Agregar proyecto de macros.
Desplácese hasta la ubicación del archivo ATLPages.vsmacros (se encuentra en la misma carpeta que el ejemplo ATLPages) y haga clic en el botón Abrir. Esta acción cargará el archivo de macros y hará que se muestre en el Explorador de macros.
Expanda el nodo ATLPages y haga doble clic en la macro Test.
Si no hay ningún documento abierto al ejecutar la macro, no se realiza ninguna acción. Si hay algún documento abierto, se mostrará una página de propiedades para ese documento con el nombre del archivo y su estado de sólo lectura. Puede cambiar cualquiera de estos elementos. Los cambios se aplicarán al hacer clic en el botón Aplicar o Aceptar. Si cambia el nombre del archivo, éste se guardará en disco con el nuevo nombre. Si cambia el estado de sólo lectura del archivo, esto sólo afecta al hecho de que el archivo se pueda modificar dentro del editor de Visual C++ (no afecta al atributo de sólo lectura del archivo en el disco).
.gif "Nota")
Nota:No es posible cambiar la propiedad de sólo lectura de los archivos bajo control del código fuente mediante esta página de propiedades.
Palabras clave
En este ejemplo se utilizan las siguientes palabras clave:
IPropertyPage, IPropertyPageImpl, OleCreatePropertyFrame, IPropertyPage::SetObjects, IPropertyPage::Activate, IPropertyPage::Apply, EnvDTE