Skip to content

API UO BookClearText de

Codex edited this page Sep 23, 2026 · 1 revision

UO.BookClearText

ClassicUO / Basic IDE

Home · API · Books

Leert alle Seiten des geöffneten bearbeitbaren Buchs; Titel und Autor bleiben erhalten.

Genaue Syntax

UO.BookClearText() -> Unit

Parameter

Keine Parameter.

Rückgabewert

Unit: kein Rückgabewert. Dies fordert eine Änderung an, liefert weder TRUE/FALSE noch eine Serverbestätigung. Der Server kann sie ablehnen.

Verhalten

  • Zuerst das gewünschte Buch im Spiel öffnen. Verwendet wird das zuletzt geöffnete Buch, ohne ID-Argument. Bei mehreren Büchern die Auswahl prüfen. Get liest geladene Daten und fordert fehlende Seiten nicht an.
  • Der Manager speichert Bücher auch ohne Grafik im Sitzungszustand. Schließen und Öffnen der Spielansicht erhält Buch und Entwurf. Schließen des Buchs selbst entfernt es; eine Trennung löscht Serverbücher.
  • Nur bearbeitbare Bücher erlauben Änderungen. Ungültige Seiten und zu langer Text werden abgelehnt. BookSetText prüft alle Seiten vor dem Senden und schreibt bei einem späteren Fehler nicht teilweise.
  • BookClearText sendet leeren Text für jede Seite und löscht den bisherigen Inhalt. Eine eigene bearbeitbare Kopie verwenden. Titel und Autor bleiben.

Interne Funktionen: vom Aufruf zum Ergebnis

Der Server liefert Kopf, Seitenzahl und Inhalt. SessionBooks prüft vollständige Pakete, speichert Daten und aktualisiert die Ansicht. Basic wählt über die Bridge das letzte Buch; SessionBook liest Zeilen oder prüft und sendet Änderungen. ModernBookGump zeigt dieselben Daten und erhält Entwürfe beim Trennen der Grafik.

1. GetOpenBook

Zuerst das gewünschte Buch im Spiel öffnen. Verwendet wird das zuletzt geöffnete Buch, ohne ID-Argument. Bei mehreren Büchern die Auswahl prüfen. Get liest geladene Daten und fordert fehlende Seiten nicht an.

Der Manager speichert Bücher auch ohne Grafik im Sitzungszustand. Schließen und Öffnen der Spielansicht erhält Buch und Entwurf. Schließen des Buchs selbst entfernt es; eine Trennung löscht Serverbücher.

Projektquelle: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; Funktion GetOpenBook.

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

Nur bearbeitbare Bücher erlauben Änderungen. Ungültige Seiten und zu langer Text werden abgelehnt. BookSetText prüft alle Seiten vor dem Senden und schreibt bei einem späteren Fehler nicht teilweise.

Unit: kein Rückgabewert. Dies fordert eine Änderung an, liefert weder TRUE/FALSE noch eine Serverbestätigung. Der Server kann sie ablehnen.

Projektquelle: src/ClassicUO.Client/Game/Managers/SessionBooks.cs; Funktion SessionBooks.ReceiveHeader/ReceivePages; SessionBook.Yoko*.

Zuerst das gewünschte Buch im Spiel öffnen. Verwendet wird das zuletzt geöffnete Buch, ohne ID-Argument. Bei mehreren Büchern die Auswahl prüfen. Get liest geladene Daten und fordert fehlende Seiten nicht an.

Beispiele

Direkter Aufruf

# Direkter Aufruf
#
# Leert alle Seiten des geöffneten bearbeitbaren Buchs; Titel und Autor bleiben erhalten.
#
# Unit: kein Rückgabewert. Dies fordert eine Änderung an, liefert weder TRUE/FALSE noch eine
# Serverbestätigung. Der Server kann sie ablehnen.

SUB Main()
    # Das gewünschte Buch muss offen sein, die benötigten Seiten geladen und für Änderungen
    # bearbeitbar. 1, 2 und 3 sind Seitennummern; ihre Existenz prüfen. Namen und Text sind
    # Beispiele.

    UO.BookClearText()
END SUB

Erläuterung der Parameter und Ausführung:

  • Das gewünschte Buch muss offen sein, die benötigten Seiten geladen und für Änderungen bearbeitbar. 1, 2 und 3 sind Seitennummern; ihre Existenz prüfen. Namen und Text sind Beispiele.

Praktisches Beispiel

# Praktisches Beispiel
#
# Leert alle Seiten des geöffneten bearbeitbaren Buchs; Titel und Autor bleiben erhalten.
#
# Unit: kein Rückgabewert. Dies fordert eine Änderung an, liefert weder TRUE/FALSE noch eine
# Serverbestätigung. Der Server kann sie ablehnen.

SUB Main()
    # Das gewünschte Buch muss offen sein, die benötigten Seiten geladen und für Änderungen
    # bearbeitbar. 1, 2 und 3 sind Seitennummern; ihre Existenz prüfen. Namen und Text sind
    # Beispiele.

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

Erläuterung der Parameter und Ausführung:

  • Das gewünschte Buch muss offen sein, die benötigten Seiten geladen und für Änderungen bearbeitbar. 1, 2 und 3 sind Seitennummern; ihre Existenz prüfen. Namen und Text sind Beispiele.

Vollständige Hilfsfunktion

# Vollständige Hilfsfunktion
#
# Leert alle Seiten des geöffneten bearbeitbaren Buchs; Titel und Autor bleiben erhalten.
#
# Unit: kein Rückgabewert. Dies fordert eine Änderung an, liefert weder TRUE/FALSE noch eine
# Serverbestätigung. Der Server kann sie ablehnen.

SUB Main()
    # Das gewünschte Buch muss offen sein, die benötigten Seiten geladen und für Änderungen
    # bearbeitbar. 1, 2 und 3 sind Seitennummern; ihre Existenz prüfen. Namen und Text sind
    # Beispiele.

    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

Erläuterung der Parameter und Ausführung:

  • Das gewünschte Buch muss offen sein, die benötigten Seiten geladen und für Änderungen bearbeitbar. 1, 2 und 3 sind Seitennummern; ihre Existenz prüfen. Namen und Text sind Beispiele.

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

Clone this wiki locally