Share via


Asistente para objetos simples ATL

Este asistente inserta en el proyecto un objeto COM mínimo. Utilice esta página del asistente para especificar los nombres que identifican la clase y los archivos de C++ para el objeto y su funcionalidad COM.

Use la página Opciones de este asistente para especificar el modelo de subprocesos del objeto, su compatibilidad con la agregación y si admite interfaces duales y Automation. También puede indicar la compatibilidad con la interfaz de información de error, los puntos de conexión, el soporte técnico de Internet Explorer y la serialización de subproceso libre.

Comentarios

A partir de Visual Studio 2008, el script de registro producido por este asistente registrará sus componentes COM en HKEY_CURRENT_USER en lugar de HKEY_LOCAL_MACHINE. Para modificar este comportamiento, establezca la opción para registrar componentes para todos los usuarios del Asistente para ATL.

Nombres

Especifique los nombres para el objeto, la interfaz y las clases que se van a agregar al proyecto. Excepto en el caso de Nombre corto, el resto de los cuadros se pueden editar independientemente de los demás. Si cambia el texto para Nombre corto, el cambio se refleja en los nombres del resto de los cuadros de esta página. Si cambia el nombre Coclase en la sección de COM, el cambio se refleja en los cuadros Tipo y ProgID, pero el nombre Interfaz no cambia. Este comportamiento de nomenclatura se ha diseñado para facilitarle la identificación de todos los nombres a medida que desarrolla su control.

Nota:

Coclase solo se puede editar en proyectos sin atributos. Si su proyecto tiene atributos, no podrá editar Coclase.

C++

Proporciona información para la clase de C++ creada para el objeto.

  • Nombre corto

    Especifica un nombre abreviado para el objeto. El nombre que proporciona determina los nombres Class y Coclass, los nombres archivo .cpp y archivo .h, el nombre Interfaz, los nombres Tipo y ProgID, a menos que cambie esos campos individualmente.

  • Archivo .h

    Establece el nombre del archivo de encabezado para la clase nueva del objeto. De forma predeterminada, este nombre se basa en el que se proporcione en Nombre corto. Haga clic en el botón de puntos suspensivos para guardar el nombre de archivo en la ubicación que elija, o bien para anexar la declaración de clase a un archivo existente. Si selecciona un archivo existente, el asistente no lo guardará en la ubicación seleccionada hasta que haga clic en Finalizar en el asistente.

    El asistente no sobrescribe un archivo. Si selecciona el nombre de un archivo existente, al hacer clic en Finalizar, el asistente le pedirá que indique si se debe anexar la declaración de clase al contenido del archivo. Haga clic en para anexar el archivo; haga clic en No para volver al asistente y especificar otro nombre de archivo.

  • Clase

    Establece el nombre de la clase que se va a crear. Este nombre se basa en el que se proporcione en Nombre corto, precedido de "C", el prefijo típico para un nombre de clase.

  • Archivo .cpp

    Establece el nombre del archivo de implementación para la clase nueva del objeto. De forma predeterminada, este nombre se basa en el que se proporcione en Nombre corto. Haga clic en el botón de puntos suspensivos para guardar el nombre de archivo en la ubicación que elija. El archivo no se guarda en la ubicación seleccionada hasta que haga clic en Finalizar en el asistente.

    El asistente no sobrescribe un archivo. Si selecciona el nombre de un archivo existente, al hacer clic en Finalizar, el asistente le pedirá que indique si se debe anexar la implementación de clase al contenido del archivo. Haga clic en para anexar el archivo; haga clic en No para volver al asistente y especificar otro nombre de archivo.

  • Con atributos

    Indica si el objeto usa atributos. Si agrega un objeto a un proyecto ATL con atributos, esta opción estará activada y no se podrá cambiar. Es decir, solo puede agregar objetos con atributos a un proyecto creado con compatibilidad con atributos.

    Solo puede agregar un objeto con atributos a un proyecto ATL que usa atributos. Si selecciona esta opción para un proyecto ATL sin compatibilidad con atributos, el asistente le pedirá que especifique si desea agregar dicha compatibilidad al proyecto.

    De forma predeterminada, cualquier objeto que agregue una vez que establezca esta opción se designará como con atributos (la casilla estará activada). Puede borrar esta casilla para agregar un objeto que no usa atributos.

    Consulte Configuración de la aplicación, Asistente para proyectos ATL y Mecanismos básicos de los atributos para obtener más información.

COM

Proporciona información sobre la funcionalidad COM del objeto.

  • Coclase

    Establece el nombre de la clase de componente que contiene una lista de interfaces que admite el objeto.

    Nota:

    Si crea su proyecto mediante atributos o indica en esta página del asistente que el objeto usa atributos, no podrá cambiar esta opción porque ATL no incluye el atributo coclass.

  • Tipo

    Establece la descripción del objeto que aparecerá en el Registro.

  • Interface

    Establece la interfaz que crea para el objeto. Esta interfaz contiene sus métodos personalizados.

  • ProgID

    Establece el nombre que pueden usar los contenedores en lugar del CLSID del objeto.

Consulte también

Objeto simple ATL