Asistente para controles ATL

Inserta un control ATL en un proyecto ATL (o un proyecto MFC con compatibilidad con ATL). Este asistente se puede usar para insertar uno de estos tres tipos de controles:

• Control estándar

• Control compuesto

• Control DHTML

Además, puede especificar un control mínimo, para lo que debe quitar las interfaces de la lista Interfaces, que se proporcionan como valores predeterminados para que los controles se abran en la mayoría de los contenedores. En la página Interfaces del asistente, puede establecer las interfaces que desee que se admitan para el control.

Comentarios

El script de registro que genera este asistente registrará sus componentes COM en HKEY_CURRENT_USER, en lugar de en 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 cambiar de manera independiente. 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 de Coclase en la sección de COM, el cambio se refleja en el cuadro Tipo, pero el nombre de Interfaz y ProgID no cambian. 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 controles sin atributos. Si su proyecto tiene atributos, no podrá editar Coclase.

C++

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

• Nombre corto

  Especifica un nombre abreviado para el objeto. El nombre que proporcione determinará los nombres de clase y Coclase, los nombres de archivo(.CPP y .H), el nombre de la interfaz y los nombres de Tipo, salvo que esos campos se cambien individualmente.

• Clase

  Establece el nombre de la clase que implementa el objeto. 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 .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.

  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 Sí para anexar el archivo; haga clic en No para volver al asistente y especificar otro nombre de archivo.

• 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 Sí 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 control usa atributos, no puede cambiar esta opción porque ATL no incluye el atributo coclass.

• Interface

  Establece el nombre de la interfaz del objeto. De forma predeterminada, se antepone "I" al nombre de la interfaz.

• Tipo

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

• ProgID

  Establece el nombre que pueden usar los contenedores en lugar del CLSID del objeto. Este campo no se rellena automáticamente. Si este campo no rellena manualmente, es posible que el control no esté disponible para otras herramientas. Por ejemplo, los controles ActiveX que se generan sin ProgID no están disponibles en el cuadro de diálogo Insertar control ActiveX. Para más información sobre el cuadro de diálogo, consulte Inserción de controles ActiveX.

Consulte también

Control ATL
Agregar funciones al control compuesto
Aspectos básicos de los objetos ATL COM