Agregar una clase

  • Artículo

Para agregar una clase en un proyecto de C++, en el Explorador de soluciones, haga clic con el botón derecho en el proyecto, elija Agregar y luego Clase. Este comando abre el cuadro de diálogo Agregar clase.

Cuando se agrega una clase, se debe especificar un nombre que sea distinto al de las clases que ya existen en MFC o ATL. Si se especifica un nombre que ya existe en alguna de esas bibliotecas, el IDE muestra un mensaje de error.

Si la convención de nomenclatura del proyecto requiere usar un nombre existente, solo se pueden cambiar las mayúsculas y minúsculas de una o varias letras en el nombre porque C++ distingue mayúsculas de minúsculas. Por ejemplo, aunque una clase no se puede denominar CDocument, se puede denominar cdocument.

En esta sección

¿Qué tipo de clase quiere agregar?

En el cuadro de diálogo Agregar clase, cuando se expande el nodo Visual C++ en el panel de la izquierda, se muestran varias agrupaciones de plantillas instaladas. Los grupos incluyen CLR, ATL, MFC y C++. Cuando se selecciona un grupo, en el panel central se muestra una lista de las plantillas disponibles en ese grupo. Cada plantilla contiene los archivos y el código fuente que son necesarios para una clase.

Para generar una clase nueva, seleccione una plantilla en el panel central, escriba un nombre para la clase en el cuadro Nombre y elija Agregar. Este botón abre el Asistente para agregar clases para que pueda especificar opciones para la clase.

  • Para obtener más información sobre cómo crear clases de MFC, vea Clases de MFC.

  • Para obtener más información sobre cómo crear clases de ATL, vea Objeto simple ATL.

Nota

La plantilla Agregar compatibilidad de ATL a MFC no crea una clase, pero en su lugar, configura el proyecto para usar ATL. Para obtener más información, vea Compatibilidad de ATL en un proyecto MFC.

Para hacer que una clase de C++ que no usa MFC, ATL ni CLR, use la plantilla Clase de C++ del grupo de plantillas instaladas C++. Para obtener más información, vea Agregar una clase genérica de C++.

Existen dos tipos de clases de C++ basadas en formularios. El primero, CFormView (clase), crea una clase de MFC. El segundo crea una clase de Windows Forms de CLR.

Agregar clase (cuadro de diálogo)

En Visual Studio 2015, el cuadro de diálogo Agregar clase contiene plantillas que permiten:

  • Abrir a un asistente para código correspondiente, si está disponible. Para obtener más información, vea Agregar funcionalidad con los Asistentes para código.

    O bien

  • Crear automáticamente una nueva clase propia agregando el código fuente y los archivos adecuados al proyecto.

Puede acceder al cuadro de diálogo Agregar clase desde el menú Proyecto, el Explorador de soluciones o la Vista de clases.

Nota

Cuando intente agregar una clase que no es adecuada para el proyecto actual, recibirá un mensaje de error. Seleccione Aceptar para volver al cuadro de diálogo Agregar clase.

En Visual Studio 2017 y versiones posteriores, el cuadro de diálogo Agregar clase es el cuadro de diálogo Clase genérica de C++. Para obtener más información, vea Agregar una clase genérica de C++.

Cuadro de diálogo Asistente para clases

Puede crear una clase a partir de plantillas instaladas en el cuadro de diálogo Asistente para clases. Para usar el Asistente para clases, haga clic con el botón derecho en su proyecto en el Explorador de soluciones y, después, elija Asistente para clases en el menú contextual. El botón Agregar clase que hay en el cuadro de diálogo tiene un control desplegable para elegir una plantilla.

Captura de pantalla del cuadro de diálogo del Asistente para clases de C++.

También puede usar el Asistente para clases para modificar o examinar una clase existente.

Plantillas de Agregar clase

Hay cuatro categorías de plantillas de Agregar clase : .NET, ATL, MFC y genérica.

.NET

Plantilla Asistente
Servicio Web ASP.NET No disponible
Clase de componente (.NET) No disponible
Clase de instalador (.NET) No disponible
Control de usuario (.NET) No disponible
Windows Form (.NET) No disponible

ATL

Plantilla Asistente
Agregar compatibilidad de ATL a MFC No disponible
Control ATL Asistente para controles ATL
Cuadro de diálogo ATL Asistente para cuadros de diálogo ATL
Objeto simple ATL Asistente para objetos simples ATL
Proveedor de eventos WMI Asistente para el proveedor de eventos WMI
Proveedor de instancias WMI Asistente para el proveedor de instancias WMI

MFC

Plantilla Asistente
MFC (clase) Asistente para agregar clases MFC

Clases genéricas

Plantilla Asistente
Clase genérica de C++ Asistente de clases genéricas de C++