[Office用アプリ]選択範囲変更時のイベントを利用する。

ホーム
Office アドイン, Office関連, Office 2013
[Office用アプリ]選択範囲変更時のイベントを利用する。

2012.07.23

[Office用アプリ]選択範囲変更時のイベントを利用する。

※ この情報はOffice 2013 カスタマープレビュー版を元にしています。製品版では変更になる可能性がありますのでご注意ください。

今回はJavaScript API for Officeで用意されている選択範囲変更時のイベントを紹介します。
アプリの設定や登録方法についてはここでは説明しませんので、JavaScriptでExcel 2013用作業ウィンドウのアプリを作成する。(2)やJavaScriptでExcel 2013用作業ウィンドウのアプリを作成する。(3)をご参照ください。

・html

<!DOCTYPE html>
<html>
    <head>
        <meta charset="UTF-8">
        <meta http-equiv="X-UA-Compatible" content="IE=Edge">
        <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js"></script>
        <script src="https://az88874.vo.msecnd.net/api/1.0/office.js"></script>
        <script>
            Office.initialize = function (reason) {
                $(document).ready(function () {
                    $("#btnClear").click(function() {$("#message").html("");});
                    Office.context.document.addHandlerAsync(Office.EventType.DocumentSelectionChanged, MyHandler);
                });
            }
            
            function MyHandler(eventArgs) {
                write("Event raised: " + eventArgs.type);
                eventArgs.document.setSelectedDataAsync("Hello.");
            }
            
            function write(message) {
                $("#message").html($("#message").html() + message + "<br>");
            }
        </script>
    </head>
    <body>
        <input id="btnClear" type="button" value="Message Clear">
        <div id="message"></div>
    </body>
</html>

上記コードを設定したアプリを挿入すると、ドキュメント読み込み時にaddHandlerAsyncメソッドによってDocumentオブジェクトのSelectionChangedイベントと指定した関数が結び付けられ、選択範囲変更時に任意の関数(上記コードでは MyHandler)が呼ばれるようになります。