CDataExchange osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Támogatja a Microsoft Foundation-osztályok által használt párbeszédpanel-adatcsere (DDX) és párbeszédpanel-adatérvényesítési (DDV) rutinokat.

Szemantika

class CDataExchange

Tagok

Nyilvános konstruktorok

Név	Description
CDataExchange::CDataExchange	Egy CDataExchange objektumot hoz létre.

Nyilvános metódusok

Név	Description
CDataExchange::Fail	Az ellenőrzés sikertelenségével hívja meg a rendszer. Visszaállítja a fókuszt az előző vezérlőre, és kivételt jelez.
CDataExchange::P repareCtrl	Előkészíti a megadott vezérlőt az adatcseréhez vagy az érvényesítéshez. Nemszerkeszthető vezérlőkhöz használható.
CDataExchange::P repareEditCtrl	Előkészíti a megadott szerkesztési vezérlőt az adatcseréhez vagy -ellenőrzéshez.
CDataExchange::P repareOleCtrl	Előkészíti a megadott OLE-vezérlőt az adatcserére vagy az érvényesítésre. Nemszerkeszthető vezérlőkhöz használható.

Nyilvános adatok tagjai

Név	Description
CDataExchange::m_bSaveAndValidate	A DDX és a DDV irányának jelzője.
CDataExchange::m_pDlgWnd	Az adatcsere párbeszédpanelje vagy ablaka.

Megjegyzések

CDataExchange nem rendelkezik alaposztálysal.

Ezt az osztályt akkor használja, ha egyéni adattípusokhoz vagy vezérlőelemekhez adatcsere rutinokat ír, vagy ha saját adatérvényesítési rutinokat ír. A saját DDX- és DDV-rutinok írásáról további információt a Technical Note 26 című témakörben talál. A DDX és a DDV áttekintését a párbeszédpanel adatcseréje, az ellenőrzés és a párbeszédpanelek című témakörben tekintheti meg.

Az CDataExchange objektumok a DDX és a DDV használatához szükséges környezeti információkat tartalmazzák. A jelölő m_bSaveAndValidate HAMIS, ha A DDX az adattagok párbeszédpanel-vezérlőinek kezdeti értékeinek kitöltésére szolgál. A jelölő m_bSaveAndValidate IGAZ, ha a DDX használatával a párbeszédpanel-vezérlők aktuális értékeit adattagokká állítja be, és amikor a DDV-t használja az adatértékek érvényesítéséhez. Ha a DDV érvényesítése sikertelen, a DDV-eljárás egy üzenetmezőt jelenít meg, amely ismerteti a bemeneti hibát. A DDV-eljárás ezután meghívja Fail , hogy állítsa vissza a fókuszt a jogsértő vezérlőre, és állítson be egy kivételt az érvényesítési folyamat leállításához.

Öröklési hierarchia

CDataExchange

Requirements

Fejléc: afxwin.h

CDataExchange::CDataExchange

A tagfüggvény meghívása objektum létrehozásához CDataExchange .

CDataExchange(
    CWnd* pDlgWnd,
    BOOL bSaveAndValidate);

Paraméterek

pDlgWnd
A vezérlőt tartalmazó szülőablakra mutató mutató. Ez általában egy CDialog-származtatott objektum.

bSaveAndValidate
Ha IGAZ, ez az objektum ellenőrzi az adatokat, majd adatokat ír a vezérlőkből a tagoknak. Ha HAMIS, az objektum az adatokat a tagokról a vezérlőkre helyezi át.

Megjegyzések

Hozzon létre egy CDataExchange objektumot saját maga, hogy további információkat tároljon az adatcsere objektumban az ablak CWnd::D oDataExchange tagfüggvényének továbbításához.

Example

CYourDataExchange dx(this, FALSE);
try
{
   DoDataExchange(&dx);
}
catch (CUserException *pe)
{
   // some part of the exchange went wrong
   // but the user has already been notified
   pe->Delete();
}

CDataExchange::Fail

A keretrendszer meghívja ezt a tagfüggvényt, ha egy párbeszédpanel adatérvényesítési (DDV) művelete meghiúsul.

void Fail();

Megjegyzések

Fail visszaállítja a fókuszt és a kijelölést arra a vezérlőre, amelynek ellenőrzése sikertelen volt (ha van visszaállítandó vezérlő). Fail ezután kivételt vet ki a CUserException típusból az érvényesítési folyamat leállításához. A kivétel miatt megjelenik egy üzenetmező, amely elmagyarázza a hibát. Miután a DDV ellenőrzése sikertelen volt, a felhasználó újra megadhatja az adatokat a jogsértő vezérlőben.

Az egyéni DDV-rutinok implementátorai meghívhatnak Fail a rutinjukból, ha az ellenőrzés sikertelen.

A saját DDX- és DDV-rutinok írásáról további információt a Technical Note 26 című témakörben talál. A DDX és a DDV áttekintéséhez tekintse meg a párbeszédpanel adatcserével, ellenőrzéssel és párbeszédpanel-témakörével kapcsolatos témaköröket.

CDataExchange::m_bSaveAndValidate

Ez a jelző egy párbeszédpanel adatcsere (DDX) műveletének irányát jelzi.

BOOL m_bSaveAndValidate;

Megjegyzések

A jelölő nem nulla, ha az CDataExchange objektumot arra használja, hogy adatokat helyezzen át a párbeszédpanel-vezérlőkről a párbeszédpanel-osztály adattagjaira, miután a felhasználó szerkessze a vezérlőket. A jelölő nulla, ha az objektumot a párbeszédpanel-osztály adattagok párbeszédpanel-vezérlőinek inicializálására használják.

A jelölő a párbeszédpanel adatérvényesítése (DDV) során sem működik.

