Add Member Variable Wizard

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at Add Member Variable Wizard.

This wizard adds a member variable declaration to the header file and, depending on the options, it can add code to the .cpp file. Once you have added the member variable using the wizard, you can edit the code in the development environment.

Access
Sets the access to the member variable. Access modifiers are keywords that specify the access other classes have to the member variable. See Member-Access Control for more information about specifying access. The member variable access level is set to public by default.

• public

• protected

• private

Variable type
Sets the return type for the member variable you are adding.

• If you are adding a member variable that is not a dialog box control, select from the list of available types.

  For information about the types, see Fundamental Types.

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

• If you are adding a member variable for a dialog box control, this box is filled with the type of object returned for a control or value. If you select Control, then Variable type specifies the base class of the control you select in the Control ID box. If the dialog box control can contain a value, and if you select Value, then Variable type specifies the appropriate type for the value that control can contain. See Dialog Box Controls and Variable Types for more information.

  This value depends on the selection in Control ID and cannot be changed.

Variable name
Sets the name of the member variable you are adding. Member variables typically begin with the identifying string "m_," which is provided for you by default.

Control variable
Indicates that the member variable manages a control within a dialog box with data exchange and data validation support. See DoDataExchange for more information. This option is available only for member variables added to classes derived from CDialog. Select this box to activate the Control ID and Control type options.

Control ID
Sets the ID for the control variable you are adding. Select from the list the ID for the type of control for which you are adding the member variable. The list is active only when the Control variable box is selected, and it is limited to IDs for the controls already added to the dialog box. For example, for the standard OK button, the Control ID is IDOK.

Category
Specifies whether the variable is based on a control type or the value of the control.

Control type
Sets the type of control being added. This box is not available to change. For example, a button has the control type BUTTON, and a combo box has the control type COMBOBOX. See Dialog Box Controls and Variable Types for more information.

Max characters
Available only when Variable type is set to CString. Indicates the maximum number of characters that the control can hold.

Min value
Available only when the variable type is BOOL, int, UINT, long, DWORD, float, double, BYTE, short, COLECurrency or CTime. Indicates the lowest value acceptable for a scale or date range.

Max value
Available only when the variable type is BOOL, int, UINT, long, DWORD, float, double, BYTE, short, COLECurrency or CTime. Indicates the highest value acceptable for a scale or date range.

.h file
For ActiveX controls, whose member variables require a wrapper class. Sets the name of the header file to add the class declaration.

.cpp file
For ActiveX controls, whose member variables require a wrapper class. Sets the name of the implementation file to add the class definition.

Comment
Provides a comment in the header file for the member variable.

See Also

Adding a Member Variable