Compartir a través de

Agregar una variable miembro

  • Artículo

Se puede agregar una variable miembro a una clase mediante la Vista de clases. Las variables miembro pueden ser para intercambio y validación de datos, o bien pueden ser genéricas. El Asistente para agregar variables miembro se ha diseñado para tomar la información relevante y usarla para insertar elementos en los archivos de código fuente en las ubicaciones adecuadas. Una variable miembro se puede agregar desde el Editor de cuadros de diálogo de la Vista de recursos, o bien desde la Vista de clases.

Nota

Cuando diseñe e implemente un cuadro de diálogo, es posible que le resulte más eficaz usar el Editor de cuadros de diálogo para agregar los controles de cuadro de diálogo y luego implementar las variables miembro de los controles.

Para agregar una variable miembro para un control de cuadro de diálogo en la Vista de recursos mediante el Asistente para agregar variables miembro:

  1. En la Vista de recursos, expanda el nodo del proyecto y el nodo Cuadro de diálogo para mostrar la lista de cuadros de diálogo del proyecto.

  2. Haga doble clic en el cuadro de diálogo al que quiera agregar la variable miembro para abrirlo en el Editor de cuadros de diálogo.

  3. En el cuadro de diálogo que se muestra en el Editor de cuadros de diálogo, haga clic con el botón derecho en el control al que quiera agregar la variable miembro.

  4. En el menú contextual, elija Agregar variable para mostrar el Asistente para agregar variables miembro.

    Nota

    Ya se proporciona un valor predeterminado en Id. de control.

  5. Proporcione la información en los cuadros apropiados del asistente. Para obtener más información, vea Tipos de controles de cuadro de diálogo y tipos de variable.

  6. Seleccione Finalizar para agregar la definición y el código de implementación al proyecto y cerrar el asistente.

Para agregar una variable miembro desde la Vista de clases mediante el Asistente para agregar variables miembro:

  1. En la Vista de clases, expanda el nodo del proyecto para mostrar las clases del proyecto.

  2. Haga clic con el botón derecho en la clase a la que quiera agregar una variable.

  3. En el menú contextual, elija Agregar y luego Agregar variable para mostrar el Asistente para agregar variables miembro.

  4. Proporcione la información en los cuadros apropiados del asistente. Para obtener más información, vea Asistente para agregar variables miembro.

  5. Seleccione Finalizar para agregar la definición y el código de implementación al proyecto y cerrar el asistente.

En esta sección

Asistente para agregar variables miembro

