COleServerDoc::OnExecOleCmd

HRESULT OnExecOleCmd ( Stała GUID * pGroup, DWORD nCmdID, DWORD nCmdExecOut, VARIANTARG * pvaIn, VARIANTARG * pvaOut );

Wartość zwracany

Zwraca wartość S_OK w przypadku powodzenia; inaczej, jeden z następujących kodów błędów:

Wartość Opis
E_UNEXPECTED Wystąpił nieoczekiwany błąd
E_FAIL Wystąpił błąd
E_NOTIMPL Wskazuje MFC sam powinni próbować tłumaczenia i wysyłania polecenia
OLECMDERR_E_UNKNOWNGROUP nie pGroup -NULL ale nie określić grupę rozpoznanego polecenia
OLECMDERR_E_NOTSUPPORTED nCmdID nie został rozpoznany jako prawidłowy polecenia w grupie pGroup
OLECMDERR_DISABLED Polecenie określone przez nCmdID jest wyłączone i nie mogą być wykonywane
OLECMDERR_NOHELP Obiekt wywołujący zwrócił się o pomoc do polecenia zidentyfikowane przez nCmdID , ale nie pomoc jest dostępna
OLECMDERR_CANCELED Użytkownik anulował wykonanie

Parametry

pGroup

Wskaźnik na identyfikator GUID, który identyfikuje zestaw poleceń. Może być NULL do wskazania domyślnej grupy poleceń.

nCmdID

Polecenie do wykonania. Musi być w grupie zidentyfikowane przez pGroup.

nCmdExecOut

Sposób, w jaki obiekt należy wykonać polecenie, jedną lub więcej z następujących wartości z wyliczenia OLECMDEXECOPT:

OLECMDEXECOPT_DODEFAULT

OLECMDEXECOPT_PROMPTUSER

OLECMDEXECOPT_DONTPROMPTUSER

OLECMDEXECOPT_SHOWHELP

pvaIn

Wskaźnik VARIANTARG zawierających argumenty wejściowe polecenia. Może być NULL.

pvaOut

Wskaźnik VARIANTARG do odbierania danych wyjściowych zwracają wartości z polecenia. Może być NULL.

Uwagi

Ramach wymaga tej funkcji na wykonanie określonego polecenia lub wyświetlić pomoc dla polecenia.

COleCmdUI można włączyć, aktualizacji i inne właściwości obiektów DocObject użytkownika interfejs poleceń. Po polecenia są inicjowane, można je uruchamiać z OnExecOleCmd.

Ramach wywołuje funkcję, przed próbą ponownego tłumaczenia i wysłania polecenie Dokument OLE. Nie trzeba zastąpić tę funkcję do obsługi standardowego polecenia dokumentu OLE, lecz musi dostarczyć przesłonięcie do tej funkcji, jeśli chcesz obsłużyć własne niestandardowe polecenia lub obsługiwać poleceń, które akceptują parametrów lub zwracanie wyników.

Większość poleceń nie mieć argumentów lub zwracanych wartości. Dla większości poleceń rozmówcę można przekazać NULLs pvaIn i pvaOut. Dla poleceń, które oczekują, że wartości wejściowych obiekt wywołujący może zadeklarować i zainicjować zmienną VARIANTARG i przekazać wskaźnik do zmiennej w pvaIn. Dla poleceń, które wymagają pojedynczej wartości argument można składować bezpośrednio w VARIANTARG i przekazanych do funkcji. Wiele argumentów muszą być pakowane w VARIANTARG za pomocą jednej z obsługiwanych typów (takich jak IDispatch i SAFEARRAY ).

Podobnie jeśli polecenie zwraca argumenty wywołujący oczekuje się stwierdzenie, VARIANTARG, go zainicjować do VT_EMPTYi przekazać jej adres w pvaOut. Polecenie zwraca jedną wartość, obiekt można przechowywać w tej wartości bezpośrednio w pvaOut. Wiele wartości wyjściowych muszą być pakowane w jakiś sposób odpowiednie dla VARIANTARG.

Klasa bazowa realizacji tej funkcji będą spacer struktur OLE_COMMAND_MAP związane z docelowej polecenia i próby wysyłania polecenia do obsługi odpowiedniego. Wdrożenie klasa bazowa działa tylko w przypadku polecenia, które nie akceptują argumentów lub zwracanych wartości. Jeśli trzeba obsługiwać poleceń, które akceptują argumentów lub zwracanych wartości, muszą zastąpić tę funkcję i pracować z parametrami pvaIn i pvaOut samodzielnie.

Omówie&nie COleServerDoc |nbsp; Klasa członków | Wykres hierarchii

Zobacz też COleCmdUI

Index