hresult OnExecOleCmd ( const GUID * pGroup, dword nCmdID, dword nCmdExecOut, VARIANTARG * pvaIn, VARIANTARG * pvaOut );
Dönüş değeri
Döner s_ok başarılı olursa; Aksi takdirde, aşağıdaki hata kodlarından birini:
| Değer | Açıklama |
| E_UNEXPECTED | Beklenmeyen bir hata oluştu |
| E_FAIL | Hata oluştu |
| E_NOTIMPL | Mfc gösterir kendisini çevirmek ve komutu gönderme girişiminde |
| OLECMDERR_E_UNKNOWNGROUP | pGroup olmayan -null değil ama yok tanınan komut grubu |
| OLECMDERR_E_NOTSUPPORTED | nCmdID grup pGroup geçerli bir komut olarak tanınmıyor |
| OLECMDERR_DISABLED | NCmdID tarafından tanımlanan komut devre dışı bırakılır ve çalıştırılamaz |
| OLECMDERR_NOHELP | Arayan nCmdID tarafından tanımlanan komut yardım istedi ama yardım yok |
| OLECMDERR_CANCELED | Kullanıcı yürütme iptal edildi. |
Parametreleri
pGroup
Bir komut kümesi tanımlayan bir GUID için işaretçi. Varsayılan komut grubu belirtmek için boş olabilir.
nCmdID
Yürütülecek komut. PGroup tarafından tanımlanan Grup olması gerekir.
nCmdExecOut
olecmdexecopt numaralandırma komutu, bir veya daha aşağıdaki şekilde nesne bağlamını belirtir:
OLECMDEXECOPT_DODEFAULT
OLECMDEXECOPT_PROMPTUSER
OLECMDEXECOPT_DONTPROMPTUSER
OLECMDEXECOPT_SHOWHELP
pvaIn
Komut giriş değişkenlerini içeren bir VARIANTARG için işaretçi. null olabilir.
pvaOut
Çıktı almak için içinde VARIANTARG işaretçisine komuttan değerleri döndürür. null olabilir.
Açıklamalar
Bu işlev, belirtilen bir komutu çalıştırır veya komutu için yardımı görüntüler çerçevesinde aramalar.
COleCmdUI etkinleştirmek, güncelleme ve DocObject kullanıcı arabirim komutlarının diğer özelliklerini ayarlamak için kullanılır. Komutları başlatılır sonra onları OnExecOleCmd ile çalıştırabilirsiniz.
Çerçeve, çeviri ve bir ole belge komutu gönderme girişiminde bulunmadan önce işlevini çağırır. Standart ole belge komutları işlemek için bu işlevi geçersiz kılmak gerekli değildir, ancak kendi özel komutları işlemek veya parametre kabul veya sonuç komutları işlemek istiyorsanız bu işlev için geçersiz kılma sağlamalısınız.
Komutların çoğu değil bağımsız değişkenleri alır veya dönüş değerleri. Komutları bir çoğunluğu için arayan pvaIn ve pvaOutiçin nulls geçebilir. Giriş değerleri bekliyoruz komutları için arayan beyan ve VARIANTARG değişkeni başlatmak ve pvaIndeğişken bir imleç geçmek. Tek bir değer gerektiren komutlar için değişkeni doğrudan VARIANTARG içinde saklanabilir ve işleve. Birden fazla bağımsız değişken (örneğin, IDispatch ve safearray ) desteklenen türlerinden birini kullanarak VARIANTARG içinde paketlenmesi gerekir.
Komut bağımsız değişkenleri ise benzer şekilde, arayan VARIANTARGilan, vt_emptyiçin başlatmak ve adresini pvaOutiçinde geçmesi bekleniyor. Komutu tek bir değer döndürürse, nesnenin değeri doğrudan pvaOutiçinde saklayabilirsiniz. Birden çok çıkış değerleri VARIANTARG için uygun şekilde paketlenmiş olmalıdır.
Bu işlevi temel sınıf uygulaması komut hedef ile ilişkili ole_command_map yapıları yürümek ve uygun bir işleyici komutu göndermek deneyin. Temel sınıf uygulama bağımsız değişkeni kabul veya dönüş değerleri komutlarıyla çalışır. Bağımsız değişken kabul veya dönüş değerleri komutları işlemek gerekiyorsa, bu işlevi geçersiz kılmak ve kendinizi pvaIn ve pvaOut parametreleri ile çalışmak.
COleServerDoc ge&nel bakış |nbsp; Sınıf üyeleri | Hiyerarşi çizelgesi
Ayrıca bkz: COleCmdUI