DesignerActionService Klasa

Definicja

Ustanawia usługę czasu projektowania, która zarządza kolekcją DesignerActionItem obiektów dla składników.

public ref class DesignerActionService : IDisposable
public class DesignerActionService : IDisposable
type DesignerActionService = class
    interface IDisposable
Public Class DesignerActionService
Implements IDisposable
Dziedziczenie
DesignerActionService
Pochodne
Implementuje

Uwagi

Klasa DesignerActionService jest odpowiedzialna za zarządzanie kolekcją DesignerActionItem obiektów dla każdego wystąpienia składnika, który istnieje w formularzu w czasie projektowania. Ta klasa umożliwia bezpośredni model wypychania tworzenia elementów i jest przeznaczony głównie do użytku przez deweloperów narzędzi czasu projektowania, chociaż może być również używany przez deweloperów składników i niestandardowych kontrolek.

Deweloperzy narzędzi do projektowania muszą określić listę elementów do wyświetlenia dla składnika i określić, kiedy ta lista się zmieni. Mogą one również tworzyć dodatki, które działają w połączeniu z obiektami panelu tagów inteligentnych.

Zaawansowani deweloperzy składników mogą potrzebować dynamicznej kontroli elementów skojarzonych z składnikiem, zastępując lub uzupełniając standardowy model ściągania. Na przykład polecenia panelu można zmienić w zależności od kontekstu ich użycia i stanu czasu projektowania składnika.

Uwaga

Jest DesignerActionService to usługa jazdy zarówno za modelami wypychania, jak i ściągania, jednak w drugim przypadku działa niejawnie.

DesignerActionService Udostępnia prosty interfejs umożliwiający uzyskiwanie dostępu do elementów i manipulowanie nimi dla każdego składnika, w tym następujące metody i zdarzenia:

  • Metoda Contains określa, czy DesignerActionService aktualnie zarządza określonym składnikiem.

  • Metoda GetComponentActions obsługuje wyliczanie list elementów.

  • Metoda Add umożliwia dodanie elementu DesignerActionList lub DesignerActionListCollection do zestawu istniejących elementów dla wystąpienia składnika. Remove Natomiast metoda usuwa jedną lub całą listę elementów skojarzoną ze składnikiem.

    Uwaga

    Metoda Add reprezentuje bezpośredni model wypychania elementów panelu skojarzenia ze składnikiem. Natomiast model ściągania opiera się na zastępowaniu ActionLists właściwości klasy projektanta dla tego składnika. Środowisko projektowe jest odpowiedzialne za dodanie tych elementów do bieżącego DesignerActionService momentu utworzenia składnika na powierzchni projektowej.

    Ważne

    Metody Add, Remove, Containsi Clear uwzględniają tylko elementy modelu wypychania lub wpływają na nie.

  • Zdarzenie DesignerActionListsChanged wskazuje, kiedy kolekcja elementów zmieni się dla składnika.

Ponieważ często pożądane jest użycie niektórych z tych samych elementów panelu w menu skrótów czasu projektowania składnika i jego panelu, istnieje duży stopień współdziałania między DesignerActionItem obiektami i czasownikami projektanta.

Jeśli projektant składników nie określi jawnie elementu DesignerActionList (czyli nie zawiera właściwości przesłoniętej ActionLists ), zostanie utworzona lista na podstawie istniejących czasowników projektanta. Te czasowniki są określane przez Verbs właściwość . W takim przypadku wewnętrzna klasa listy czasowników jest używana do przechowywania kolekcji wpisów panelu elementów zlecenia.

Jeśli chcesz DesignerActionMethodItem , aby element był używany zarówno jako wpis panelu, jak i wpis menu skrótów w czasie projektowania, możesz ustawić includeAsDesignerVerb parametr w konstruktorze elementu.

Użyj kontrolki , DesignerActionUIService aby kontrolować wyświetlanie projektanta ActionLists.

Konstruktory

DesignerActionService(IServiceProvider)

Inicjuje nowe wystąpienie klasy DesignerActionService.

Metody

Add(IComponent, DesignerActionList)

Dodaje element DesignerActionList do bieżącej kolekcji zarządzanych tagów inteligentnych.

Add(IComponent, DesignerActionListCollection)

Dodaje element DesignerActionListCollection do bieżącej kolekcji zarządzanych tagów inteligentnych.

Clear()

Zwalnia wszystkie składniki z zarządzania i czyści wszystkie listy tagów inteligentnych modelu wypychania.

Contains(IComponent)

Określa, czy bieżąca usługa tagów inteligentnych zarządza listami akcji dla określonego składnika.

Dispose()

Zwalnia wszystkie zasoby używane przez klasę DesignerActionService .

Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element DesignerActionService i opcjonalnie zwalnia zasoby zarządzane.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetComponentActions(IComponent)

Zwraca kolekcję list elementów tagów inteligentnych skojarzonych ze składnikiem.

GetComponentActions(IComponent, ComponentActionsType)

Zwraca kolekcję list elementów tagów inteligentnych określonego typu skojarzonego z składnikiem.

GetComponentActions(IComponent, ComponentActionsType)

Zwraca kolekcję elementów akcji projektanta listy określonego typu skojarzonego z składnikiem.

GetComponentDesignerActions(IComponent, DesignerActionListCollection)

Pobiera tagi inteligentne modelu ściągania skojarzone ze składnikiem.

GetComponentServiceActions(IComponent, DesignerActionListCollection)

Pobiera tagi inteligentne modelu wypychania skojarzone ze składnikiem.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
Remove(DesignerActionList)

Usuwa określoną listę tagów inteligentnych ze wszystkich składników zarządzanych przez bieżącą usługę.

Remove(IComponent)

Usuwa wszystkie listy tagów inteligentnych skojarzonych z określonym składnikiem.

Remove(IComponent, DesignerActionList)

Usuwa określoną listę tagów inteligentnych z określonego składnika.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Zdarzenia

DesignerActionListsChanged

Występuje, gdy element DesignerActionList zostanie usunięty lub dodany dla dowolnego składnika.

Dotyczy

Zobacz też