Klasa COlePropertiesDialog
Hermetyzuje okno dialogowe Właściwości wspólnego obiektu OLE systemu Windows.
class COlePropertiesDialog : public COleDialog
| Nazwa/nazwisko | opis |
|---|---|
| COlePropertiesDialog::COlePropertiesDialog | COlePropertiesDialog Tworzy obiekt. |
| Nazwa/nazwisko | opis |
|---|---|
| COlePropertiesDialog::D oModal | Wyświetla okno dialogowe i umożliwia użytkownikowi dokonanie wyboru. |
| COlePropertiesDialog::OnApplyScale | Wywoływana przez strukturę, gdy skalowanie elementu dokumentu uległo zmianie. |
| Nazwa/nazwisko | opis |
|---|---|
| COlePropertiesDialog::m_gp | Struktura używana do inicjowania strony COlePropertiesDialog "Ogólne" obiektu. |
| COlePropertiesDialog::m_lp | Struktura używana do inicjowania strony COlePropertiesDialog "Łącze" obiektu. |
| COlePropertiesDialog::m_op | Struktura używana do inicjowania COlePropertiesDialog obiektu. |
| COlePropertiesDialog::m_psh | Struktura używana do dodawania dodatkowych niestandardowych stron właściwości. |
| COlePropertiesDialog::m_vp | Struktura używana do dostosowywania strony COlePropertiesDialog "Widok" obiektu. |
Typowe okna dialogowe Właściwości obiektu OLE umożliwiają łatwe wyświetlanie i modyfikowanie właściwości elementu dokumentu OLE w sposób zgodny ze standardami systemu Windows. Te właściwości obejmują między innymi informacje o pliku reprezentowanym przez element dokumentu, opcje wyświetlania ikony i skalowania obrazu oraz informacje na temat linku elementu (jeśli element jest połączony).
Aby użyć COlePropertiesDialog obiektu, najpierw utwórz obiekt przy użyciu konstruktora COlePropertiesDialog . Po utworzeniu okna dialogowego wywołaj DoModal funkcję składową, aby wyświetlić okno dialogowe i zezwolić użytkownikowi na modyfikowanie dowolnych właściwości elementu. DoModal zwraca, czy użytkownik wybrał przycisk OK (IDOK), czy przycisk Anuluj (IDCANCEL). Oprócz przycisków OK i Anuluj istnieje przycisk Zastosuj. Gdy użytkownik wybierze pozycję Zastosuj, wszelkie zmiany wprowadzone we właściwościach elementu dokumentu zostaną zastosowane do elementu, a jego obraz zostanie automatycznie zaktualizowany, ale pozostaje aktywny.
Element członkowski danych m_psh jest wskaźnikiem PROPSHEETHEADER do struktury, a w większości przypadków nie trzeba jawnie uzyskiwać do niej dostępu. Jednym z wyjątków jest to, że potrzebujesz dodatkowych stron właściwości poza domyślnymi stronami Ogólne, Widok i Łącze. W takim przypadku można zmodyfikować m_psh element członkowski danych tak, aby zawierał strony niestandardowe przed wywołaniem funkcji składowej DoModal .
Aby uzyskać więcej informacji na temat okien dialogowych OLE, zobacz artykuł Okna dialogowe w ole.
COlePropertiesDialog
Nagłówek: afxodlgs.h
Tworzy obiekt COlePropertiesDialog.
COlePropertiesDialog(
COleClientItem* pItem,
UINT nScaleMin = 10,
UINT nScaleMax = 500,
CWnd* pParentWnd = NULL);
pItem
Wskaźnik do elementu dokumentu, którego właściwości są dostępne.
nScaleMin
Minimalny procent skalowania dla obrazu elementu dokumentu.
nScaleMax
Maksymalny procent skalowania dla obrazu elementu dokumentu.
pParentWnd
Wskaźnik do elementu nadrzędnego lub właściciela okna dialogowego.
Utwórz typową klasę okna dialogowego Właściwości obiektu OLE z COlePropertiesDialog klasy w celu zaimplementowania skalowania elementów dokumentu. Wszystkie okna dialogowe implementowane przez wystąpienie tej klasy nie będą obsługiwać skalowania elementu dokumentu.
Domyślnie wspólne właściwości obiektu OLE okno dialogowe ma trzy strony domyślne:
Ogólne
Ta strona zawiera informacje systemowe dotyczące pliku reprezentowanego przez wybrany element dokumentu. Na tej stronie użytkownik może przekonwertować wybrany element na inny typ.
Widok
Ta strona zawiera opcje wyświetlania elementu, zmieniania ikony i zmieniania skalowania obrazu.
Link
Ta strona zawiera opcje zmiany lokalizacji połączonego elementu i zaktualizowania połączonego elementu. Na tej stronie użytkownik może przerwać link wybranego elementu.
Aby dodać strony wykraczające poza te dostarczone domyślnie, zmodyfikuj zmienną składową m_psh przed zamknięciem konstruktora klasy -pochodnej COlePropertiesDialog. Jest to zaawansowana implementacja konstruktora COlePropertiesDialog .
Wywołaj tę funkcję składową, aby wyświetlić okno dialogowe Właściwości wspólnego obiektu OLE systemu Windows i zezwolić użytkownikowi na wyświetlanie i/lub zmienianie różnych właściwości elementu dokumentu.
virtual INT_PTR DoModal();
IDOK lub IDCANCEL, jeśli się powiedzie; w przeciwnym razie 0. IDOK i IDCANCEL są stałymi, które wskazują, czy użytkownik wybrał przycisk OK, czy Anuluj.
Jeśli element IDCANCEL jest zwracany, możesz wywołać funkcję Windows CommDlgExtendedError , aby określić, czy wystąpił błąd.
Struktura typu OLEUIGNRLPROPS, używana do inicjowania strony Ogólne okna dialogowego Właściwości obiektu OLE.
OLEUIGNRLPROPS m_gp;
Na tej stronie przedstawiono typ i rozmiar osadzania oraz umożliwia użytkownikowi dostęp do okna dialogowego Konwertuj. Ta strona pokazuje również miejsce docelowe łącza, jeśli obiekt jest łączem.
Aby uzyskać więcej informacji na OLEUIGNRLPROPS temat struktury, zobacz Zestaw WINDOWS SDK.
Struktura typu OLEUILINKPROPS, używana do inicjowania strony Łącze okna dialogowego Właściwości obiektu OLE.
OLEUILINKPROPS m_lp;
Ta strona pokazuje lokalizację połączonego elementu i umożliwia użytkownikowi aktualizowanie lub przerywanie linku do elementu.
Aby uzyskać więcej informacji na OLEUILINKPROPS temat struktury, zobacz Zestaw WINDOWS SDK.
Struktura typu OLEUIOBJECTPROPS, używana do inicjowania typowych właściwości obiektu OLE okno dialogowe.
OLEUIOBJECTPROPS m_op;
Ta struktura zawiera elementy członkowskie używane do inicjowania stron Ogólne, Łącze i Wyświetl.
Aby uzyskać więcej informacji, zobacz struktury OLEUIOBJECTPROPS i OLEUILINKPROPS w zestawie WINDOWS SDK.
Struktura typu PROPSHEETHEADER, której składowe przechowują cechy obiektu okna dialogowego.
PROPSHEETHEADER m_psh;
Po utworzeniu COlePropertiesDialog obiektu można użyć m_psh polecenia , aby ustawić różne aspekty okna dialogowego przed wywołaniem funkcji składowej DoModal .
Jeśli bezpośrednio zmodyfikujesz element członkowski m_psh danych, zastąpisz wszelkie domyślne zachowanie.
Aby uzyskać więcej informacji na PROPSHEETHEADER temat struktury, zobacz Zestaw WINDOWS SDK.
Struktura typu OLEUIVIEWPROPS, używana do inicjowania strony Widok okna dialogowego Właściwości obiektu OLE.
OLEUIVIEWPROPS m_vp;
Ta strona umożliwia użytkownikowi przełączanie się między widokami "content" i "kultowymi" obiektu oraz zmienianie jego skalowania w kontenerze. Umożliwia również użytkownikowi dostęp do okna dialogowego Zmień ikonę, gdy obiekt jest wyświetlany jako ikona.
Aby uzyskać więcej informacji na OLEUIVIEWPROPS temat struktury, zobacz Zestaw WINDOWS SDK.
Wywoływana przez platformę, gdy wartość skalowania uległa zmianie i wybrano przycisk OK lub Zastosuj.
virtual BOOL OnApplyScale(
COleClientItem* pItem,
int nCurrentScale,
BOOL bRelativeToOrig);
pItem
Wskaźnik do elementu dokumentu, którego właściwości są dostępne.
nCurrentScale
Wartość liczbowa skali okna dialogowego.
bRelativeToOrig
Wskazuje, czy skalowanie ma zastosowanie do oryginalnego rozmiaru elementu dokumentu.
Niezerowe, jeśli jest obsługiwane; w przeciwnym razie 0.
Domyślna implementacja nic nie robi. Aby włączyć kontrolki skalowania, należy zastąpić tę funkcję.
Uwaga
Przed wyświetleniem okna dialogowego typowych właściwości obiektu OLE struktura wywołuje tę funkcję z wartością NULL dla elementu pItem i wartością -1 dla nCurrentScale. Jest to wykonywane w celu określenia, czy kontrolki skalowania powinny być włączone.
MFC Sample CIRC
Klasa COleDialog
Wykres hierarchii
Klasa COleDialog
Klasa CPropertyPage