Ewa.Sheet.getRangeA1Async (addressA1、コールバック、ユーザー コンテキスト)

**適用対象:**apps for SharePoint | Excel Services | SharePoint Server 2013

この記事の内容
戻り値
注釈
例

入力パラメーターとしてExcel "A1"の範囲の表記法を使用して非同期で開いているブック内には、指定したEwa.Rangeを取得します。

Ewa.Sheet.getRangeA1Async(addressA1, callback, userContext);

パラメーター

addressA1

A1 表記で表示する範囲。

callback

この関数は、要求が完了したときと呼ばれます。

userContext

非同期呼び出しの状態に渡すための方法として提供されているオブジェクトです。

戻り値

None.

注釈

Ewa.Sheet.getRangeA1Asyncメソッドは、入力パラメーターの 1 つに A1 表記法を使用して非同期で範囲を取得します。たとえば A4:B9、セル A4 に開始し、セル B9 までを指定したワークシート上にあるセル範囲を指定します。

注意

シートはEwa.Sheet.getRangeA1Asyncを呼び出すシート オブジェクトと見なされますと、 addressA1の指定された文字列は、シート名を含めないでください。シート名を指定すると、 AsyncResult.getReturnValueメソッドにより、 nullが返されます。

注意

Ewa.Sheet.getRangeA1Asyncは、グラフ シート上の範囲を生成することはできません。

例

コード例を次のページにボタンとテキストの入力] ボックスを追加する方法を示します (A1 表記) の場合は、[テキスト ボックスに入力された範囲のアドレスをとるボタンonClickイベントにコードを追加し、指定した範囲をアクティブにします。コードの例をExcel Web Access Web パーツでSharePoint Server 2013で作業していることを前提としています。

<script type="text/javascript">
 
var ewa = null;
 
// Add event handler for onload event.
if (window.attachEvent) 
{ 
    window.attachEvent("onload", ewaOnPageLoad);    
} 
else 
{ 
    window.addEventListener("DOMContentLoaded", ewaOnPageLoad, false); 
}

// Add event handler for applicationReady event.
function ewaOnPageLoad() 
{ 
Ewa.EwaControl.add_applicationReady(onApplicationReady); 
} 

function onApplicationReady()
{        
    // Get a reference to the Excel Services Web Part.
    ewa = Ewa.EwaControl.getInstances().getItem(0);                                       
}              

function getRangeA1Button()
{
    // Get the A1 address entered.
    var a1Address = document.forms.aspnetForm.GetRangeAddress.value;
    
    // Call getRangeA1Async with the A1 address entered.
    ewa.getActiveWorkbook().getActiveSheet().getRangeA1Async(a1Address, getRangeA1Callback, null);    
}

function getRangeA1Callback(asyncResult)
{
    // getRangeA1Async returns a range object through the AsyncResult object.
    var range = asyncResult.getReturnValue();
    
    // Activate the range that the user entered.
    // Pass in range as user context so it can be used in callback.
    range.activateAsync(0,2,activateAsyncCallback,range);    
}

function activateAsyncCallback(asyncResult)
{
    // activateAsync does not return a range through AsyncResult so 
    // get the range from the user context passed in with activateAsync call.
    var range = asyncResult.getUserContext();
    
    // Display which address for which range was activated.
    window.status = "Range located at A1 address: " + range.getAddressA1() + " was activated.";
}

</script>
<input type="button" id="GetRange" VALUE="Get Range" onclick="getRangeA1Button()">
<input type="text" id="GetRangeAddress" value="Enter A1 Address">

関連項目

参照先

Ewa.Sheet オブジェクト