最終更新日 2024-09-25

秀丸本体から提供されている関数

概要

秀丸本体からいくつかの関数が提供されています。
(DLL側から秀丸エディタの関数呼び出し)
「hm.NET」ではこれらはすべて「C#から使いやすい形」で提供されていますが、
hm.NET を利用しない場合は、ご自身で利用できるように整える必要があります。

[DllImport("Hidemaru.exe", CallingConvention = CallingConvention.Winapi)]

不特定多数者に配布するような丁寧に実装するライブラリであれば、
秀丸本体のファイル名や、秀丸のバージョンが特定できないため、関数を遅延ロードして関数のあるなしを判定するべきですが、
あなたがご自身のみ使用する(あるいは、小集団で秀丸のバージョンを一定以上にできるなど、状況をコントロールできる中で使用する)ならば、
「秀丸本体のファイル名は、Hidemaru.exeだし、その関数は存在する」という前提で記述しても良いでしょう。


秀丸から呼び出されるdllを作成しているわけですから、「秀丸本体(Hidemaru.exe)」は「dllがロードされているプロセスにロード済み」という前提が100%成立します。
Hidemaru.exe のファイル名を変更していない限り、そのモジュール(Hidemaru.exe)はすでにカレントプロセスにロードされているため、
秀丸本体がどのディレクトリにあるか、などは無関係にC#から普通にDllImportできます。

ClassLibrary36.cs
using System;
using System.Runtime.InteropServices;

namespace ClassLibrary36
{

    public class Class1
    {

        [DllExport]
        public static IntPtr abc(IntPtr a, IntPtr b)
        {
            int lineno = 0;
            int column = 0;

            int success = Hidemaru_GetCursorPosUnicode(out lineno, out column);
            if (success != 0)
            {
                System.Diagnostics.Trace.WriteLine(lineno.ToString(), column.ToString());
            }

            return (IntPtr)success;
        }

        [DllImport("Hidemaru.exe", CallingConvention = CallingConvention.Winapi)]
        extern static int Hidemaru_GetCursorPosUnicode(out int pnLineNo, out int pnColumn);
   }
}              

繰り返しとなりますが、使用者の秀丸のバージョンの管理が効く簡易な実装方法となります。(その分見通しが良い)

より汎用的で、不特定多数者に配布するならば、遅延ロードするべきです。
(Hidemaru.exe のファイル名が変更されていても大丈夫、関数が存在しないバージョンでもフリーズしないような作り)

.NETでのネイティブdllの遅延ロードの仕方は、一般的な話となりますので、「C# LoadLibrary GetProcAddress」などで検索してください。

HmNetCOMにP/Invokeのヒントがたくさんある

Hm.NetCOMをみれば、C#層から秀丸本体からexternされた関数のラップ方法に関するヒントを多く得られるかと思います