Klasa COleChangeSourceDialog

Służy do okna dialogowego Źródło zmian OLE.

Składnia

class COleChangeSourceDialog : public COleDialog

Członkowie

Konstruktory publiczne

Nazwa/nazwisko	opis
COleChangeSourceDialog::COleChangeSourceDialog	COleChangeSourceDialog Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
COleChangeSourceDialog::D oModal	Wyświetla okno dialogowe Źródło zmiany OLE.
COleChangeSourceDialog::GetDisplayName	Pobiera pełną nazwę wyświetlaną źródła.
COleChangeSourceDialog::GetFileName	Pobiera nazwę pliku z nazwy źródłowej.
COleChangeSourceDialog::GetFromPrefix	Pobiera prefiks poprzedniego źródła.
COleChangeSourceDialog::GetItemName	Pobiera nazwę elementu z nazwy źródłowej.
COleChangeSourceDialog::GetToPrefix	Pobiera prefiks nowego źródła
COleChangeSourceDialog::IsValidSource	Wskazuje, czy źródło jest prawidłowe.

Publiczne elementy członkowskie danych

Nazwa/nazwisko	opis
COleChangeSourceDialog::m_cs	Struktura, która kontroluje zachowanie okna dialogowego.

Uwagi

Utwórz obiekt klasy COleChangeSourceDialog , gdy chcesz wywołać to okno dialogowe. Po skonstruowaniu COleChangeSourceDialog obiektu można użyć struktury m_cs , aby zainicjować wartości lub stany kontrolek w oknie dialogowym. Struktura m_cs jest typu OLEUICHANGESOURCE. Aby uzyskać więcej informacji na temat korzystania z tej klasy okna dialogowego, zobacz funkcję składową DoModal .

Aby uzyskać więcej informacji, zobacz strukturę OLEUICHANGESOURCE w zestawie Windows SDK.

Aby uzyskać więcej informacji na temat okien dialogowych specyficznych dla ole, zobacz artykuł Okna dialogowe w ole.

Hierarchia dziedziczenia

Cobject

Ccmdtarget

Cwnd

Cdialog

CCommonDialog

COleDialog

COleChangeSourceDialog

Wymagania

Nagłówek: afxodlgs.h

COleChangeSourceDialog::COleChangeSourceDialog

Ta funkcja konstruuje COleChangeSourceDialog obiekt.

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

Parametry

pItem
Wskaźnik do połączonego COleClientItem , którego źródło ma zostać zaktualizowane.

pParentWnd
Wskazuje obiekt okna nadrzędnego lub właściciela (typu CWnd), do którego należy obiekt okna dialogowego. Jeśli ma wartość NULL, nadrzędne okno okna dialogowego zostanie ustawione na główne okno aplikacji.

Uwagi

Aby wyświetlić okno dialogowe, wywołaj funkcję DoModal .

Aby uzyskać więcej informacji, zobacz strukturę OLEUICHANGESOURCE i funkcję OleUIChangeSource w zestawie Windows SDK.

COleChangeSourceDialog::D oModal

Wywołaj tę funkcję, aby wyświetlić okno dialogowe Źródło zmiany OLE.

virtual INT_PTR DoModal();

Wartość zwracana

Stan ukończenia okna dialogowego. Jedna z następujących wartości:

• IDOK, jeśli okno dialogowe zostało pomyślnie wyświetlone.

• IDCANCEL, jeśli użytkownik anulował okno dialogowe.

• IDABORT, jeśli wystąpił błąd. Jeśli zwracana jest funkcja IDABORT, wywołaj funkcję składową COleDialog::GetLastError , aby uzyskać więcej informacji o typie błędu, który wystąpił. Aby uzyskać listę możliwych błędów, zobacz funkcję OleUIChangeSource w zestawie Windows SDK.

Uwagi

Jeśli chcesz zainicjować różne kontrolki okna dialogowego, ustawiając elementy członkowskie struktury m_cs , należy to zrobić przed wywołaniem DoModalmetody , ale po utworzeniu obiektu okna dialogowego.

