Klasa COlePropertiesDialog
Hermetyzuje okno dialogowe Właściwości wspólnego obiektu OLE systemu Windows.
Składnia
class COlePropertiesDialog : public COleDialog
Elementy członkowskie
Konstruktory publiczne
| Nazwa/nazwisko | opis |
|---|---|
| COlePropertiesDialog::COlePropertiesDialog | COlePropertiesDialog Tworzy obiekt. |
Metody publiczne
| 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. |
Publiczne elementy członkowskie danych
| 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. |
Uwagi
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.
Hierarchia dziedziczenia
COlePropertiesDialog
Wymagania
Nagłówek: afxodlgs.h
COlePropertiesDialog::COlePropertiesDialog
Tworzy obiekt COlePropertiesDialog.
COlePropertiesDialog(
COleClientItem* pItem,
UINT nScaleMin = 10,
UINT nScaleMax = 500,
CWnd* pParentWnd = NULL);
Parametry
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.
Uwagi
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 .
COlePropertiesDialog::D oModal
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();
Wartość zwracana
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.
COlePropertiesDialog::m_gp
Struktura typu OLEUIGNRLPROPS, używana do inicjowania strony Ogólne okna dialogowego Właściwości obiektu OLE.
OLEUIGNRLPROPS m_gp;
Uwagi
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.
COlePropertiesDialog::m_lp
Struktura typu OLEUILINKPROPS, używana do inicjowania strony Łącze okna dialogowego Właściwości obiektu OLE.
OLEUILINKPROPS m_lp;
Uwagi
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.
COlePropertiesDialog::m_op
Struktura typu OLEUIOBJECTPROPS, używana do inicjowania typowych właściwości obiektu OLE okno dialogowe.
OLEUIOBJECTPROPS m_op;
Uwagi
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.
COlePropertiesDialog::m_psh
Struktura typu PROPSHEETHEADER, której składowe przechowują cechy obiektu okna dialogowego.
PROPSHEETHEADER m_psh;
Uwagi
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.
COlePropertiesDialog::m_vp
Struktura typu OLEUIVIEWPROPS, używana do inicjowania strony Widok okna dialogowego Właściwości obiektu OLE.
OLEUIVIEWPROPS m_vp;
Uwagi
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.
COlePropertiesDialog::OnApplyScale
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);
Parametry
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.
Wartość zwracana
Niezerowe, jeśli jest obsługiwane; w przeciwnym razie 0.
Uwagi
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.
Zobacz też
MFC Sample CIRC
Klasa COleDialog
Wykres hierarchii
Klasa COleDialog
Klasa CPropertyPage