IVsFilterKeys2.TranslateAcceleratorEx(MSG[], UInt32, UInt32, Guid[], Guid, UInt32, Int32, Int32) Metoda

Definice

Provede zprávu Windows, přeloží ji do příkazu a volitelně spustí příkaz.Takes a Windows message, translates it into a command, and, optionally, executes the command.

public:
 int TranslateAcceleratorEx(cli::array <Microsoft::VisualStudio::OLE::Interop::MSG> ^ pMsg, System::UInt32 dwFlags, System::UInt32 cKeyBindingScopes, cli::array <Guid> ^ rgguidKeyBindingScopes, [Runtime::InteropServices::Out] Guid % pguidCmd, [Runtime::InteropServices::Out] System::UInt32 % pdwCmd, [Runtime::InteropServices::Out] int % fCmdTranslated, [Runtime::InteropServices::Out] int % pfKeyComboStartsChord);
public int TranslateAcceleratorEx (Microsoft.VisualStudio.OLE.Interop.MSG[] pMsg, uint dwFlags, uint cKeyBindingScopes, Guid[] rgguidKeyBindingScopes, out Guid pguidCmd, out uint pdwCmd, out int fCmdTranslated, out int pfKeyComboStartsChord);
abstract member TranslateAcceleratorEx : Microsoft.VisualStudio.OLE.Interop.MSG[] * uint32 * uint32 * Guid[] * Guid * uint32 * int * int -> int
Public Function TranslateAcceleratorEx (pMsg As MSG(), dwFlags As UInteger, cKeyBindingScopes As UInteger, rgguidKeyBindingScopes As Guid(), ByRef pguidCmd As Guid, ByRef pdwCmd As UInteger, ByRef fCmdTranslated As Integer, ByRef pfKeyComboStartsChord As Integer) As Integer

Parametry

pMsg
MSG[]

pro Ukazatel na zprávu systému Windows.[in] Pointer to the Windows message.

dwFlags
UInt32

pro Bitové příznaky k určení, zda se mají provést výchozí akce, provést příkaz a použít vazby klíčů.[in] Bit flags to determine whether or not to perform default actions, to execute the command, and the key bindings to use. Hodnoty vytvořené z __VSTRANSACCELEXFLAGS výčtu.Values formed from the __VSTRANSACCELEXFLAGS enumeration.

cKeyBindingScopes
UInt32

pro Počet rozsahů vazeb klíčů, které se mají kontrolovat[in] Number of key binding scopes to check. Délka rgguidKeyBindingScopes pole.Length of the rgguidKeyBindingScopes array.

rgguidKeyBindingScopes
Guid[]

pro Pole identifikátorů GUID pro rozsahy klíčů, které se mají použít, například CMDUIGUID_TextEditor pro použití současných vazeb klávesových zkratek v textovém editoru.[in] Array of GUIDs of the key binding scopes to use such as CMDUIGUID_TextEditor to use the current text editor key bindings.

pguidCmd
Guid

mimo Ukazatel na identifikátor GUID odpovídajícího příkazu.[out] Pointer to the GUID of the corresponding command.

pdwCmd
UInt32

mimo Ukazatel na identifikátor příkazu.[out] Pointer to the identifier of the command.

fCmdTranslated
Int32

mimo Datového.[out] Boolean. Nastavte na hodnotu, true Pokud se zpráva převede na příkaz.Set to true if the message will translate to a command.

pfKeyComboStartsChord
Int32

mimo Datového.[out] Boolean. Nastavte na, true Pokud je klíč začátkem CTR (multi-Key Sequence).Set to true if the key is the start of a multi-key sequence (chord).

Návraty

Int32

Pokud zpráva provede nebo převede na příkaz, vrátí metoda S_OK , vyplní parametry pguidCmd a pdwCmd s identifikátorem GUID a ID příkazu a nastaví fCmdTranslated na true .If the message does or will translate to a command, the method returns S_OK, fills the pguidCmd and pdwCmd parameters with the command's GUID and ID, and sets fCmdTranslated to true. Pokud zpráva není nebo nebude přeložena do příkazu, vrátí metoda S_FALSE , nastaví identifikátor GUID a parametry ID na nulu a nastaví fCmdTranslated na false .If the message does not or will not translate to a command, the method returns S_FALSE, sets the GUID and ID parameters to zero, and sets fCmdTranslated to false.

Poznámky

Podpis COMCOM Signature

Z vsshell80. idl:From vsshell80.idl:

HRESULT TranslateAcceleratorEx(  
  [in] LPMSG pMsg,   
  [in] VSTRANSACCELEXFLAGS dwFlags,   
  [in] DWORD cKeyBindingScopes,  
  [in, size_is(cKeyBindingScopes)] const GUID rgguidKeyBindingScopes[],  
  [out] GUID *pguidCmd,   
  [out] DWORD *pdwCmd,  
  [out] BOOL *fCmdTranslated,  
  [out] BOOL *pfKeyComboStartsChord  
);  

Poznámky pro volajícíNotes to Callers

Pokud nezadáte VSTAEXF_IgnoreActiveKBScopes , jsou aktuálně aktivní obory prohledány po těch, které jsou určeny příznaky v dwFlags.If you do not specify VSTAEXF_IgnoreActiveKBScopes, the currently active scopes are searched after those specified by the flags in dwFlags.

Platí pro