Klasa COleChangeSourceDialog
Służy do okna dialogowego Źródło zmian OLE.
Składnia
class COleChangeSourceDialog : public COleDialog
Elementy członkowskie
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
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ń:
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.