最終更新日 2024-09-25

from hmPython import *

from hmPython import の記述

ほとんどのマクロの文、マクロのキーワード、マクロの関数を、だいたいそのままで表記できるようになっています。(一部例外はあります)
文でもキーワードでも関数でも、全て関数の書き方(メソッドの書き方)になります。

from hmPython import *

message( "Hello jsmode global" );
insert( filename2() );
moveto( 10, 20 );
message( question( "y/n?" ) );

hmPython3には「秀丸のjsmodeの関数群」と同じ使用感の関数のほとんどが実装されています

from hmPython import hm

ではなく、

from hmPython import *

jsmodeとは異なるもの

Dll読み込み関連

DLL読み込み関連は、「loadDllなど、jsmode独特のDllマネージ機能」は実装されていません。
こちらについては、

秀丸マクロと同一の使用感の関数群がすべて使用できます。

COM読み込み関連

COM読み込み関連は、「createObjectなど、jsmode独特のcreateObject」は実装されていません。
こちらは、秀丸マクロと同一の使用感の関数として

のみが用意されています。

非同期関連

jsmodeの非同期関連、例えば、postExecMacroFileやpostExecMacroMemoryは実装されていません。
こちらはhmPython3での記述にはやや難がありますので、
常駐コンポーネントを作るのに適した、hm.NETや、Hm.NetCOMを利用することをオススメします。

currentjsfilename

execjsで動作するわけではないため、currentjsfilenameは機能しません。
(常にcurrentmacrofilenameと同じものを返します)

getresultex, geteventparam, getconfig, memberは、返す型を示唆する書き方

getresultex.rstr(...)、geteventparam.rstr(...)、getconfig.rnum(...)、method.rnum(...)、method.rstr(...)など、
返り値の型を「取得したいのは文字列(rstr)、あるいは数値(rnum)」と明示する必要があります。

getlinecountとenumregvalue

これらは、jsmodeとは異なり、2つの値を返します。
より自然な形で実装されています。

from hmPython import *

nLine, nColumn = getlinecount("ABCD\nXYZ",7, 0); # 最後の引数は不要なので、ダミーの0を入れておく
hm.OutputPane.Output([nLine, nColumn])
from hmPython import *

openreg("CURRENTUSER", "Software\\Hidemaruo\\Hidemaru");
i = 0;
while( 1 ):
  strVal, nRegType = enumregvalue( i, 0 ); # 最後の受け取り用の引数は不要なので、ダミーの0を入れておく
  if strVal=="":
       break;
  hm.OutputPane.Output(str(strVal) + "\t" + str(nRegType) + "\r\n");
  i = i + 1;

closereg();

一般的な文/キーワード/関数

後述の書き方が変わるものやサポートしていないもの以外は、文/キーワード/関数をそのままの名前で、パラメータ全体に()を付けるだけでメソッドとして使用可能です。
同じ名前でありながら文/キーワード/関数で用途が違うものがありますが、パラメータの指定が適切であれば()を付けるだけでいいです。
キーワードで[]で表すようなものも、()にすればできます。
文の結果コードはresult()でも取得できますが、関数の返り値としても取得できます。

from hmPython import *

a = filename2();
a = searchbuffer(); b = searchoption();
up();
a = x(); b = y();
moveto( a, b );
message( "abc" );
if selecting():
    s = gettext(seltopx(),seltopy(),selendx(),selendy()) # とにかく()を付ける       

r = question( "y/n?" ); # result()は返り値でもOK

# 同じ名前ものはパラメータが適切ならOK
a = overwrite();
overwrite( "abc" );
a = toupper( "Abc", 0x01 );
toupper(0x01);
a = filter2( "", "ToUpper", "", "Abc" );
filter2( "", "ToUpper", "" );

# []は()でOK
a = linelen2( 10 );
a = filename2( 1 );

moveto( x()+1, y() );  # OK
moveto=123;  # movetoを上書きしてしまう
moveto( x()+1, y() );  # movetoが働かなくなってしまう

()を付けずに関数名だけで書いてしまう場合、エラーにならないので注意が必要です。
同名の変数として上書きしたりすると、使用できなくなってしまうので注意が必要です。

copy; # エラーにならないので注意
copy();

moveto( x() + 1 ,y() );
x = 2; # 関数xを書き換えできてしまう
moveto( x() + 1, y() ); # x()ができなくなってしまうので注意

衝突を避ける書き方

import hmPython as hg
import hmPython as hg
hm = hg.hm;

hg.message("OK");
ret = hg.input1("あいうえお", "かきくけこ");

hm.OutputPane.Output(ret)

書き方が変わるもの

openfileやsearchdown等の予約語パラメータは、数値

openfile等の予約語パラメータはencode相当の数値になります。
searchdown等の予約語パラメータはsearchoption相当の数値になります。

getconfig、getconfigcolorでできるキーワード

getconfigでできるキーワードの多くはサポートせず、getconfigで取得します。
getconfigcolorでできるキーワードはサポートせず、getconfigcolorで取得します。
fontname()とfontsize()だけはキーワード相当でも可能です。

pythonとの関数名衝突の都合上、関数名等が変更、もしくは不要だったもの

find文はfind1()、replace文はreplace1()、escape文はescapeselect()に名前を変更しています。
print文はprint2()、ascii関数はascii2()など、いくつかの関数が変更されています。
hmPython3.pyの中身を見れば、もとの関数名はすぐにわかりますので、そちらで判断してください。

サポートしないもの

以下のものは()を付けるだけの書き換えする方法はサポートしません。

execmacro js execjs jsmode call refcall
setactivehidemaru nexthidemaru prevhidemaru nexthidemaruicon prevhidemaruicon nexttab prevtab
GREP FIND ENV

exit系、quit系

COM関係
(getobject callmethod
 callmethod_returnstr callmethod_returnnum callmethod_returnobj
 getpropstr getpropnum getpropobj setpropstr setpropnum setpropobj
 getcollection allowobjparam setcomdetachmethod)

getconfigでできるキーワード
(fontcharset boldstate width kinsokustate correctlineno linespace freecursor tabcount indentstate 
 showtab showruler tabruler linenostate pagestate formwidth
 hilightstate hilighttitle savewitheof ignoreeof backup)

getconfigcolorでできるキーワード
(tcolor bcolor lcolor ccolor rcolor rulercolor rulerbackcolor)

encodeuri decodeuri split join

DDE関係全部
return(キーワード) true(キーワード) false(キーワード)
yes no eof