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