A saját DDX- és DDV-rutinok írásáról további információt a Technical Note 26 című témakörben talál. A DDX és a DDV áttekintéséhez tekintse meg a párbeszédpanel adatcserével, ellenőrzéssel és párbeszédpanel-témakörével kapcsolatos témaköröket.

CDataExchange::m_pDlgWnd

Egy mutatót tartalmaz arra a CWnd objektumra, amelynek párbeszédpaneles adatcseréje (DDX) vagy érvényesítése (DDV) folyamatban van.

CWnd* m_pDlgWnd;

Megjegyzések

Ez az objektum általában egy CDialog objektum. Az egyéni DDX- vagy DDV-rutinok implementátorai ezzel a mutatóval hozzáférhetnek az általuk használt vezérlőket tartalmazó párbeszédpanelhez.

A saját DDX- és DDV-rutinok írásáról további információt a Technical Note 26 című témakörben talál. A DDX és a DDV áttekintéséhez tekintse meg a párbeszédpanel adatcserével, ellenőrzéssel és párbeszédpanel-témakörével kapcsolatos témaköröket.

CDataExchange::P repareCtrl

A keretrendszer meghívja ezt a tagfüggvényt, hogy előkészítse a megadott vezérlőt a párbeszédpanel-adatcsere (DDX) és az érvényesítés (DDV) számára.

HWND PrepareCtrl(int nIDC);

Paraméterek

nIDC
A DDX-hez vagy DDV-hoz előkészítendő vezérlő azonosítója.

Visszaadott érték

A DDX-hez vagy DDV-hoz előkészített vezérlő HWND-je.

Megjegyzések

Szerkesztési vezérlők helyett használja a PrepareEditCtrl parancsot ; használja ezt a tagfüggvényt az összes többi vezérlőhöz.

Az előkészítés a vezérlő HWND-jének az osztályban való CDataExchange tárolásából áll. A keretrendszer ezzel a leíróval állítja vissza a fókuszt a korábban szűrt vezérlőre DDX- vagy DDV-hiba esetén.

Az egyéni DDX- vagy DDV-rutinok implementálóinak minden olyan nem szerkesztési vezérlőt meg kell hívniuk PrepareCtrl , amelyekről DDX-en keresztül cserélnek adatokat, vagy DDV-n keresztül érvényesítik az adatokat.

A saját DDX- és DDV-rutinok írásáról további információt a Technical Note 26 című témakörben talál. A DDX és a DDV áttekintéséhez tekintse meg a párbeszédpanel adatcserével, ellenőrzéssel és párbeszédpanel-témakörével kapcsolatos témaköröket.

CDataExchange::P repareEditCtrl

A keretrendszer meghívja ezt a tagfüggvényt, hogy előkészítse a megadott szerkesztési vezérlőt a párbeszédpanel-adatcsere (DDX) és az ellenőrzés (DDV) számára.

HWND PrepareEditCtrl(int nIDC);

Paraméterek

nIDC
A DDX-hez vagy DDV-hoz előkészítendő szerkesztési vezérlő azonosítója.

Visszaadott érték

A DDX-hez vagy DDV-hoz előkészített szerkesztési vezérlő HWND-je.

Megjegyzések

Használja inkább a PrepareCtrl parancsot az összes nem szerkesztési vezérlőhöz.

Az előkészítés két dologból áll. PrepareEditCtrl Először tárolja a vezérlő HWND-jét az CDataExchange osztályban. A keretrendszer ezzel a leíróval állítja vissza a fókuszt a korábban szűrt vezérlőre DDX- vagy DDV-hiba esetén. PrepareEditCtrl Másodszor állít be egy jelölőt az CDataExchange osztályban, amely azt jelzi, hogy az a vezérlő, amelynek adatait kicserélik vagy ellenőrzik, szerkesztési vezérlő.

Az egyéni DDX- vagy DDV-rutinok implementálóinak minden olyan szerkesztési vezérlőt meg kell hívniuk PrepareEditCtrl , amelyeken DDX-en keresztül cserélnek adatokat, vagy DDV-n keresztül érvényesítik az adatokat.

A saját DDX- és DDV-rutinok írásáról további információt a Technical Note 26 című témakörben talál. A DDX és a DDV áttekintéséhez tekintse meg a párbeszédpanel adatcserével, ellenőrzéssel és párbeszédpanel-témakörével kapcsolatos témaköröket.

CDataExchange::P repareOleCtrl

A keretrendszer meghívja ezt a tagfüggvényt, hogy előkészítse a megadott OLE-vezérlőt a párbeszédpanel-adatcsere (DDX) és az érvényesítés (DDV) számára.

COleControlSite* PrepareOleCtrl(int nIDC);

Paraméterek

nIDC
A DDX-hez vagy DDV-hoz előkészítendő OLE-vezérlő azonosítója.

Visszaadott érték

Mutató az OLE vezérlőwebhelyre.

Megjegyzések

Ehelyett használja a PrepareEditCtrl parancsot szerkesztési vezérlőkhöz, vagy a PrepareCtrl parancsot az összes többi nem OLE-vezérlőhöz.

Az egyéni DDX- vagy DDV-rutinok implementálóinak minden olyan OLE-vezérlőt meg kell hívniuk PrepareOleCtrl , amelyekről DDX-en keresztül cserélnek adatokat, vagy DDV-n keresztül érvényesítik az adatokat.

A saját DDX- és DDV-rutinok írásáról további információt a Technical Note 26 című témakörben talál. A DDX és a DDV áttekintéséhez tekintse meg a párbeszédpanel adatcserével, ellenőrzéssel és párbeszédpanel-témakörével kapcsolatos témaköröket.

Lásd még

MFC minta VIEWEX
hierarchiadiagram
CWnd::D oDataExchange
CWnd::UpdateData