Polecenia projektanta i modelu obiektów DesignerAction formularzy systemu Windows
Projektant poleceń i modelu obiektowego DesignerAction zapewniają uogólnione sposób określić zbiór działań dla składnika w czasie projektowania.Użytkownicy następnie dostęp tych działań z powierzchni projektu zwykle klikając glifów smart tag składnika (.gif "Symbol tagu inteligentnego")
) i wybierając jedną z akcji oferowanych z panelu smart tag.Ten model ujednolica różne sposoby, Projektant może zaoferować użytkownikom poleceń.
Tagi inteligentne
Funkcja smart tag umożliwia składników i formantów, aby użytkownicy otrzymywali informacje kontekstowe i polecenia.Tag inteligentny można traktować jako zamiennik dla projektanta zlecenia, ponieważ można wybrać wyświetlić element tagu inteligentnego w panelu smart tag, a także w menu skrótów związanych z składnika lub formantu.
Pełny przykład jak można zaimplementować tagów inteligentnych, zobacz Porady: dołączanie tagów inteligentnych do składnika Windows Forms.
Projektant klasy polecenia
W poniższej tabeli opisano sposoby projektanta poleceń narażonych na użytkownik podczas projektowania składników i formanty.
Klasa |
Opis |
|---|---|
Pełnomocnik dołączony identyfikator poleceniaNie definiuje tekst polecenia, jego położenie lub inne metadane. |
|
Polecenie menu, które definiuje również jego tekst oraz inne metadane.Zlecenia są zazwyczaj oferowane na podstawie-designer i są specyficzne dla projektanta.Projektant zlecenia są zasadniczo wykazywane w menu skrótów lub na widoku menu na pasku menu głównego. |
|
Polecenie menu, która definiuje tekst i inne metadane w celu opisania ukierunkowanych działań, które mogą być wykonywane.Akcje walk zazwyczaj użytkownika za pośrednictwem niektórych przejść wieloetapowy proces, takich jak konfigurowanie źródła danych dla składnika. |
Modele ściągania i wypychania
W poniższej tabeli przedstawiono dwa modele programowy dostęp do poleceń projektanta.
Model |
Opis |
|---|---|
Push |
Projektant specjalnie żąda usług i dodaje poleceń do tej usługi. |
Replikacji ściąganej |
Projektant jest wykonywana przez usługi dla poleceń, które oferuje. |
Ujednolicanie istniejących poleceń
Istnieje wiele wspólnych wśród rodzaje poleceń wymienionych w poprzedniej tabeli Projektant polecenia klas.Interfejs API DesignerAction przynosi te razem stanowią jednolity wzór narażania poleceń, aby użytkownicy projektanta.
[!UWAGA]
Projektanci nie wszystkie obsługują wszystkie modele.Projektant może wykonywać kwerendy, jakiego rodzaju pomocy technicznej są oferowane i w odpowiedzi zmienić może, w jaki sposób oferuje poleceń.Ponadto modele ściągania i wypychania może być nieobsługiwany dla wszystkich rodzajów poleceń.Nie wszystkie projektanci narazi Projektant działań jak tagi inteligentne.Na przykład Niektórzy projektanci może narazić Projektant działań w oknie narzędzia.
Model obiektu DesignerAction
W poniższej tabeli opisano ważne klasy, które implementują modelu obiektu DesignerAction.
Klasa |
Opis |
|---|---|
Reprezentuje element panelu na panelu smart tag. |
|
Określa listę elementów, używane do tworzenia panelu smart tag. |
|
Usługa czasu projektowania, która zarządza zbierania ustanawia DesignerActionItem obiektów składników. |
|
Reprezentuje element statyczny tekst na panelu.Pochodzi z DesignerActionItem. |
|
Reprezentuje element panelu, który jest skojarzony z właściwością w klasie, pochodzące z DesignerActionList.Pochodzi z DesignerActionItem. |
|
Reprezentuje element panelu, który jest skojarzony z metody w klasie, pochodzące z DesignerActionList.Pochodzi z DesignerActionItem. |
|
Reprezentuje element statyczny nagłówka na panelu smart tag.Pochodzi z DesignerActionTextItem. |
Za pomocą modelu obiektów DesignerAction
Aby włączyć akcje projektanta dla składnika lub formantu, pochodzić od DesignerActionList klasa podstawowa.Użyj tej klasy pochodnej zapełnić panelu smart tag reprezentuje interfejs użytkownika jak menu.
Klasa pochodna może zastąpić virtualGetSortedActionItems metoda zwraca zbiór obiektów pochodzące z DesignerActionItem.Obiekty te stanowią elementy panelu.Każdy element jest wyświetlany w panelu zgodnie z jego typu.Na przykład DesignerActionTextItem jest wyświetlany jako etykieta tekst statyczny.Elementy aktywnego panelu, reprezentowana przez DesignerActionPropertyItem i DesignerActionMethodItem typy, mają odpowiednie publicznie właściwości lub metody, odpowiednio, które implementuje funkcjonalność dla tego elementu.
Po utworzeniu klasy pochodnej można dodać ją do kontroli na dwa sposoby:
Z modelu replikacji ściąganej dodaniu instancji klasy pochodne ActionLists właściwość ComponentDesigner klasy.Dzięki temu, dziedziczenie klas stanowią listę innych działań i ich elementy, które mają być scalane.
Z modelu popychania call Add dodać instancję klasy pochodne do zbierania, utrzymywane przez globalny DesignerActionService.Wykazy te działania, które zostaną scalone z tymi w kolekcji, utrzymywane przez ComponentDesigner.
A DesignerActionPropertyItem jest reprezentowana w projektancie przez odpowiednie UITypeEditor.A DesignerActionMethodItem jest reprezentowana w projektancie przez aktywny element interfejsu użytkownika, takie jak hiperłącza, który wywołuje metodę dostarczonych przez programistę.Wykonania listy akcji GetSortedActionItems metoda zwraca właściwości i metod w kolejności, powinny być wyświetlane w panelu smart tag.
Aby uzyskać pełny przykład wykonawczych tagów inteligentnych, zobacz temat Porady: dołączanie tagów inteligentnych do składnika Windows Forms.
Istniejące zlecenia na listach działania
Formanty i elementy z istniejącym DesignerVerb implementacje automatycznie otrzymywać DesignerActionList wsparcia.Środowisko projektowania kwerendy Projektant składnika listę akcji i jeżeli brak jest dostępna, jeden jest tworzony dla istniejącego zlecenia.
Elementy listy akcji, w Menu skrótów
Jeśli chcesz, element ma się pojawiać w menu skrótów i liście akcji, można określić IncludeAsDesignerVerb flagę na DesignerActionMethodItem.
Gdy Add jest nazywany działania listy jest skanowany w poszukiwaniu żadnego DesignerActionMethodItem z IncludeAsDesignerVerb flagi jest ustawiona.Jeżeli jest ustawiony, AddVerb metoda zostanie wywołana dla tego elementu, który dodać do komponentu zlecenia i dlatego jej menu skrótów.
Zmiany typów polecenia Designer
MenuCommand i DesignerVerb klasy z.NET Framework w wersji 1.1 zmieniono nieco obsługuje model obiektu DesignerAction.Oba typy narazić teraz nową właściwość o nazwie Properties, który jest IDictionary przechowujący właściwości publiczne dla obiektu polecenia.Klucz słownika jest nazwą właściwości publicznej.Umożliwia rodzajowy wyliczenie właściwości i stanowi podstawę spójny, z której można dodawać nowe właściwości bez modyfikowania definicji klasy.
Ponadto MenuCommandService klasy zapewnia standardowej implementacji IMenuCommandService i wykonuje integracji poprawne zlecenie.Ta klasa podnosi zdarzenia powiadamiania o dodań i usunięć wpisów z poleceniami.Z tej klasy można utworzyć interfejsu użytkownika, na podstawie wyników tych zdarzeń.MenuCommandService, jak również IMenuCommandService, są dostępne w kontenerze usługi.
Zobacz też
Zadania
Porady: dołączanie tagów inteligentnych do składnika Windows Forms