IInvokableCommand.Invoke(Object) Metoda

Definicja

Przestrzeń nazw: Microsoft.CommandPalette.Extensions

Metoda wywoływana, gdy użytkownik wybierze polecenie.

Parametry

senderObject (obiekt nadawcy)

Reprezentuje kontekst, z którego polecenie zostało wywołane. Mogą to być różne typy w zależności od tego, gdzie polecenie jest używane:

• TopLevelCommands (i rezerwowe): sender to ICommandItem dla wywołanego polecenia najwyższego poziomu.
• IListPage.GetItems(): nadawca jest IListItem dla elementu listy wybranego dla tego polecenia.
• ICommandItem.MoreCommands (menu kontekstowe): nadawca jest albo IListItem , do którego polecenie zostało dołączone dla strony listy, albo ICommandItem polecenia najwyższego poziomu (jeśli jest to element kontekstu w poleceniu najwyższego poziomu).
• IContentPage.Commands: nadawca jest samą IContentPage .

Użycie parametru nadawcy może być przydatne w przypadku dużych list elementów, w których informacje o każdym elemencie są w pewnym sensie takie same. Jednym z przykładów może być długa lista linków. Można to zaimplementować jako pojedyncze IInvokableCommand, które otwiera adres URL na podstawie przekazanego obiektu nadawcy . Następnie każdy element listy będzie przechowywał adres URL do otwarcia i tytuł linku. Powoduje to mniejsze obciążenie dla rozszerzenia i hosta do komunikowania się.

Zwraca

Obiekt ICommandResult , który reprezentuje wynik wywołania polecenia. Ten obiekt może zawierać informacje o powodzeniu lub niepowodzeniu polecenia, a także wszelkie dodatkowe dane, które mogą być istotne dla wykonania polecenia.

Przykład

Zobacz Dodawanie polecenia , aby zapoznać się z przykładem implementowania tej metody.