setToolbarDimensionsメソッド

ツールバーは、このオプションのメソッドをコールして、barTypeパラメータで表されるツールバーの現在のディメンションを変更します。目的の画面ディメンションを使用できない場合、使用可能な最大画面スペースが割り当てられ、エラー・メッセージがツールバーに戻されます。

次の表に示す、このメソッドのパラメータ。メソッドに戻り値がありません。

パラメータ	説明
barType	変更が適用されるツールバーのタイプ。指定可能な値は次のとおりです: MAIN_HORIZONTAL、FLOAT_VERTICALまたはNOTIFICATION。
高さ	ツールバーの高さ。
幅	ツールバーの幅。このパラメータは、MAIN_HORIZONTALツールバーには適用されません。
callback	コール元ツールバーに結果を通知するためのメソッド・コールバック。

ノート:

幅および高さの属性値は、メソッドが呼び出されるツールバーに応じて制限されます。水平ツールバーの場合、高さの最大値は70ピクセルで、幅の値は無視されます。垂直ツールバーの場合、高さと幅は470ピクセル以下にする必要があります。通知ツールバーでは、高さの最大値は180ピクセルで、幅の最大値は350ピクセルです。メソッド属性に大きい値を使用すると、最大値が制限され、エラー・メッセージが返されます。

このメソッドを呼び出すサンプル・コードを次に示します。

<html>
<head>
<script type="text/javascript" src="http://domain:port/ora_support/js/mcaInteractionV1.js"> 
</script>
<script type="text/javascript">
function setHeight(newHeight) {
      svcMca.tlb.api.setToolbarDimensions("MAIN_HORIZONTAL", newHeight, 0, function (response) {
        if (response.result == 'success') {
          alert('Success! New height set!');
        } else {
          alert('Operation finished with error: ' + response.error);
        }
      });
    }</script>
</head>
<body>
<input type="button" value="Change height" onclick="setHeight(50)"/>
</body>
</html>

次の表に、レスポンス・オブジェクトのメンバー属性のリストを示します。オブジェクトに戻り値がありません。

メンバー属性	説明
result	サーバー側の実行ステータス。結果の値は成功またはエラーです。
錯誤	結果値がエラーの場合にエラー・メッセージが表示されます。そうでない場合、値は未定義です。エラー・メッセージ・コードの詳細は、エラー・メッセージを参照してください。