Ewa.SheetCollection.getItemByName(name)
**適用対象:**apps for SharePoint | Excel Services | SharePoint Server 2013
この記事の内容
戻り値
注釈
例
対象
一致する名前のEwa.Sheetを取得します。
var value = Ewa.SheetCollection.getItemByName(name);
パラメーター
name
ワークシートの表示名。
戻り値
[Type]: Ewa.Sheet
注釈
Ewa.SheetCollection.getItemByNameメソッドは、表示名を使用して、指定したシートを返します。
例
次の例では、ページにボタンを追加する方法について説明し、[、"Sheet3"] を使用してワークシートの表示名をアクティブにして、ブラウザーのステータス バーで、ワークシート名を表示する] ボタン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 activateSheetButton()
{
// Get a reference to the workbook.
var wkBook = ewa.getActiveWorkbook();
// Get the collection of named items in the workbook.
var sheets = wkBook.getSheets();
// Get the next sheet
var sheet = sheets.getItemByName('Sheet3');
// Activate the specified sheet.
// Pass in sheet as user context.
sheet.activateAsync(activateSheetCallBack, sheet);
}
function activateSheetCallBack(asyncResult)
{
// Get the activated sheet from user context.
var activatedSheet = asyncResult.getUserContext();
// Display name of activated sheet in browser status bar.
window.status = "Sheet " + activatedSheet.getName() + " was activated.";
}
</script>
<input type="button" id="ActivateSheet" value="Activate Sheet" onclick="activateSheetButton()" />