Editor_RunMacro

Runs a macro. You can use this inline function or explicitly send the EE_RUN_MACRO message.

Editor_RunMacro( HWND hwnd, UINT nFlags, UINT nDefMacroLang, LPCWSTR pszMacroFile, LPCWSTR pszText, const POINT_PTR* pptOrgPos, POINT_PTR* pptCodePos, POINT_PTR* pptErrorPos, HGLOBAL* phstrResult );

Parameters

hwnd

Specifies the window handle of the view or frame of EmEditor.

nFlags

Specifies one of the following values.

RUN_FILE	pszMacroFile parameter is valid.
RUN_TEXT	pszText parameter is valid.

nDefMacroLang

Specifies a combination of the following values.

MACRO_LANG_JSCRIPT	The macro is JScript.
MACRO_LANG_V8	The macro is V8.
MACRO_LANG_VBSCRIPT	The macro is VBScript.
MACRO_LANG_UNKNOWN	The macro language is unknown.
MACRO_SYNC_ONLY	Executes the macro synchronously.

pszMacroFile

Specifies the path and file name of the macro file you want to run.

pszText

Specifies a macro text on memory that you want to run.

pptOrgPos

Specifies the original position of the macro.

pptCodePos

Specifies the code position of the macro.

pptErrorPos

Receives the error position of the macro.

phstrResult

Receives the handle to the output string that the macro returns. The caller is responsible to free this handle by using the GlobalFree function.

Return Values

The return value is one of the following values.

S_OK	Success.
S_FALSE	A macro error like a syntax error occurred.
S_EDIT_TEMP	A macro error occurred but could not open the source code to edit because the source code is not in a text file. The caller should open the source file with the cursor position set according to the information provided by the ptErrorPos parameter.
E_FAIL	A fatal error occurred.

Version

Supported on EmEditor Version 9.00 or later.