Este asistente agrega una declaración de variable miembro al archivo de encabezado. Según las opciones, puede agregar código al archivo .cpp. Una vez agregada la variable miembro mediante el asistente, el código se puede modificar en el entorno de desarrollo.

  • Acceso

    Establece el acceso a la variable miembro. Los modificadores de acceso son palabras clave que especifican el acceso que tienen otras clases a la variable miembro. Para obtener más información sobre la especificación de acceso, vea Control de acceso a miembros. El nivel de acceso a las variables miembro se establece en public de forma predeterminada.

  • Tipo de variable

    Establece el tipo de valor devuelto de la variable miembro que se va a agregar.

    • Si se va a agregar una variable miembro que no sea un control de cuadro de diálogo, seleccione en la lista de tipos disponibles.

      Para obtener información sobre los tipos, vea Tipos fundamentales.

      • char
      • double
      • float
      • int
      • long
      • short
      • unsigned char
      • unsigned int
      • unsigned long

    • Si se va a agregar una variable miembro para un control de cuadro de diálogo, este cuadro se rellena con el tipo de objeto devuelto para un control o valor. Si se selecciona Control, Tipo de variable especifica la clase base del control que se seleccione en el cuadro Id. de control. Si el control de cuadro de diálogo puede contener un valor, y si se selecciona Valor, en Tipo de variable se especifica el tipo adecuado para el valor que puede contener ese control. Para obtener más información, vea Tipos de controles de cuadro de diálogo y tipos de variable.

      Este valor depende de la selección de Id. de control y no se puede cambiar.

  • Nombre de variable

    Establece el nombre de la variable miembro que se va a agregar. Normalmente, las variables miembro comienzan con la cadena de identificación m_, que se proporciona de forma predeterminada.

  • Variable de control

    Indica que la variable miembro administra un control dentro de un cuadro de diálogo con compatibilidad con el intercambio y la validación de datos. Para obtener más información, vea DoDataExchange. Esta opción solo está disponible para las variables miembro que se agregan a las clases derivadas de CDialog. Active esta casilla para activar las opciones Id. de control y Tipo de control.

  • Id. de control

    Establece el identificador de la variable de control que se va a agregar. En la lista, seleccione el identificador para el tipo de control para el que se va a agregar la variable miembro. La lista solo está activa cuando la casilla Variable de control está activada y se limita a los identificadores de los controles que ya se han agregado al cuadro de diálogo. Por ejemplo, para el botón Aceptar estándar, el id. de control es IDOK.

    Opción Descripción
    Control Esta opción se establece de forma predeterminada para el tipo de control. Administra el propio control y no el estado ni el contenido de este (como se podría querer administrar para un cuadro de lista, cuadro combinado o cuadro de edición).
    Valor Esta opción está disponible para los tipos de control que pueden contener un valor o mostrar un estado, como un cuadro de edición o una casilla de verificación. También está disponible para los tipos de control cuyo intervalo, contenido o estado se podría administrar. Para obtener más información, vea Tipos de controles de cuadro de diálogo y tipos de variable.

  • Categoría

    Especifica si la variable se basa en el tipo de control o en el valor del control.

  • Tipo de control

    Establece el tipo de control que se va a agregar. Este cuadro no se puede cambiar. Por ejemplo, un botón tiene el tipo de control BUTTON, y un cuadro combinado tiene el tipo de control COMBOBOX. Para obtener más información, vea Tipos de controles de cuadro de diálogo y tipos de variable.

  • Número máximo de caracteres

    Disponible solo cuando Tipo de variable se establece en CString. Indica el número máximo de caracteres que puede contener el control.

  • Valor mínimo

    Solo está disponible cuando el tipo de variable es BOOL, int, UINT, long, DWORD, float, double, BYTE, short, COLECurrency o CTime. Indica el valor mínimo aceptable para una escala o intervalo de fechas.

  • Valor máximo

    Solo está disponible cuando el tipo de variable es BOOL, int, UINT, long, DWORD, float, double, BYTE, short, COLECurrency o CTime. Indica el valor más alto aceptable para una escala o intervalo de fechas.

  • Archivo .h

    Para los controles ActiveX, cuyas variables miembro requieren una clase contenedora. Establece el nombre del archivo de encabezado al que se va a agregar la declaración de clase.

  • Archivo .cpp

    Para los controles ActiveX, cuyas variables miembro requieren una clase contenedora. Establece el nombre del archivo de implementación al que se va a agregar la declaración de clase.

  • Comentario

    Proporciona un comentario en el archivo de encabezado para la variable miembro.

Tipos de controles de cuadro de diálogo y tipos de variable

Se puede usar el Asistente para agregar variables miembro para agregar una variable miembro a un control de cuadro de diálogo creado mediante MFC. El tipo de control para el que se agregue la variable miembro determina las opciones que aparecen en el cuadro de diálogo.

En la tabla siguiente se describen todos los tipos de control de cuadro de diálogo admitidos en MFC y el Editor de cuadros de diálogo. También se muestran sus tipos y valores disponibles.

Control Tipo de control Tipo de variable de control Tipo de variable de valor Valores mínimos y máximos (solo tipo de valor)
Animation (control) SysAnimate32 CAnimateCtrl Ninguno; solo el control N/D
Botón BUTTON CButton Ninguno; solo el control N/D
Casilla de verificación CHECK CButton BOOL Valor máximo y mínimo
Cuadro combinado COMBOBOX CComboBox CString Número máximo de caracteres
Control de selector de fecha y hora SysDateTimePick32 CDateTimeCtrl CTime Valor máximo y mínimo
Cuadro de edición EDITAR CEdit CString, int, UINT, long, DWORD, float, double, BYTE, short, BOOL, COleDateTime o COleCurrency Valor máximo y mínimo; algunos admiten número máximo de caracteres
Control de tecla de acceso rápido msctls_hotkey32 CHotKeyCtrl Ninguno; solo el control N/D
Cuadro de lista LISTBOX CListBox CString Número máximo de caracteres
List (control) SysListView32 CListCtrl Ninguno; solo el control N/D
Month Calendar (control) SysMonthCal32 CMonthCalCtrl CTime Valor máximo y mínimo
Control de progreso msctls_progress32 CProgressCtrl Ninguno; solo el control N/D
Control de edición de texto enriquecido 2 RichEdit20A CRichEditCtrl CString Número máximo de caracteres
Control de edición de texto enriquecido RICHEDIT CRichEditCtrl CString Número máximo de caracteres
Barra de desplazamiento (vertical u horizontal) SCROLLBAR CScrollBar int Valor máximo y mínimo
Slider (control) msctls_trackbar32 CSliderCtrl int Valor máximo y mínimo
Control de botón de número msctls_updown32 CSpinButtonCtrl Ninguno; solo el control N/D
Control Tab SysTabControl32 CTabCtrl Ninguno; solo el control N/D
Tree (control) SysTreeView32 CTreeCtrl Ninguno; solo el control N/D