API UO BookGetPageText de

UO.BookGetPageText

ClassicUO / Basic IDE

Home · API · Books

Liest eine Seite des zuletzt geöffneten Buchs.

Genaue Syntax

UO.BookGetPageText(Page:Any) -> Any

Parameter

• Page — Seitennummer ab 1, keine Buch-ID. Die Seitenzahl kommt vom Server.

Rückgabewert

String: Seitenzeilen mit Zeilenumbrüchen, ohne leere Schlusszeilen. Leer bedeutet auch kein offenes Buch, ungeladene Seite oder ungültige Nummer; es bestätigt weder Existenz noch Schreibbarkeit.

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.

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.

String: Seitenzeilen mit Zeilenumbrüchen, ohne leere Schlusszeilen. Leer bedeutet auch kein offenes Buch, ungeladene Seite oder ungültige Nummer; es bestätigt weder Existenz noch Schreibbarkeit.

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
#
# Liest eine Seite des zuletzt geöffneten Buchs.
#
# String: Seitenzeilen mit Zeilenumbrüchen, ohne leere Schlusszeilen. Leer bedeutet auch kein
# offenes Buch, ungeladene Seite oder ungültige Nummer; es bestätigt weder Existenz noch
# Schreibbarkeit.

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.

    VAR text = UO.BookGetPageText(1)
    IF text <> "" THEN
        UO.Print(text)
    END IF
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
#
# Liest eine Seite des zuletzt geöffneten Buchs.
#
# String: Seitenzeilen mit Zeilenumbrüchen, ohne leere Schlusszeilen. Leer bedeutet auch kein
# offenes Buch, ungeladene Seite oder ungültige Nummer; es bestätigt weder Existenz noch
# Schreibbarkeit.

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.

    VAR firstPage = UO.BookGetPageText(1)
    IF firstPage <> "" THEN
        UO.BookSetPageText(3, firstPage)
    END IF
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
#
# Liest eine Seite des zuletzt geöffneten Buchs.
#
# String: Seitenzeilen mit Zeilenumbrüchen, ohne leere Schlusszeilen. Leer bedeutet auch kein
# offenes Buch, ungeladene Seite oder ungültige Nummer; es bestätigt weder Existenz noch
# Schreibbarkeit.

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.

    ReplaceCampNote(2)
END SUB

SUB ReplaceCampNote(page)
    VAR text = UO.BookGetPageText(page)
    IF text = "Camp A" THEN
        UO.BookSetPageText(page, "Camp B")
    END IF
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 · 繁體中文 · 日本語 · 한국어