API UO BookClearText ja

UO.BookClearText

ClassicUO / Basic IDE

Home · API · Books

開いている編集可能な本の全ページを消去します。題名と著者は残ります。

正確な構文

UO.BookClearText() -> Unit

パラメーター

引数はありません。

戻り値

Unit：戻り値なし。書き込み要求であり、TRUE/FALSEやサーバーの完了確認ではありません。サーバーは編集を拒否できます。

動作

• 先にゲーム操作で対象の本を開いてください。最後に開いた本が対象で、ID引数はありません。複数の本がある場合は対象を確認してください。Getは受信済みデータを読み、未受信ページを要求しません。
• マネージャーは画面がなくてもセッション内に本を保持します。ゲーム画面を閉じて開き直しても本と下書きは残ります。本自体を閉じると対象から外れ、切断時にはサーバーの本が消去されます。
• 編集可能な本だけに書き込めます。不正なページや長すぎる本文は拒否されます。BookSetTextは送信前に全ページを検査するため、後のページの不備による一部だけの書き込みはありません。
• BookClearTextは全ページへ空の本文を送信し、以前の本文を消します。自分の編集可能なコピーで使用してください。題名と著者は変わりません。

内部関数：呼び出しから結果まで

サーバーはヘッダー、ページ数、本文を送信します。SessionBooksはパケット全体を検査して保存し、表示を更新します。Basicはbridge経由で最後の本を選び、SessionBookは本文を読むか、検査後に書き込みパケットを送ります。ModernBookGumpは同じデータを表示し、画面切り離し時に下書きを保持します。

1. GetOpenBook

先にゲーム操作で対象の本を開いてください。最後に開いた本が対象で、ID引数はありません。複数の本がある場合は対象を確認してください。Getは受信済みデータを読み、未受信ページを要求しません。

マネージャーは画面がなくてもセッション内に本を保持します。ゲーム画面を閉じて開き直しても本と下書きは残ります。本自体を閉じると対象から外れ、切断時にはサーバーの本が消去されます。

プロジェクトのソース: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; 関数 GetOpenBook.

2. SessionBooks.ReceiveHeader/ReceivePages; SessionBook.Yoko*

編集可能な本だけに書き込めます。不正なページや長すぎる本文は拒否されます。BookSetTextは送信前に全ページを検査するため、後のページの不備による一部だけの書き込みはありません。

Unit：戻り値なし。書き込み要求であり、TRUE/FALSEやサーバーの完了確認ではありません。サーバーは編集を拒否できます。

プロジェクトのソース: src/ClassicUO.Client/Game/Managers/SessionBooks.cs; 関数 SessionBooks.ReceiveHeader/ReceivePages; SessionBook.Yoko*.

先にゲーム操作で対象の本を開いてください。最後に開いた本が対象で、ID引数はありません。複数の本がある場合は対象を確認してください。Getは受信済みデータを読み、未受信ページを要求しません。

使用例

直接使用

# 直接使用
#
# 開いている編集可能な本の全ページを消去します。題名と著者は残ります。
#
# Unit：戻り値なし。書き込み要求であり、TRUE/FALSEやサーバーの完了確認ではありません。サーバーは編集を拒否できます。

SUB Main()
    # 対象の本が開かれ、必要なページを受信済みで、書き込み時は編集可能であることが前提です。1、2、3はページ番号です。存在を確認してください。名前と本文は例です。

    UO.BookClearText()
END SUB

パラメーターと実行の説明:

• 対象の本が開かれ、必要なページを受信済みで、書き込み時は編集可能であることが前提です。1、2、3はページ番号です。存在を確認してください。名前と本文は例です。

実用例

# 実用例
#
# 開いている編集可能な本の全ページを消去します。題名と著者は残ります。
#
# Unit：戻り値なし。書き込み要求であり、TRUE/FALSEやサーバーの完了確認ではありません。サーバーは編集を拒否できます。

SUB Main()
    # 対象の本が開かれ、必要なページを受信済みで、書き込み時は編集可能であることが前提です。1、2、3はページ番号です。存在を確認してください。名前と本文は例です。

    UO.BookClearText()
    UO.BookSetHeader("New expedition", "Alice")
    UO.BookSetPageText(1, "Bring bandages")
END SUB

パラメーターと実行の説明:

• 対象の本が開かれ、必要なページを受信済みで、書き込み時は編集可能であることが前提です。1、2、3はページ番号です。存在を確認してください。名前と本文は例です。

完全な補助関数

# 完全な補助関数
#
# 開いている編集可能な本の全ページを消去します。題名と著者は残ります。
#
# Unit：戻り値なし。書き込み要求であり、TRUE/FALSEやサーバーの完了確認ではありません。サーバーは編集を拒否できます。

SUB Main()
    # 対象の本が開かれ、必要なページを受信済みで、書き込み時は編集可能であることが前提です。1、2、3はページ番号です。存在を確認してください。名前と本文は例です。

    ResetNotebook("Supply list", "Alice", "Bandages" + Chr(10) + "Food")
END SUB

SUB ResetNotebook(title, author, firstPage)
    UO.BookClearText()
    UO.BookSetHeader(title, author)
    UO.BookSetPageText(1, firstPage)
END SUB

パラメーターと実行の説明:

• 対象の本が開かれ、必要なページを受信済みで、書き込み時は編集可能であることが前提です。1、2、3はページ番号です。存在を確認してください。名前と本文は例です。

Русский · English · Українська · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어