Formantów MFC ActiveX: Strony właściwości
Strony właściwości umożliwiają użytkownikowi formantu ActiveX można wyświetlać i zmieniać właściwości formantu ActiveX.Właściwości te są dostępne, wywołując okno dialogowe właściwości formantu, który zawiera jeden lub więcej stron właściwości, które zapewniają dostosowanych, graficzny interfejs do przeglądania i edytowania właściwości formantu.
Strony właściwości formantu ActiveX są wyświetlane na dwa sposoby:
Gdy zlecenie właściwości formantu (OLEIVERB_PROPERTIES) jest wywoływana, formant otwiera okno dialogowe właściwości modalny zawierający strony właściwości formantu.
Pojemnik można wyświetlać własne niemodalne okno dialogowe pokazujący stron właściwości zaznaczonego formantu.
Okno dialogowe właściwości (pokazanym na rysunku) stanowi obszar wyświetlania bieżącej strony właściwości, karty do przełączania między strony właściwości i zbiór przyciski umożliwiające wykonywanie typowych zadań, takich jak zamknąć okno dialogowe strony właściwości, anulowanie wszelkich zmian, lub natychmiastowe zastosowanie zmiany do formantu ActiveX.
Okno dialogowe właściwości
.gif "Okno dialogowe właściwości Circ3")
W tym artykule omówiono tematy związane z pomocą stron właściwości formantu ActiveX.Obejmują one:
Strona właściwości domyślnej dla formantu ActiveX wykonawczych
Dodawanie formantów do strony właściwości
Dostosowywanie funkcji DoDataExchange
Aby uzyskać więcej informacji dotyczących używania stron właściwości formantu ActiveX zobacz następujące artykuły:
Informacji na temat używania arkuszy właściwości aplikacji MFC, innych niż formant ActiveX, zobacz Arkusze właściwości (MFC).
Strona właściwości domyślne wykonawczych
Użycie Kreatora formantów ActiveX do tworzenia projektu formantu, formant pochodzące z Kreatora formantów ActiveX przewiduje domyślnej klasy strony właściwości Klasa COlePropertyPage.Początkowo strona ta jest pusta, ale każdy formant pola okna dialogowego lub zestaw formantów można dodać do niego.Ponieważ Kreator formantu ActiveX tworzy tylko jednej właściwości klasy page domyślnie dodatkowe właściwości strony klas (również pochodzące z COlePropertyPage) musi być utworzony przy użyciu widoku klasy.Aby uzyskać więcej informacji dotyczących tej procedury, zobacz Formanty ActiveX MFC: Dodawanie właściwości niestandardowe w innej strony.
Właściwość wykonawczych strony (w tym przypadku wartość domyślna) jest trzech etapów:
Aby zaimplementować strona właściwości
Dodaj COlePropertyPage-uzyskane klasy do projektu kontroli.Jeżeli projekt został utworzony za pomocą Kreatora formantu ActiveX (jak w tym przypadku), strony właściwości domyślnej klasy już istnieje.
Edytor okna dialogowego dodać żadnych formantów do szablonu strony właściwości.
Dostosowywanie DoDataExchange funkcji COlePropertyPage-klasy wymiany wartości między formantu strony właściwości i formant ActiveX.
Na przykład celów, następujące procedury Użyj prostego formantu (o nazwie "Przykład").Próbki został utworzony za pomocą Kreatora formantów ActiveX i zawiera tylko zapasów właściwości Caption.
Dodawanie formantów do strony właściwości
Aby dodać formanty do strony właściwości
Kontroli projektu otwarte Otwórz widok zasobów.
Kliknij dwukrotnie okno dialogowe ikona katalogu.
Otwórz IDD_PROPPAGE_SAMPLE okno dialogowe.
Kreator formantu ActiveX dołącza nazwę projektu do końca okna dialogowego identyfikator, w tym przypadku próbki.
Przeciągnij i upuść zaznaczony formant z przybornika na obszar pola okna dialogowego.
Na przykład tekst etykiety formantu "Caption:" i formantu pola edycji, z IDC_CAPTION identyfikator są wystarczające.
Kliknij zapisać na pasku narzędzi, aby zapisać zmiany.
Interfejs użytkownika został zmodyfikowany, należy połączyć pole Edytuj właściwość podpis.Ma to w poniższej sekcji edytując CSamplePropPage::DoDataExchange funkcji.
Dostosowywanie funkcji DoDataExchange
Strona właściwości CWnd::DoDataExchange funkcja pozwala połączyć właściwość strony wartości rzeczywiste wartości właściwości formantu.Ustanowić łącza, należy zamapować odpowiednie właściwości pól strony do ich właściwości odpowiednich kontroli.
Mapowania te są implementowane przy użyciu strony właściwości DDP_ funkcji.DDP_ funkcje działają podobnie jak DDX_ funkcje używane w standardowych MFC okien dialogowych, z jednym wyjątkiem.Oprócz odwołanie do zmiennej Członkowskie DDP_ funkcje przyjmują nazwy właściwości formantu.Oto typowy wpis w DoDataExchange funkcji dla strony właściwości.
DDP_Text(pDX, IDC_CAPTION, m_caption, _T("Caption"));
Ta funkcja kojarzy strony właściwości m_caption zmienną z podpisem, za pomocą DDP_TEXT funkcji.
Po umieszczeniu formantu strony właściwości, dodaje się, należy ustanowić powiązanie formantu strony właściwości, IDC_CAPTION, i za pomocą właściwości formantu rzeczywiste, podpis, DDP_Text działać jak opisano powyżej.
Właściwości strony (MFC)są dostępne dla innych typów kontroli okno dialogowe, takich jak pola wyboru, przyciski opcji i pola listy.W poniższej tabeli wymieniono cały zestaw właściwości strony DDP_ ich celów i funkcji:
Funkcje strony właściwości
Nazwa funkcji |
Funkcja ta umożliwia łączenie |
|---|---|
DDP_CBIndex |
Indeks zaznaczony ciąg w polu kombi z właściwości formantu. |
DDP_CBString |
Zaznaczony ciąg w polu kombi z właściwości formantu.Zaznaczony ciąg może rozpoczynać się od tej samej litery jako wartość właściwości, ale nie musi się zgadzać go całkowicie. |
DDP_CBStringExact |
Zaznaczony ciąg w polu kombi z właściwości formantu.Zaznaczony ciąg i wartość ciągu właściwości muszą być dokładnie zgodne. |
DDP_Check |
Pole wyboru z właściwości formantu. |
DDP_LBIndex |
Indeks zaznaczony ciąg w polu listy z właściwości formantu. |
DDP_LBString |
Zaznaczony ciąg w polu listy z właściwości formantu.Zaznaczony ciąg może rozpoczynać się od tej samej litery jako wartość właściwości, ale nie musi się zgadzać go całkowicie. |
DDP_LBStringExact |
Zaznaczony ciąg w polu listy z właściwości formantu.Zaznaczony ciąg i wartość ciągu właściwości muszą być dokładnie zgodne. |
DDP_Radio |
Przycisk radiowy z właściwości formantu. |
DDP_Text |
Tekst właociwooci formantu. |