ig.excel.PrintOptions

ワークシートとカスタム表示の両方で保存できるワークシートで使用可能なさまざまな印刷オプションを公開するクラス。

備考

このクラスは、ワークシートがどのように印刷されるかを制御する方法を提供します。

依存関係

jquery-1.4.4.js
infragistics.util.js
infragistics.ext_core.js
infragistics.ext_collections.js
infragistics.ext_collectionsExtended.js
infragistics.ext_io.js
infragistics.ext_text.js
infragistics.documents.core_core.js
infragistics.ext_ui.js
このコントロールにオプションはありません。
このコントロールにイベントはありません。

  • centerHorizontally

    .centerHorizontally( );
    返却型:
    boolean
    返却型の説明:
    印刷ページが水平方向にセンタリングされるかどうかを示す値。

    印刷ページが水平方向にセンタリングされるかどうかを示す値を取得します。

    関連項目

  • centerHorizontally

    .centerHorizontally( value:boolean );
    返却型:
    boolean
    返却型の説明:
    印刷ページが水平方向にセンタリングされるかどうかを示す値。

    印刷ページが水平方向にセンタリングされるかどうかを示す値を取得します。

    • value
    • タイプ:boolean

    関連項目

  • centerVertically

    .centerVertically( );
    返却型:
    boolean
    返却型の説明:
    印刷ページが垂直方向にセンタリングされるかどうかを示す値。

    印刷ページが垂直方向にセンタリングされるかどうかを示す値を取得します。

    関連項目

  • centerVertically

    .centerVertically( value:boolean );
    返却型:
    boolean
    返却型の説明:
    印刷ページが垂直方向にセンタリングされるかどうかを示す値。

    印刷ページが垂直方向にセンタリングされるかどうかを示す値を取得します。

    • value
    • タイプ:boolean

    関連項目

  • clearPageBreaks

    .clearPageBreaks( );

    PrintOptions からすべての改ページをクリアします。

    関連項目

  • columnsToRepeatAtLeft

    .columnsToRepeatAtLeft( );

    すべてのページに印刷する列の範囲を取得します。

    例外

    例外 説明
    ig.ArgumentException 指定した値が null でなく、その 値が Worksheet 内の列数以上の場合に発生します。

    関連項目

  • columnsToRepeatAtLeft

    .columnsToRepeatAtLeft( value:ig.excel.RepeatTitleRange );

    すべてのページに印刷する列の範囲を取得します。

    • value
    • タイプ:ig.excel.RepeatTitleRange

    例外

    例外 説明
    ig.ArgumentException 指定した値が null でなく、その 値が Worksheet 内の列数以上の場合に発生します。

    関連項目

  • horizontalPageBreaks

    .horizontalPageBreaks( );

    Worksheet 内の水平改ページのコレクションを取得します。

    関連項目

  • horizontalPageBreaks

    .horizontalPageBreaks( index:number );
    返却型:
    ig.excel.HorizontalPageBreak
    返却型の説明:
    PageBreak から派生したインスタンス。

    Worksheet 内の水平改ページのコレクションを取得します。

    • index
    • タイプ:number
    • 取得する改ページのインデックス。

    例外

    例外 説明
    ig.ArgumentOutOfRangeException index が 0 よりも小さいか PageBreakCollection`1.count 以上の場合に発生します。

  • insertPageBreak

    .insertPageBreak( cell:ig.excel.WorksheetCell );

    指定したセルの前に水平または垂直の改ページを挿入します。

    • cell
    • タイプ:ig.excel.WorksheetCell
    • 改ページを挿入するセル。

    例外

    例外 説明
    ig.ArgumentNullException セルが null の場合に発生します。
    ig.ArgumentException セルが Worksheet の左上隅にある場合に発生します。

    備考

    セルが PrintOptions.printAreas コレクション中のいずれかの印刷範囲に含まれていない場合、追加される改ページは次のようになります。セルが Worksheet の左上の隅にある場合、例外がスローされます。セルがワークシートの左端にある場合、水平改ページがセルの上に挿入されます。セルがワークシートの上端にある場合、垂直改ページがセルの左に挿入されます。セルがワークシートの別の場所にある場合、水平改ページがセルの上に挿入され、垂直改ページがセルの左に挿入されます。

    セルが PrintOptions.printAreas コレクション中のいずれかの印刷範囲に含まれている場合、追加される改ページは次のようになります。セルが印刷範囲の左上の隅にある場合、改ページは挿入されません。セルが印刷範囲の左端にある場合、水平改ページがセルの上に挿入されます。セルが印刷範囲の上端にある場合、垂直改ページがセルの左に挿入されます。セルが印刷範囲の別の場所にある場合、水平改ページがセルの上に挿入され、垂直改ページがセルの左に挿入されます。

    改ページが印刷範囲に挿入されるとき、印刷範囲の端までしか拡張されません。

    関連項目

  • insertPageBreak

    .insertPageBreak( column:ig.excel.WorksheetColumn );

    指定したセルの前に水平または垂直の改ページを挿入します。

    • column
    • タイプ:ig.excel.WorksheetColumn
    • 改ページを挿入する列。

    例外

    例外 説明
    ig.ArgumentNullException セルが null の場合に発生します。
    ig.ArgumentException セルが Worksheet の左上隅にある場合に発生します。

    備考

    セルが PrintOptions.printAreas コレクション中のいずれかの印刷範囲に含まれていない場合、追加される改ページは次のようになります。セルが Worksheet の左上の隅にある場合、例外がスローされます。セルがワークシートの左端にある場合、水平改ページがセルの上に挿入されます。セルがワークシートの上端にある場合、垂直改ページがセルの左に挿入されます。セルがワークシートの別の場所にある場合、水平改ページがセルの上に挿入され、垂直改ページがセルの左に挿入されます。

    セルが PrintOptions.printAreas コレクション中のいずれかの印刷範囲に含まれている場合、追加される改ページは次のようになります。セルが印刷範囲の左上の隅にある場合、改ページは挿入されません。セルが印刷範囲の左端にある場合、水平改ページがセルの上に挿入されます。セルが印刷範囲の上端にある場合、垂直改ページがセルの左に挿入されます。セルが印刷範囲の別の場所にある場合、水平改ページがセルの上に挿入され、垂直改ページがセルの左に挿入されます。

    改ページが印刷範囲に挿入されるとき、印刷範囲の端までしか拡張されません。

    関連項目

  • insertPageBreak

    .insertPageBreak( row:ig.excel.WorksheetRow );

    指定したセルの前に水平または垂直の改ページを挿入します。

    • row
    • タイプ:ig.excel.WorksheetRow
    • 改ページを挿入する行。

    例外

    例外 説明
    ig.ArgumentNullException セルが null の場合に発生します。
    ig.ArgumentException セルが Worksheet の左上隅にある場合に発生します。

    備考

    セルが PrintOptions.printAreas コレクション中のいずれかの印刷範囲に含まれていない場合、追加される改ページは次のようになります。セルが Worksheet の左上の隅にある場合、例外がスローされます。セルがワークシートの左端にある場合、水平改ページがセルの上に挿入されます。セルがワークシートの上端にある場合、垂直改ページがセルの左に挿入されます。セルがワークシートの別の場所にある場合、水平改ページがセルの上に挿入され、垂直改ページがセルの左に挿入されます。

    セルが PrintOptions.printAreas コレクション中のいずれかの印刷範囲に含まれている場合、追加される改ページは次のようになります。セルが印刷範囲の左上の隅にある場合、改ページは挿入されません。セルが印刷範囲の左端にある場合、水平改ページがセルの上に挿入されます。セルが印刷範囲の上端にある場合、垂直改ページがセルの左に挿入されます。セルが印刷範囲の別の場所にある場合、水平改ページがセルの上に挿入され、垂直改ページがセルの左に挿入されます。

    改ページが印刷範囲に挿入されるとき、印刷範囲の端までしか拡張されません。

    関連項目

  • maxPagesHorizontally

    .maxPagesHorizontally( );
    返却型:
    number
    返却型の説明:
    ワークシートを印刷するために水平方向で許可される最大ページ数。

    ワークシートを印刷するために水平方向で許可される最大ページ数を取得します。

    例外

    例外 説明
    ig.ArgumentOutOfRangeException 指定される値は、0 および 32767 の有効範囲の外です。

    備考

    ゼロの値は、水平方向で最大値が使用されないことを示します。必要に応じたページを使用します。

    注: ワークシートを印刷する方法に影響を与える MaxPagesHorizontally および PrintOptions.maxPagesVertically では、PrintOptions.scalingType は FitToPages の値に設定する必要があります。ただし、ScalingType は異なり、これらの値は使用されず、ワークシートで保存されます。

    関連項目

  • maxPagesHorizontally

    .maxPagesHorizontally( value:number );
    返却型:
    number
    返却型の説明:
    ワークシートを印刷するために水平方向で許可される最大ページ数。

    ワークシートを印刷するために水平方向で許可される最大ページ数を取得します。

    • value
    • タイプ:number

    例外

    例外 説明
    ig.ArgumentOutOfRangeException 指定される値は、0 および 32767 の有効範囲の外です。

    備考

    ゼロの値は、水平方向で最大値が使用されないことを示します。必要に応じたページを使用します。

    注: ワークシートを印刷する方法に影響を与える MaxPagesHorizontally および PrintOptions.maxPagesVertically では、PrintOptions.scalingType は FitToPages の値に設定する必要があります。ただし、ScalingType は異なり、これらの値は使用されず、ワークシートで保存されます。

    関連項目

  • maxPagesVertically

    .maxPagesVertically( );
    返却型:
    number
    返却型の説明:
    ワークシートを印刷するために垂直方向で許可される最大ページ数。

    ワークシートを印刷するために垂直方向で許可される最大ページ数を取得します。

    例外

    例外 説明
    ig.ArgumentOutOfRangeException 指定される値は、0 および 32767 の有効範囲の外です。

    備考

    ゼロの値は、垂直方向で最大値が使用されないことを示します。必要に応じたページを使用します。

    注: ワークシートを印刷する方法に影響を与える PrintOptions.maxPagesHorizontally および MaxPagesVertically では、PrintOptions.scalingType は FitToPages の値に設定する必要があります。ただし、ScalingType は異なり、これらの値は使用されず、ワークシートで保存されます。

    関連項目

  • maxPagesVertically

    .maxPagesVertically( value:number );
    返却型:
    number
    返却型の説明:
    ワークシートを印刷するために垂直方向で許可される最大ページ数。

    ワークシートを印刷するために垂直方向で許可される最大ページ数を取得します。

    • value
    • タイプ:number

    例外

    例外 説明
    ig.ArgumentOutOfRangeException 指定される値は、0 および 32767 の有効範囲の外です。

    備考

    ゼロの値は、垂直方向で最大値が使用されないことを示します。必要に応じたページを使用します。

    注: ワークシートを印刷する方法に影響を与える PrintOptions.maxPagesHorizontally および MaxPagesVertically では、PrintOptions.scalingType は FitToPages の値に設定する必要があります。ただし、ScalingType は異なり、これらの値は使用されず、ワークシートで保存されます。

    関連項目

  • pageOrder

    .pageOrder( );
    返却型:
    ig.excel.PageOrder
    返却型の説明:
    複数ページのワークシートのページ数を印刷する順序。

    複数ページのワークシートのページ数を印刷する順序を取得します。

    例外

    例外 説明
    ig.excel.InvalidEnumArgumentException 割り当てた値が PrintOptions.pageOrder 列挙体で定義されていません。

  • pageOrder

    .pageOrder( value:ig.excel.PageOrder );
    返却型:
    ig.excel.PageOrder
    返却型の説明:
    複数ページのワークシートのページ数を印刷する順序。

    複数ページのワークシートのページ数を印刷する順序を取得します。

    • value
    • タイプ:ig.excel.PageOrder

    例外

    例外 説明
    ig.excel.InvalidEnumArgumentException 割り当てた値が PrintOptions.pageOrder 列挙体で定義されていません。

  • printAreas

    .printAreas( );

    Worksheet 内の印刷範囲のコレクションを取得します。

  • printAreas

    .printAreas( index:number );
    返却型:
    ig.excel.WorksheetRegion
    返却型の説明:
    Worksheet 内の印刷範囲を表す WorksheetRegion インスタンス。

    Worksheet 内の印刷範囲のコレクションを取得します。

    • index
    • タイプ:number
    • 取得する印刷範囲のインデックス。

    例外

    例外 説明
    ig.ArgumentOutOfRangeException index が、0 よりも小さいか、コレクションのサイズ数以上の場合に発生します。

  • printGridlines

    .printGridlines( );
    返却型:
    boolean
    返却型の説明:
    ワークシートのガイドラインを印刷するかどうかを示す値。

    ワークシートのガイドラインを印刷するかどうかを示す値を取得します。

    関連項目

  • printGridlines

    .printGridlines( value:boolean );
    返却型:
    boolean
    返却型の説明:
    ワークシートのガイドラインを印刷するかどうかを示す値。

    ワークシートのガイドラインを印刷するかどうかを示す値を取得します。

    • value
    • タイプ:boolean

    関連項目

  • printRowAndColumnHeaders

    .printRowAndColumnHeaders( );
    返却型:
    boolean
    返却型の説明:
    行と列ヘッダを印刷するかどうかを示す値。

    行と列ヘッダを印刷するかどうかを示す値を取得します。

    備考

    行および列ヘッダは、行または列の識別子を表示します。

    関連項目

  • printRowAndColumnHeaders

    .printRowAndColumnHeaders( value:boolean );
    返却型:
    boolean
    返却型の説明:
    行と列ヘッダを印刷するかどうかを示す値。

    行と列ヘッダを印刷するかどうかを示す値を取得します。

    • value
    • タイプ:boolean

    備考

    行および列ヘッダは、行または列の識別子を表示します。

    関連項目

  • reset

    .reset( );

    印刷オプションをデフォルト設定にリセットします。

    備考

    各設定で使用されるデフォルトは、Microsoft Excel が空のワークブックを作成するデフォルトと同じです。

  • rowsToRepeatAtTop

    .rowsToRepeatAtTop( );

    すべてのページに印刷する行の範囲を取得します。

    例外

    例外 説明
    ig.ArgumentException 指定した値が null でなく、その 値が Worksheet 内の行数以上の場合に発生します。

    関連項目

  • rowsToRepeatAtTop

    .rowsToRepeatAtTop( value:ig.excel.RepeatTitleRange );

    すべてのページに印刷する行の範囲を取得します。

    • value
    • タイプ:ig.excel.RepeatTitleRange

    例外

    例外 説明
    ig.ArgumentException 指定した値が null でなく、その 値が Worksheet 内の行数以上の場合に発生します。

    関連項目

  • scalingFactor

    .scalingFactor( );
    返却型:
    number
    返却型の説明:
    ワークシートを印刷する時に使用するためのスケール率。

    ワークシートを印刷する時に使用するためのスケール率を取得します。

    例外

    例外 説明
    ig.ArgumentOutOfRangeException 指定される値は、10 および 400 の有効範囲の外です。

    備考

    スケール率は、通常のスケールのパーセントとして保存される拡大率と似ています。 100 の値は通常のスケールを示し、200 の値はワークシートを通常のサイズの 2 倍にスケールすることを示します。

    注: ワークシートを印刷する方法に影響を与える ScalingFactor では、PrintOptions.scalingType は UseScalingFactor の値に設定する必要があります。

    関連項目

  • scalingFactor

    .scalingFactor( value:number );
    返却型:
    number
    返却型の説明:
    ワークシートを印刷する時に使用するためのスケール率。

    ワークシートを印刷する時に使用するためのスケール率を取得します。

    • value
    • タイプ:number

    例外

    例外 説明
    ig.ArgumentOutOfRangeException 指定される値は、10 および 400 の有効範囲の外です。

    備考

    スケール率は、通常のスケールのパーセントとして保存される拡大率と似ています。 100 の値は通常のスケールを示し、200 の値はワークシートを通常のサイズの 2 倍にスケールすることを示します。

    注: ワークシートを印刷する方法に影響を与える ScalingFactor では、PrintOptions.scalingType は UseScalingFactor の値に設定する必要があります。

    関連項目

  • scalingType

    .scalingType( );
    返却型:
    ig.excel.ScalingType
    返却型の説明:
    印刷する時にワークシートをスケールするための方法。

    印刷する時にワークシートをスケールするための方法を取得します。

    例外

    例外 説明
    ig.excel.InvalidEnumArgumentException 割り当てた値が PrintOptions.scalingType 列挙体で定義されていません。

    備考

    これが UseScalingFactor の値に設定されている場合、PrintOptions.scalingFactor は印刷されるページでワークシートを統一してスケールするために使用されます。

    これが FitToPages の値に設定されている場合、PrintOptions.maxPagesHorizontally および PrintOptions.maxPagesVertically は、両方向で印刷されるワークシートを収めるために最大ページ数を設定するために使用されます。

    関連項目

  • scalingType

    .scalingType( value:ig.excel.ScalingType );
    返却型:
    ig.excel.ScalingType
    返却型の説明:
    印刷する時にワークシートをスケールするための方法。

    印刷する時にワークシートをスケールするための方法を取得します。

    • value
    • タイプ:ig.excel.ScalingType

    例外

    例外 説明
    ig.excel.InvalidEnumArgumentException 割り当てた値が PrintOptions.scalingType 列挙体で定義されていません。

    備考

    これが UseScalingFactor の値に設定されている場合、PrintOptions.scalingFactor は印刷されるページでワークシートを統一してスケールするために使用されます。

    これが FitToPages の値に設定されている場合、PrintOptions.maxPagesHorizontally および PrintOptions.maxPagesVertically は、両方向で印刷されるワークシートを収めるために最大ページ数を設定するために使用されます。

    関連項目

  • verticalPageBreaks

    .verticalPageBreaks( );

    Worksheet 内の垂直改ページのコレクションを取得します。

    関連項目

  • verticalPageBreaks

    .verticalPageBreaks( index:number );
    返却型:
    ig.excel.VerticalPageBreak
    返却型の説明:
    PageBreak から派生したインスタンス。

    Worksheet 内の垂直改ページのコレクションを取得します。

    • index
    • タイプ:number
    • 取得する改ページのインデックス。

    例外

    例外 説明
    ig.ArgumentOutOfRangeException index が 0 よりも小さいか PageBreakCollection`1.count 以上の場合に発生します。

Copyright © 1996 - 2024 Infragistics, Inc. All rights reserved.