COleChangeSourceDialog 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.

Az OLE Change Source (Forrás módosítása) párbeszédpanelhez használható.

Szemantika

class COleChangeSourceDialog : public COleDialog

Tagok

Nyilvános konstruktorok

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

Nyilvános metódusok

Név	Description
COleChangeSourceDialog::D oModal	Megjeleníti az OLE Change Source (Forrás módosítása) párbeszédpanelt.
COleChangeSourceDialog::GetDisplayName	Lekéri a teljes forrásmegjelenítési nevet.
COleChangeSourceDialog::GetFileName	Lekéri a fájlnevet a forrásnévből.
COleChangeSourceDialog::GetFromPrefix	Lekéri az előző forrás előtagját.
COleChangeSourceDialog::GetItemName	Lekéri az elem nevét a forrásnévből.
COleChangeSourceDialog::GetToPrefix	Lekéri az új forrás előtagját
COleChangeSourceDialog::IsValidSource	Azt jelzi, hogy a forrás érvényes-e.

Nyilvános adatok tagjai

Név	Description
COleChangeSourceDialog::m_cs	A párbeszédpanel viselkedését vezérlő struktúra.

Megjegyzések

Hozzon létre egy osztályobjektumot COleChangeSourceDialog , amikor meg szeretné hívni ezt a párbeszédpanelt. Az COleChangeSourceDialog objektum létrehozása után a m_cs szerkezettel inicializálhatja a párbeszédpanel vezérlőinek értékeit vagy állapotát. A m_cs struktúra OLEUICHANGESOURCE típusú. A párbeszédpanel-osztály használatáról további információt a DoModal tagfüggvényben talál.

További információ: OLEUICHANGESOURCE struktúra a Windows SDK-ban.

Az OLE-specifikus párbeszédpanelekről további információt az OLE párbeszédpanelek című cikkben talál.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleChangeSourceDialog

Requirements

Fejléc: afxodlgs.h

COleChangeSourceDialog::COleChangeSourceDialog

Ez a függvény létrehoz egy objektumot COleChangeSourceDialog .

explicit COleChangeSourceDialog(
    COleClientItem* pItem,
    CWnd* pParentWnd = NULL);

Paraméterek

pItem
Mutasson arra a csatolt COleClientItemre , amelynek forrását frissíteni szeretné.

pParentWnd
Arra a szülő- vagy tulajdonosablak-objektumra mutat (típus CWnd), amelyhez a párbeszédpanel-objektum tartozik. Null érték esetén a párbeszédpanel szülőablaka a fő alkalmazásablakra lesz beállítva.

Megjegyzések

A párbeszédpanel megjelenítéséhez hívja meg a DoModal függvényt.

További információ: OLEUICHANGESOURCE struktúra és OleUIChangeSource függvény a Windows SDK-ban.

COleChangeSourceDialog::D oModal

Hívja meg ezt a függvényt az OLE-forrás módosítása párbeszédpanel megjelenítéséhez.

virtual INT_PTR DoModal();

Visszaadott érték

A párbeszédpanel befejezési állapota. Az alábbi értékek egyike:

• IDOK, ha a párbeszédpanel sikeresen megjelent.

• IDCANCEL, ha a felhasználó megszakította a párbeszédpanelt.

• IDABORT, ha hiba történt. Ha IDABORT-t ad vissza, hívja meg a COleDialog::GetLastError tagfüggvényt, hogy további információt kapjon a hiba típusáról. A lehetséges hibák listáját a Windows SDK OleUIChangeSource függvényében talál.

Megjegyzések

Ha a m_cs szerkezet tagjainak beállításával szeretné inicializálni a különböző párbeszédpanel-vezérlőket, ezt a hívás DoModalelőtt, de a párbeszédpanel-objektum létrehozása után kell elvégeznie.

Ha DoModal IDOK-t ad vissza, meghívhatja a tagfüggvényeket, hogy lekérje a felhasználó által megadott beállításokat vagy információkat a párbeszédpanelről. A következő lista a tipikus lekérdezési függvényeket sorolja fel:

• GetFileName

• GetDisplayName

• GetItemName

COleChangeSourceDialog::GetDisplayName

Hívja meg ezt a függvényt a csatolt ügyfélelem teljes megjelenítendő nevének lekéréséhez.

CString GetDisplayName();

Visszaadott érték

A konstruktorban megadott COleClientItem teljes forrásmegjelenítő neve (moniker).

COleChangeSourceDialog::GetFileName

Hívja meg ezt a függvényt a csatolt ügyfélelem megjelenítendő nevének fájlnévrészének lekéréséhez.

CString GetFileName();

Visszaadott érték

A konstruktorban megadott COleClientItem forrásmegjelenítési nevének fájl moniker része.

Megjegyzések

A fájl moniker és az elem moniker adja a teljes megjelenítendő nevet.

COleChangeSourceDialog::GetFromPrefix

Hívja meg ezt a függvényt a forrás előző előtag-sztringjének lekéréséhez.

CString GetFromPrefix();

Visszaadott érték

A forrás előző előtag-sztringje.

Megjegyzések

Ezt a függvényt csak akkor hívja meg, ha a DoModal visszaadja az IDOK-ot.

Ez az érték közvetlenül az lpszFromOLEUICHANGESOURCE-struktúra tagjától származik.

További információ: OLEUICHANGESOURCE struktúra a Windows SDK-ban.

COleChangeSourceDialog::GetItemName

Hívja meg ezt a függvényt a csatolt ügyfélelem megjelenítendő nevének elem-moniker részének lekéréséhez.

CString GetItemName();

Visszaadott érték

A konstruktorban megadott COleClientItem forrásmegjelenítési nevének elem-moniker része.

Megjegyzések

A fájl moniker és az elem moniker adja a teljes megjelenítendő nevet.

COleChangeSourceDialog::GetToPrefix

Hívja meg ezt a függvényt a forrás új előtag-sztringjének lekéréséhez.

CString GetToPrefix();

Visszaadott érték

A forrás új előtag-sztringje.

Megjegyzések

Ezt a függvényt csak akkor hívja meg, ha a DoModal visszaadja az IDOK-ot.

Ez az érték közvetlenül az lpszToOLEUICHANGESOURCE-struktúra tagjától származik.

További információ: OLEUICHANGESOURCE struktúra a Windows SDK-ban.

COleChangeSourceDialog::m_cs

Ez az adattag egy OLEUICHANGESOURCE típusú struktúra.

OLEUICHANGESOURCE m_cs;

Megjegyzések

OLEUICHANGESOURCE az OLE-változási forrás párbeszédpanel viselkedésének szabályozására szolgál. A struktúra tagjai közvetlenül módosíthatók.

További információ: OLEUICHANGESOURCE struktúra a Windows SDK-ban.

COleChangeSourceDialog::IsValidSource

Hívja meg ezt a függvényt annak megállapításához, hogy az új forrás érvényes-e.

BOOL IsValidSource();

Visszaadott érték

Érvénytelen, ha az új forrás érvényes, ellenkező esetben 0.

Megjegyzések

Ezt a függvényt csak akkor hívja meg, ha a DoModal visszaadja az IDOK-ot.

További információ: OLEUICHANGESOURCE struktúra a Windows SDK-ban.

Lásd még

COleDialog osztály
hierarchiadiagram
COleDialog osztály