Share via


Klasse COleChangeSourceDialog

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Wordt gebruikt voor het dialoogvenster OLE-bron wijzigen.

Syntaxis

class COleChangeSourceDialog : public COleDialog

Leden

Openbare constructors

Naam Description
COleChangeSourceDialog::COleChangeSourceDialog Maakt een COleChangeSourceDialog object.

Openbare methoden

Naam Description
COleChangeSourceDialog::D oModal Hiermee wordt het dialoogvenster OLE-bron wijzigen weergegeven.
COleChangeSourceDialog::GetDisplayName Hiermee haalt u de volledige weergavenaam van de bron op.
COleChangeSourceDialog::GetFileName Hiermee haalt u de bestandsnaam op uit de bronnaam.
COleChangeSourceDialog::GetFromPrefix Hiermee haalt u het voorvoegsel van de vorige bron op.
COleChangeSourceDialog::GetItemName Hiermee haalt u de itemnaam op uit de bronnaam.
COleChangeSourceDialog::GetToPrefix Hiermee haalt u het voorvoegsel van de nieuwe bron op
COleChangeSourceDialog::IsValidSource Geeft aan of de bron geldig is.

Leden van openbare gegevens

Naam Description
COleChangeSourceDialog::m_cs Een structuur waarmee het gedrag van het dialoogvenster wordt bepaald.

Opmerkingen

Maak een object van klasse COleChangeSourceDialog wanneer u dit dialoogvenster wilt aanroepen. Nadat een COleChangeSourceDialog object is gemaakt, kunt u de m_cs structuur gebruiken om de waarden of statussen van besturingselementen in het dialoogvenster te initialiseren. De m_cs structuur is van het type OLEUICHANGESOURCE. Zie de functie DoModal-lid voor meer informatie over het gebruik van deze dialoogvensterklasse.

Zie de structuur OLEUICHANGESOURCE in Windows SDK voor meer informatie.

Zie het artikel Dialoogvensters in OLE voor meer informatie over OLE-specifieke dialoogvensters.

Overnamehiƫrarchie

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleChangeSourceDialog

Requirements

Koptekst: afxodlgs.h

COleChangeSourceDialog::COleChangeSourceDialog

Met deze functie wordt een COleChangeSourceDialog object samengesteld.

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

Parameterwaarden

pItem
Aanwijzer naar de gekoppelde COleClientItem waarvan de bron moet worden bijgewerkt.

pParentWnd
Verwijst naar het bovenliggende of eigenaarvensterobject (van het type CWnd) waartoe het dialoogvensterobject behoort. Als het NULL is, wordt het bovenliggende venster van het dialoogvenster ingesteld op het hoofdtoepassingsvenster.

Opmerkingen

Als u het dialoogvenster wilt weergeven, roept u de functie DoModal aan.

Zie de structuur OLEUICHANGESOURCE en de functie OleUIChangeSource in Windows SDK voor meer informatie.

COleChangeSourceDialog::D oModal

Roep deze functie aan om het dialoogvenster OLE-wijzigingsbron weer te geven.

virtual INT_PTR DoModal();

Retourwaarde

Voltooiingsstatus voor het dialoogvenster. Een van de volgende waarden:

  • IDOK als het dialoogvenster is weergegeven.

  • IDCANCEL als de gebruiker het dialoogvenster heeft geannuleerd.

  • IDABORT als er een fout is opgetreden. Als IDABORT wordt geretourneerd, roept u de functie COleDialog::GetLastError-lid aan voor meer informatie over het type fout dat is opgetreden. Zie de functie OleUIChangeSource in Windows SDK voor een overzicht van mogelijke fouten.

Opmerkingen

Als u de verschillende dialoogvensterbesturingselementen wilt initialiseren door leden van de m_cs structuur in te stellen, moet u dit doen voordat u aanroept DoModal, maar nadat het dialoogvensterobject is gemaakt.

Als DoModal IDOK wordt geretourneerd, kunt u lidfuncties aanroepen om door de gebruiker ingevoerde instellingen of informatie op te halen uit het dialoogvenster. De volgende lijst bevat typische queryfuncties:

COleChangeSourceDialog::GetDisplayName

Roep deze functie aan om de volledige weergavenaam voor het gekoppelde clientitem op te halen.

CString GetDisplayName();

Retourwaarde

De volledige weergavenaam van de bron (moniker) voor de COleClientItem die is opgegeven in de constructor.

COleChangeSourceDialog::GetFileName

Roep deze functie aan om het bestands monikergedeelte van de weergavenaam voor het gekoppelde clientitem op te halen.

CString GetFileName();

Retourwaarde

Het bestands monikergedeelte van de weergavenaam van de bron voor de COleClientItem die is opgegeven in de constructor.

Opmerkingen

De bestands moniker samen met de item moniker geeft de volledige weergavenaam.

COleChangeSourceDialog::GetFromPrefix

Roep deze functie aan om de vorige tekenreeks voor het voorvoegsel voor de bron op te halen.

CString GetFromPrefix();

Retourwaarde

De vorige voorvoegseltekenreeks van de bron.

Opmerkingen

Roep deze functie pas aan nadat DoModal IDOK retourneert.

Deze waarde komt rechtstreeks van het lpszFrom lid van de STRUCTUUR OLEUICHANGESOURCE .

Zie de structuur OLEUICHANGESOURCE in Windows SDK voor meer informatie.

COleChangeSourceDialog::GetItemName

Roep deze functie aan om het item monikergedeelte van de weergavenaam voor het gekoppelde clientitem op te halen.

CString GetItemName();

Retourwaarde

Het item monikergedeelte van de weergavenaam van de bron voor de COleClientItem die is opgegeven in de constructor.

Opmerkingen

De bestands moniker samen met de item moniker geeft de volledige weergavenaam.

COleChangeSourceDialog::GetToPrefix

Roep deze functie aan om de nieuwe voorvoegseltekenreeks voor de bron op te halen.

CString GetToPrefix();

Retourwaarde

De nieuwe voorvoegseltekenreeks van de bron.

Opmerkingen

Roep deze functie pas aan nadat DoModal IDOK retourneert.

Deze waarde komt rechtstreeks van het lpszTo lid van de STRUCTUUR OLEUICHANGESOURCE .

Zie de structuur OLEUICHANGESOURCE in Windows SDK voor meer informatie.

COleChangeSourceDialog::m_cs

Dit gegevenslid is een structuur van het type OLEUICHANGESOURCE.

OLEUICHANGESOURCE m_cs;

Opmerkingen

OLEUICHANGESOURCE wordt gebruikt om het gedrag van het dialoogvenster OLE-wijzigingsbron te bepalen. Leden van deze structuur kunnen rechtstreeks worden gewijzigd.

Zie de structuur OLEUICHANGESOURCE in Windows SDK voor meer informatie.

COleChangeSourceDialog::IsValidSource

Roep deze functie aan om te bepalen of de nieuwe bron geldig is.

BOOL IsValidSource();

Retourwaarde

Niet-nul als de nieuwe bron geldig is, anders 0.

Opmerkingen

Roep deze functie pas aan nadat DoModal IDOK retourneert.

Zie de structuur OLEUICHANGESOURCE in Windows SDK voor meer informatie.

Zie ook

Klasse COleDialog
Hiƫrarchiegrafiek
Klasse COleDialog