CWnd::BindDefaultProperty

Binds the calling object's default simple bound property (such as an edit control), as marked in the type library, to the underlying cursor that is defined by the DataSource, UserName, Password, and SQL properties of the data-source control.

void BindDefaultProperty(
   DISPID dwDispID,
   VARTYPE vtProp,
   LPCTSTR szFieldName,
   CWnd * pDSCWnd 
);

Parameters

  • dwDispID
    Specifies the DISPID of a property on a data-bound control that is to be bound to a data-source control.

  • vtProp
    Specifies the type of the property to be bound — for example, VT_BSTR, VT_VARIANT, and so on.

  • szFieldName
    Specifies the name of the column, in the cursor provided by the data-source control, to which the property will be bound.

  • pDSCWnd
    Points to the window that hosts the data-source control to which the property will be bound. Call GetDlgItem with the resource ID of the DCS's host window to retrieve this pointer.

Remarks

The CWnd object on which you call this function must be a data-bound control.

Example

BindDefaultProperty might be used in the following context:

BOOL CMyDlg::OnInitDialog()
{


...


CWnd* pDSC = GetDlgItem(IDC_DATASOURCE);
CWnd* pMyBound = GetDlgItem(IDC_MYBOUNDCTRL1);
pMyBound->BindDefaultProperty(0x1, VT_BSTR, _T("ContactFirstName"), pDSC);


...


    return TRUE;
}

Requirements

Header: afxwin.h

See Also

Reference

CWnd Class

Hierarchy Chart

CWnd::GetDSCCursor

CWnd::BindProperty

Concepts

CWnd Members