Formanty MFC ActiveX: strony właściwości
Strony właściwości pozwalają użytkownikowi formantu ActiveX na przeglądanie i zmienianie właściwości formantu ActiveX.Te właściwości są dostępne przez okno dialogowe właściwości formantu, który zawiera jeden lub więcej stron właściwości, które zapewniają dostosowany interfejs graficzny służący do wyświetlania 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świetlić powoduje wyświetlenie okna dialogowego niemodalny własnej strony właściwości zaznaczonego formantu.
Okno dialogowe właściwości (pokazanym na rysunku poniżej) składa się z obszaru wyświetlania bieżącej strony właściwości, kart do przełączania między strony właściwości i zbiór przyciski umożliwiające wykonywanie typowych zadań, takich jak zamykający okno dialogowe Strona właściwości, wszelkie zmiany wprowadzone, anulowanie lub natychmiast stosowania zmian do formantu ActiveX.
Okno dialogowe właściwości
.gif "Okno dialogowe właściwości dla Circ3")
Ten artykuł obejmuje tematy związane z pomocą stron właściwości formantu ActiveX.Obejmują one:
Wykonawczych domyślną stronę właściwości dla formantu ActiveX
Dodawania 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:
Formanty MFC ActiveX: dodawanie dodatkowej niestandardowej strony właściwości
Formanty MFC ActiveX: używanie stron właściwości standardowych
Informacje na temat używania arkuszy właściwości w aplikacji MFC innych niż formant ActiveX, zobacz Arkusze właściwości (MFC).
Strona właściwości domyślne wykonawczych
Jeśli używasz Kreatora formantów ActiveX do tworzenia projektu kontroli Kreatora formantów ActiveX przewiduje klasy strona domyślna właściwość formantu pochodzące z Klasa COlePropertyPage.Początkowo ta strona właściwości jest puste, ale można dodać do niego dowolnego formantu pola dialogowe lub zestaw formantów.Ponieważ Kreatora formantów ActiveX tworzy tylko jedną właściwość strony klasy domyślnie klasy strony dodatkowe właściwości (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 MFC ActiveX: dodawanie dodatkowej niestandardowej strony właściwości.
Właściwość wykonawczych strony (w tym przypadku wartość domyślna) jest procesem trzyetapowym:
Aby zaimplementować strony właściwości
Dodaj COlePropertyPage-pochodnych klasy do projektu kontroli.Jeśli projekt został utworzony przy użyciu Kreatora formantów ActiveX (jak w tym przypadku), klasę domyślną właściwość strony już istnieje.
Umożliwia dodawanie żadnych formantów do szablonu strony właściwości edytora okien dialogowych.
Dostosowywanie DoDataExchange funkcja COlePropertyPage-klasy, wymieniać wartości między formantu strony właściwości i formant ActiveX.
Na przykład celów, następujące procedury użyć prostej kontroli (o nazwie "Test").Próbki został utworzony za pomocą Kreatora formantów ActiveX i zawiera tylko podstawowy Właściwość Caption.
Dodawania formantów do strony właściwości
Aby dodać formanty do strony właściwości
Otwieranie projektu kontroli 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 na końcu identyfikatora okno dialogowe, w tym przypadku próbki.
Przeciągnij i upuść zaznaczony formant z przybornika na obszarze pole dialogowe.
W tym przykładzie tekst etykiety formantu "podpis:" i formantu pola edycji, z IDC_CAPTION identyfikator są wystarczające.
Kliknij przycisk zapisać na pasku narzędzi, aby zapisać zmiany.
Teraz, gdy interfejs użytkownika został zmodyfikowany, musisz połączyć pola edycji za pomocą właściwości podpisu.To jest wykonywane w poniższej sekcji przez edycję CSamplePropPage::DoDataExchange funkcji.
Dostosowywanie funkcji DoDataExchange
Strony właściwości CWnd::DoDataExchange funkcja umożliwia połączenie wartości właściwości strony z rzeczywistych wartości właściwości w formancie.Do ustanowienia powiązań, należy zamapować odpowiedniej 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 standardowe okna dialogowe MFC, z jednym wyjątkiem.Oprócz odwołanie do zmiennej Państwa DDP_ funkcje podjąć nazwa właściwości formantu.Oto typowy wpis w DoDataExchange funkcja ze stroną właściwości.
DDP_Text(pDX, IDC_CAPTION, m_caption, _T("Caption"));
Funkcja ta kojarzy strony właściwości m_caption zmienną z podpisem, za pomocą DDP_TEXT funkcji.
Po umieszczeniu formantu strony właściwości wstawiony, należy ustanowić powiązanie formantu strony właściwości IDC_CAPTION, i za pomocą właściwości rzeczywistą kontrolę, podpis, DDP_Text działać, jak opisano powyżej.
Strony właściwości (MFC)są dostępne dla innych typów kontroli okno, takie jak pola wyboru, przyciski opcji i pola list.W poniższej tabeli wymieniono cały zbiór właściwości strony DDP_ funkcje i ich celów:
Funkcje strony właściwości
Nazwa funkcji |
Funkcja ta umożliwia łączenie |
|---|---|
DDP_CBIndex |
Indeks ciągu zaznaczonego 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 tych samych liter jako wartość właściwości, ale nie musi pasować 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 musi dokładnie odpowiadać. |
DDP_Check |
Pole wyboru z właściwością formantu. |
DDP_LBIndex |
Indeks ciągu zaznaczonego 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 tych samych liter jako wartość właściwości, ale nie musi pasować 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 musi dokładnie odpowiadać. |
DDP_Radio |
Przycisk radiowy z właściwością formantu. |
DDP_Text |
Tekst właociwooci formantu. |