Jeśli DoModal funkcja IDOK zwraca wartość IDOK, możesz wywołać funkcje członkowskie, aby pobrać ustawienia wprowadzone przez użytkownika lub informacje z okna dialogowego. Poniżej wymieniono typowe funkcje zapytań:

• GetFileName

• GetDisplayName

• GetItemName

COleChangeSourceDialog::GetDisplayName

Wywołaj tę funkcję, aby pobrać pełną nazwę wyświetlaną połączonego elementu klienta.

CString GetDisplayName();

Wartość zwracana

Pełna nazwa wyświetlana źródła (moniker) dla COleClientItem określonego w konstruktorze.

COleChangeSourceDialog::GetFileName

Wywołaj tę funkcję, aby pobrać część nazwy wyświetlanej nazwy pliku dla połączonego elementu klienta.

CString GetFileName();

Wartość zwracana

Fragment nazwy pliku źródłowej nazwy wyświetlanej COleClientItem określony w konstruktorze.

Uwagi

Moniker pliku wraz z monikerem elementu nadaje pełną nazwę wyświetlaną.

COleChangeSourceDialog::GetFromPrefix

Wywołaj tę funkcję, aby pobrać poprzedni ciąg prefiksu dla źródła.

CString GetFromPrefix();

Wartość zwracana

Poprzedni ciąg prefiksu źródła.

Uwagi

Wywołaj tę funkcję dopiero wtedy, gdy funkcja DoModal zwróci element IDOK.

Ta wartość pochodzi bezpośrednio z lpszFrom elementu członkowskiego struktury OLEUICHANGESOURCE .

Aby uzyskać więcej informacji, zobacz strukturę OLEUICHANGESOURCE w zestawie Windows SDK.

COleChangeSourceDialog::GetItemName

Wywołaj tę funkcję, aby pobrać część nazwy wyświetlanej nazwy elementu połączonego elementu klienta.

CString GetItemName();

Wartość zwracana

Fragment nazwy elementu źródłowej nazwy wyświetlanej obiektu COleClientItem określony w konstruktorze.

Uwagi

Moniker pliku wraz z monikerem elementu nadaje pełną nazwę wyświetlaną.

COleChangeSourceDialog::GetToPrefix

Wywołaj tę funkcję, aby uzyskać nowy ciąg prefiksu dla źródła.

CString GetToPrefix();

Wartość zwracana

Nowy ciąg prefiksu źródła.

Uwagi

Wywołaj tę funkcję dopiero wtedy, gdy funkcja DoModal zwróci element IDOK.

Ta wartość pochodzi bezpośrednio z lpszTo elementu członkowskiego struktury OLEUICHANGESOURCE .

Aby uzyskać więcej informacji, zobacz strukturę OLEUICHANGESOURCE w zestawie Windows SDK.

COleChangeSourceDialog::m_cs

Ten element członkowski danych jest strukturą typu OLEUICHANGESOURCE.

OLEUICHANGESOURCE m_cs;

Uwagi

OLEUICHANGESOURCE służy do kontrolowania zachowania okna dialogowego Źródło zmiany OLE. Elementy członkowskie tej struktury można modyfikować bezpośrednio.

Aby uzyskać więcej informacji, zobacz strukturę OLEUICHANGESOURCE w zestawie Windows SDK.

COleChangeSourceDialog::IsValidSource

Wywołaj tę funkcję, aby określić, czy nowe źródło jest prawidłowe.

BOOL IsValidSource();

Wartość zwracana

Nonzero, jeśli nowe źródło jest prawidłowe, w przeciwnym razie 0.

Uwagi

Wywołaj tę funkcję dopiero wtedy, gdy funkcja DoModal zwróci element IDOK.

Aby uzyskać więcej informacji, zobacz strukturę OLEUICHANGESOURCE w zestawie Windows SDK.

Zobacz też

Klasa COleDialog
Wykres hierarchii
Klasa COleDialog