PX_String

Call this function within your control's DoPropExchange member function to serialize or initialize a character string property.

BOOL PX_String(
   CPropExchange* pPX,
   LPCTSTR pszPropName,
   CString& strValue 
);
BOOL PX_String(
   CPropExchange* pPX,
   LPCTSTR pszPropName,
   CString& strValue,
   CString strDefault 
);

Parameters

  • pPX
    Pointer to the CPropExchange object (typically passed as a parameter to DoPropExchange).

  • pszPropName
    The name of the property being exchanged.

  • strValue
    Reference to the variable where the property is stored (typically a member variable of your class).

  • strDefault
    Default value for the property.

Return Value

Nonzero if the exchange was successful; 0 if unsuccessful.

Remarks

The property's value is read from or written to the variable referenced by strValue, as appropriate. If strDefault is specified, it will be used as the property's default value. This value is used if, for any reason, the control's serialization process fails.

Requirements

Header: afxctl.h

See Also

Concepts

MFC Macros and Globals

COleControl::DoPropExchange

CStringT Class