Sdílet prostřednictvím


COleChangeSourceDialog – třída

Používá se pro dialogové okno OLE Změnit zdroj.

Syntaxe

class COleChangeSourceDialog : public COleDialog

Členové

Veřejné konstruktory

Název Popis
COleChangeSourceDialog::COleChangeSourceDialog COleChangeSourceDialog Vytvoří objekt.

Veřejné metody

Název Popis
COleChangeSourceDialog::D oModal Zobrazí dialogové okno OLE Změnit zdroj.
COleChangeSourceDialog::GetDisplayName Získá úplný zobrazovaný název zdroje.
COleChangeSourceDialog::GetFileName Získá název souboru ze zdrojového názvu.
COleChangeSourceDialog::GetFromPrefix Získá předponu předchozího zdroje.
COleChangeSourceDialog::GetItemName Získá název položky ze zdrojového názvu.
COleChangeSourceDialog::GetToPrefix Získá předponu nového zdroje.
COleChangeSourceDialog::IsValidSource Určuje, jestli je zdroj platný.

Veřejné datové členy

Název Popis
COleChangeSourceDialog::m_cs Struktura, která řídí chování dialogového okna.

Poznámky

Pokud chcete volat toto dialogové okno, vytvořte objekt třídy COleChangeSourceDialog . COleChangeSourceDialog Po vytvoření objektu můžete pomocí struktury m_cs inicializovat hodnoty nebo stavy ovládacích prvků v dialogovém okně. Struktura m_cs je typu OLEUICHANGESOURCE. Další informace o použití této třídy dialogového okna naleznete v části DoModal členské funkce.

Další informace naleznete v OLEUICHANGESOURCE struktury v sadě Windows SDK.

Další informace o dialogovýchoch

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleChangeSourceDialog

Požadavky

Hlavička: afxodlgs.h

COleChangeSourceDialog::COleChangeSourceDialog

Tato funkce vytvoří COleChangeSourceDialog objekt.

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

Parametry

pItem
Ukazatel na odkaz COleClientItem , jehož zdroj se má aktualizovat.

pParentWnd
Odkazuje na objekt okna nadřazeného nebo vlastníka (typu CWnd), do kterého objekt dialogového okna patří. Pokud je null, nadřazené okno dialogového okna bude nastaveno na hlavní okno aplikace.

Poznámky

Dialogové okno zobrazíte voláním funkce DoModal .

Další informace naleznete v oleUICHANGESOURCE struktury a OleUIChangeSource funkce v sadě Windows SDK.

COleChangeSourceDialog::D oModal

Voláním této funkce zobrazíte dialogové okno OLE Změnit zdroj.

virtual INT_PTR DoModal();

Návratová hodnota

Stav dokončení dialogového okna Jedna z následujících hodnot:

  • IdOK, pokud se dialogové okno úspěšně zobrazilo.

  • IDCANCEL pokud uživatel zrušil dialogové okno.

  • IDABORT, pokud došlo k chybě. Pokud se vrátí funkce IDABORT, zavolejte funkci člena COleDialog::GetLastError a získejte další informace o typu chyby, ke které došlo. Seznam možných chyb naleznete v oleUIChangeSource funkce v sadě Windows SDK.

Poznámky

Pokud chcete inicializovat různé ovládací prvky dialogového okna nastavením členů struktury m_cs , měli byste to udělat před voláním DoModal, ale po vytvoření objektu dialogového okna.

Pokud DoModal vrátí idOK, můžete volat členské funkce pro načtení uživatelem zadaných nastavení nebo informací z dialogového okna. Následující seznam uvádí typické funkce dotazů:

COleChangeSourceDialog::GetDisplayName

Voláním této funkce načtěte úplný zobrazovaný název propojené položky klienta.

CString GetDisplayName();

Návratová hodnota

Úplný zobrazovaný název zdroje (moniker) pro COleClientItem zadaný v konstruktoru.

COleChangeSourceDialog::GetFileName

Voláním této funkce načtěte část zobrazovaného názvu zobrazovaného názvu souboru propojené položky klienta.

CString GetFileName();

Návratová hodnota

Část souboru moniker zdrojového zobrazovaného názvu pro COleClientItem zadaný v konstruktoru.

Poznámky

Moniker souboru spolu s monikerem položky poskytuje úplný zobrazovaný název.

COleChangeSourceDialog::GetFromPrefix

Voláním této funkce získáte předchozí řetězec předpony pro zdroj.

CString GetFromPrefix();

Návratová hodnota

Předchozí řetězec předpony zdroje.

Poznámky

Volání této funkce pouze po doModal vrátí IDOK.

Tato hodnota pochází přímo ze lpszFrom členu STRUKTURY OLEUICHANGESOURCE .

Další informace naleznete v OLEUICHANGESOURCE struktury v sadě Windows SDK.

COleChangeSourceDialog::GetItemName

Voláním této funkce načtěte část moniker položky zobrazovaného názvu propojené položky klienta.

CString GetItemName();

Návratová hodnota

Část moniker položky zdrojového zobrazovaného názvu pro COleClientItem zadaný v konstruktoru.

Poznámky

Moniker souboru spolu s monikerem položky poskytuje úplný zobrazovaný název.

COleChangeSourceDialog::GetToPrefix

Voláním této funkce získáte nový řetězec předpony pro zdroj.

CString GetToPrefix();

Návratová hodnota

Nový řetězec předpony zdroje.

Poznámky

Volání této funkce pouze po doModal vrátí IDOK.

Tato hodnota pochází přímo ze lpszTo členu STRUKTURY OLEUICHANGESOURCE .

Další informace naleznete v OLEUICHANGESOURCE struktury v sadě Windows SDK.

COleChangeSourceDialog::m_cs

Tento datový člen je struktura typu OLEUICHANGESOURCE.

OLEUICHANGESOURCE m_cs;

Poznámky

OLEUICHANGESOURCE slouží k řízení chování dialogového okna OLE Změnit zdroj. Členy této struktury lze upravit přímo.

Další informace naleznete v OLEUICHANGESOURCE struktury v sadě Windows SDK.

COleChangeSourceDialog::IsValidSource

Voláním této funkce určíte, jestli je nový zdroj platný.

BOOL IsValidSource();

Návratová hodnota

Nenulové, pokud je nový zdroj platný, jinak 0.

Poznámky

Volání této funkce pouze po doModal vrátí IDOK.

Další informace naleznete v OLEUICHANGESOURCE struktury v sadě Windows SDK.

Viz také

COleDialog – třída
Graf hierarchie
COleDialog – třída