Compartir a través de

Asistente para controles ATL

  • Artículo

Actualización: noviembre 2007

El asistente inserta un control ATL en un proyecto ATL (o un proyecto MFC compatible con ATL). Puede usarse este asistente para insertar uno de estos tres tipos de controles:

  • Un control estándar

  • Un control compuesto

  • Un control DHTML

Asimismo, se puede especificar un control mínimo, quitando las interfaces de la lista Interfaces, que se proporcionan como predeterminadas para los controles en la mayoría de los contenedores. Se pueden establecer las interfaces con las que se desea que sea compatible el control en la página Interfaces del asistente.

Comentarios

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

Nombres

Especifique el nombre del objeto, la interfaz y las clases que se agregarán al proyecto. A excepción de Nombre corto, todos los demás cuadros pueden editarse de manera independiente. Si cambia el texto de Nombre corto, el cambio repercutirá en los nombres de todos los demás cuadros de esta página. Si cambia el nombre de Coclase en la sección COM, el cambio repercutirá en los cuadros Tipo y ProgID, pero el nombre de Interfaz no variará. El comportamiento de nomenclatura está diseñado para que todos los nombres sean fácilmente identificables al crear los controles.

Nota:

Coclase es modificable sólo en controles sin atributos. Si su proyecto tiene atributos, no podrá editar Coclase.

C++

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

  • Nombre corto
    Define el nombre abreviado del objeto. El nombre que utilice determinará los nombres de la clase y de la Coclase, los nombres de archivo (.CPP y .H), el nombre de interfaz, los nombres de Tipo y el identificador de programa (ProgID), a menos que cambie estos campos por separado.

  • Clase
    Establece el nombre de la clase que implementará el objeto. Este nombre se basa en el nombre suministrado en Nombre corto, precedido por 'C', el prefijo habitual en un nombre de clase.

  • Archivo .H
    Establece el nombre del archivo de encabezado para la clase del nuevo objeto. De forma predeterminada, este nombre se basa en el nombre que indique en Nombre corto. Haga clic en el botón de los puntos suspensivos para guardar el nombre de archivo en la ubicación que desee o para anexar la declaración de la clase a un archivo existente. Si selecciona un archivo ya existente, el asistente no lo guardará en la ubicación seleccionada hasta que seleccione Finalizar.

    El asistente no sobrescribe ningún archivo. Si selecciona el nombre de un archivo existente, al hacer clic en Finalizar el asistente le preguntará si desea anexar la declaración de la clase al contenido del archivo. Haga clic en Sí para anexar el archivo; haga clic en No para regresar al asistente y especificar otro nombre de archivo.

  • Archivo .cpp
    Establece el nombre del archivo de implementación para la clase del nuevo objeto. De forma predeterminada, este nombre se basa en el nombre que indique en Nombre corto. Haga clic en el botón de los puntos suspensivos para guardar el nombre de archivo en la ubicación que desee. El archivo no quedará guardado en la ubicación seleccionada hasta que haga clic en Finalizar en el asistente.

    El asistente no sobrescribe ningún archivo. Si selecciona el nombre de un archivo que ya existe, al hacer clic en Finalizar, el asistente solicitará que especifique si la implementación de la clase debe anexarse al contenido del archivo. Haga clic en Sí para anexar el archivo; haga clic en No para regresar al asistente y especificar otro nombre de archivo.

  • Con atributos
    Indica si el objeto usa atributos o no. Si va a agregar un objeto a un proyecto ATL con atributos, esta opción estará activada y no se podrá modificar. Es decir, sólo se pueden agregar objetos con atributos a un proyecto que sea compatible con atributos.

    Solamente puede agregar objetos con atributos a un proyecto ATL que use atributos. Si selecciona esta opción en un proyecto ATL que no acepta atributos, el asistente le pedirá que especifique si desea agregar al proyecto la compatibilidad con atributos.

    De forma predeterminada, cualquier objeto que agregue después de configurar esta opción se designará como con atributos (la casilla estará activada). Puede desactivar la casilla para agregar objetos que no usen atributos.

    Para obtener más información, vea Configuración de la aplicación, Asistente para proyectos ATL y Aspectos prácticos básicos de los atributos.

COM

Proporciona información acerca de la funcionalidad COM de un objeto.

  • Coclase
    Establece el nombre de la clase componente que contiene una lista de las interfaces que acepta el objeto.

    Nota:

    Si crea el proyecto mediante atributos, o si indica en esta página del asistente que el control utiliza atributos, no puede cambiar esta opción, ya que ATL no incluye el atributo coclase.

  • Interfaz
    Establece el nombre de la interfaz correspondiente al objeto. De forma predeterminada, los nombres de interfaz llevan el prefijo "I".

  • Tipo
    Define la descripción del objeto que aparecerá en el Registro.

  • Id. de programa
    Establece el nombre que pueden usar los contenedores en lugar del CLSID del objeto.

Vea también

Tareas

Agregar un control ATL

Conceptos

Adding Functionality to the Composite Control

Referencia

Fundamentals of ATL COM Objects