CWnd::GetDSCCursor

Artikel
02/26/2013

Rufen Sie die Memberfunktion auf, um einen Zeiger auf das zugrunde liegende Cursor abzurufen, der von DataSource, den Benutzernamen, das Kennwort und die SQL-Eigenschaften des Datenquellensteuerelements definiert ist.

IUnknown * GetDSCCursor( );

Rückgabewert

Ein Zeiger auf einen Cursor, der durch ein Datenquellensteuerelement definiert ist.MFC verarbeitet die um Aufrufen von AddRef für den Zeiger.

Hinweise

Verwenden Sie den zurückgegebenen Zeiger, um die ICursor-Eigenschaft eines komplexen datengebundenen Steuerelements, wie des datengebundenen Rastersteuerelements festzulegen.Ein Datenquellensteuerelement wird nicht aktiv, bis das erste gebundene Steuerelement seinen Cursor anfordert.Dies kann entweder durch einen Aufruf GetDSCCursor geschehen explizit oder implizit durch den MFC-Bindungs-Manager.In jedem Fall können Sie ein Datenquellensteuerelement erzwingen, dass aktiv wird, indem Sie GetDSCCursor aufrufen und dann Release für den zurückgegebenen Zeiger auf IUnknown aufrufen.Aktivierung wird das Datenquellensteuerelement zu versuchen, an die zugrunde liegende Datenquelle herzustellen.Der zurückgegebene Zeiger wird im folgenden Kontext verwendet werden:

Beispiel

BOOL CMyDlg::OnInitDialog()
{


...


// Find the child controls on the dialog
HRESULT hr = E_FAIL;
CWnd* pDSC = GetDlgItem(IDC_DATASOURCE);
CWnd* pListWnd = GetDlgItem(IDC_DBLIST1);
IUnknown* punkList = pListWnd->GetControlUnknown();
IDBList* pList = NULL;

if (NULL != punkList)
{
   hr = punkList->QueryInterface(__uuidof(IDBList), (void**)&pList);
}

if (SUCCEEDED(hr))
{
   // Tell the MFC binding manager that we are
   // binding DISPID 3 to the data-source control.
   pListWnd->BindProperty(0x3, pDSC);

   // Tell the listbox which field to expose as its bound column
   pList->put_BoundColumn(_T("ContactFirstName"));

   // Tell the listbox which cursor and column to populate its list from
   pList->put_ListField(_T("ContactFirstName"));

   IUnknown* punkCursor = pDSC->GetDSCCursor();
   if (NULL != punkCursor)
   {
      punkCursor->Release();
   }

   pList->Release();


...


    return TRUE;
}