Cells
DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss はセル範囲にデータ検証ルールを追加することをサポートしています。検証ルールは以下を通じて管理されます ws.data_validations,、 DataValidationCollection 各に添付される Worksheet.

ImageRenderOptions: aspose.cells_foss

from aspose.cells_foss import (
    DataValidationType, DataValidationOperator,
    DataValidationAlertStyle, DataValidationImeMode,
    DataValidation, DataValidationCollection,
)

DataValidationType

DataValidationType は IntEnum 適用する制約のタイプを識別します。.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
NONE0検証制約なし。.
WHOLE_NUMBER1整数のみ受け付けます。.
DECIMAL2小数を受け付けます。.
LIST3ドロップダウンリストからの値を受け付けます。.
DATE4日付の値のみ受け付けます。.
TIME5時刻の値のみ受け付けます。.
TEXT_LENGTH6テキストの長さで検証します。.
CUSTOM7カスタム数式を使用して検証します。.

DataValidationOperator

DataValidationOperator は IntEnum 数値/日付/時間/長さの制約で使用される比較演算子を指定します。.

ImageRenderOptionsImageRenderOptions
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle は IntEnum 無効なデータが入力されたときに Excel の動作を制御します。.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
STOP0入力を拒否し、エラーダイアログを表示します（デフォルト）。.
WARNING1警告を表示しますが、入力は許可します。.
INFORMATION2情報メッセージを表示し、常に入力を許可します。.

DataValidationImeMode

DataValidationImeMode は IntEnum 東アジア語の入力時に IME（入力メソッドエディタ）モードを制御します。.

ImageRenderOptionsImageRenderOptions
NO_CONTROL0
OFF1
ON2
DISABLED3
HIRAGANA4
FULL_KATAKANA5
HALF_KATAKANA6
FULL_ALPHA7
HALF_ALPHA8
FULL_HANGUL9
HALF_HANGUL10

DataValidation

A DataValidation オブジェクトは単一の検証ルールとセル範囲（sqref）に適用されます。.

ImageRenderOptions 

DataValidation(sqref=None)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
sqref`strNone`

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sqrefstrこのルールのセル範囲（例:., "B2:B100").
typeDataValidationType検証タイプ（整数、少数、リスト、日付、時刻、文字数、またはカスタム）。.
operatorDataValidationOperator比較演算子は formula1 (および formula2 対象 BETWEEN/NOT_BETWEEN).
formula1str下限、リストソース（例、., '"Apple,Banana,Cherry"'),.
formula2str上限 BETWEEN および NOT_BETWEEN 演算子。.
alert_styleDataValidationAlertStyleExcel が無効な入力に対してどのように応答するか（STOP, WARNING,、または INFORMATION).
show_error_messageboolTrue 無効な入力時にエラーメッセージ ダイアログを表示する。.
error_titlestrエラーダイアログのタイトル（最大 32 文字）。.
error_messagestrエラーダイアログの本文（最大 225 文字）。.
show_input_messageboolTrue セルが選択されたときに入力プロンプト メッセージを表示する。.
input_titlestr入力プロンプトのタイトル（最大32文字）。.
input_messagestr入力プロンプトの本文（最大255文字）。.
allow_blankboolTrue エラーを発生させずに空白（空の）セルを許可するために。.
show_dropdownboolTrue リスト検証用にドロップダウン矢印を表示するために。.
ime_modeDataValidationImeMode東アジア文字入力用のIMEモード。.

ImageRenderOptions

コピー 

validation.copy() -> DataValidation

この検証ルールのディープコピーを返します。.

DataValidationCollection

DataValidationCollection は次のようにアクセスされます ws.data_validations.。ワークシート上のすべての検証ルールを管理します。.

ImageRenderOptions

追加 

ws.data_validations.add(
    sqref,
    validation_type=None,
    operator=None,
    formula1=None,
    formula2=None
) -> DataValidation

1回の呼び出しで新しい検証ルールを作成し登録します。作成された DataValidation オブジェクト。.

add_validation 

ws.data_validations.add_validation(validation: DataValidation) -> DataValidation

事前設定された DataValidation オブジェクトを登録します。同じオブジェクトを返します。.

削除 

ws.data_validations.remove(validation: DataValidation) -> bool

参照で検証ルールを削除します。戻り値は True ルールが見つかり削除された場合。.

remove_at 

ws.data_validations.remove_at(index: int)

指定されたゼロベースインデックスの検証ルールを削除します。.

remove_by_range 

ws.data_validations.remove_by_range(sqref: str) -> int

条件に該当するすべての検証を削除します sqref 指定された範囲と重複するもの。削除されたルール数を返します。.

clear 

ws.data_validations.clear()

ワークシートからすべての検証ルールを削除します。.

get_validation 

ws.data_validations.get_validation(cell_ref: str) -> DataValidation | None

指定されたセル参照（例:., "B5"）、または None 適用できるものがない場合。.

プロパティとイテレーション

ImageRenderOptionsImageRenderOptions
countこのワークシートの検証ルール数（読み取り専用）。.
disable_promptsbool — 設定は True すべての入力メッセージプロンプトをグローバルに抑制します。.
__len__()ImageRenderOptions count.
__iter__()すべてを反復処理します DataValidation オブジェクト。.
__getitem__(index)返します DataValidation ゼロベースで index.

ImageRenderOptions

ドロップダウンリストの検証 

from aspose.cells_foss import Workbook, DataValidationType, DataValidationAlertStyle

wb = Workbook()
ws = wb.worksheets[0]

# Write a label
ws.cells["A1"].put_value("Status")

# Add a dropdown list to A2:A20
dv = ws.data_validations.add(
    sqref="A2:A20",
    validation_type=DataValidationType.LIST,
    formula1='"Open,In Progress,Closed,Cancelled"',
)
dv.show_dropdown = True
dv.allow_blank = True
dv.alert_style = DataValidationAlertStyle.STOP
dv.show_error_message = True
dv.error_title = "Invalid Status"
dv.error_message = "Please select a value from the list."
dv.show_input_message = True
dv.input_title = "Status"
dv.input_message = "Choose a status from the dropdown."

wb.save("dropdown_validation.xlsx")

数値範囲の検証 

from aspose.cells_foss import (
    Workbook, DataValidationType, DataValidationOperator,
    DataValidationAlertStyle,
)

wb = Workbook()
ws = wb.worksheets[0]

ws.cells["B1"].put_value("Score (0–100)")

# Whole number between 0 and 100
dv = ws.data_validations.add(
    sqref="B2:B50",
    validation_type=DataValidationType.WHOLE_NUMBER,
    operator=DataValidationOperator.BETWEEN,
    formula1="0",
    formula2="100",
)
dv.allow_blank = False
dv.alert_style = DataValidationAlertStyle.WARNING
dv.show_error_message = True
dv.error_title = "Out of Range"
dv.error_message = "Score must be between 0 and 100."

wb.save("range_validation.xlsx")

関連項目

 日本語