API UO BookClearText it

UO.BookClearText

ClassicUO / Basic IDE

Home · API · Books

Svuota tutte le pagine del libro modificabile aperto, conservando titolo e autore.

Sintassi esatta

UO.BookClearText() -> Unit

Parametri

Nessun parametro.

Restituisce

Unit: nessun valore restituito. Richiede una scrittura, senza TRUE/FALSE né conferma del server, che può rifiutarla.

Comportamento

• Aprire prima il libro desiderato nel gioco. Viene scelto l’ultimo libro aperto, senza argomento ID. Con più libri verificare la scelta. Get legge i dati ricevuti senza richiedere pagine mancanti.
• Il gestore conserva il libro nella sessione anche senza grafica. Chiudere e riaprire la vista mantiene libro e bozza. Chiudere il libro stesso lo rimuove; la disconnessione cancella i libri del server.
• Solo i libri modificabili accettano scritture. Pagine errate o testo eccessivo vengono rifiutati. BookSetText verifica tutte le pagine prima dell’invio: un errore successivo non produce una scrittura parziale.
• BookClearText invia testo vuoto per ogni pagina e distrugge il contenuto precedente. Usare una propria copia modificabile. Titolo e autore restano.

Funzioni interne: dalla chiamata al risultato

Il server invia intestazione, numero di pagine e contenuto. SessionBooks verifica il pacchetto completo, salva dati e aggiorna la vista. Basic sceglie l’ultimo libro tramite il bridge; SessionBook legge righe o verifica e invia modifiche. ModernBookGump mostra gli stessi dati e conserva le bozze al distacco della grafica.

1. GetOpenBook

Aprire prima il libro desiderato nel gioco. Viene scelto l’ultimo libro aperto, senza argomento ID. Con più libri verificare la scelta. Get legge i dati ricevuti senza richiedere pagine mancanti.

Il gestore conserva il libro nella sessione anche senza grafica. Chiudere e riaprire la vista mantiene libro e bozza. Chiudere il libro stesso lo rimuove; la disconnessione cancella i libri del server.

Sorgente del progetto: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; funzione GetOpenBook.

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

Solo i libri modificabili accettano scritture. Pagine errate o testo eccessivo vengono rifiutati. BookSetText verifica tutte le pagine prima dell’invio: un errore successivo non produce una scrittura parziale.

Unit: nessun valore restituito. Richiede una scrittura, senza TRUE/FALSE né conferma del server, che può rifiutarla.

Sorgente del progetto: src/ClassicUO.Client/Game/Managers/SessionBooks.cs; funzione SessionBooks.ReceiveHeader/ReceivePages; SessionBook.Yoko*.

Aprire prima il libro desiderato nel gioco. Viene scelto l’ultimo libro aperto, senza argomento ID. Con più libri verificare la scelta. Get legge i dati ricevuti senza richiedere pagine mancanti.

Esempi

Uso diretto

# Uso diretto
#
# Svuota tutte le pagine del libro modificabile aperto, conservando titolo e autore.
#
# Unit: nessun valore restituito. Richiede una scrittura, senza TRUE/FALSE né conferma del
# server, che può rifiutarla.

SUB Main()
    # Il libro desiderato deve essere aperto, le pagine necessarie ricevute e il libro modificabile
    # per scrivere. 1, 2 e 3 sono pagine da verificare. Nomi e testi sono esempi.

    UO.BookClearText()
END SUB

Spiegazione dei parametri e dell’esecuzione:

• Il libro desiderato deve essere aperto, le pagine necessarie ricevute e il libro modificabile per scrivere. 1, 2 e 3 sono pagine da verificare. Nomi e testi sono esempi.

Scenario pratico

# Scenario pratico
#
# Svuota tutte le pagine del libro modificabile aperto, conservando titolo e autore.
#
# Unit: nessun valore restituito. Richiede una scrittura, senza TRUE/FALSE né conferma del
# server, che può rifiutarla.

SUB Main()
    # Il libro desiderato deve essere aperto, le pagine necessarie ricevute e il libro modificabile
    # per scrivere. 1, 2 e 3 sono pagine da verificare. Nomi e testi sono esempi.

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

Spiegazione dei parametri e dell’esecuzione:

• Il libro desiderato deve essere aperto, le pagine necessarie ricevute e il libro modificabile per scrivere. 1, 2 e 3 sono pagine da verificare. Nomi e testi sono esempi.

Funzione ausiliaria completa

# Funzione ausiliaria completa
#
# Svuota tutte le pagine del libro modificabile aperto, conservando titolo e autore.
#
# Unit: nessun valore restituito. Richiede una scrittura, senza TRUE/FALSE né conferma del
# server, che può rifiutarla.

SUB Main()
    # Il libro desiderato deve essere aperto, le pagine necessarie ricevute e il libro modificabile
    # per scrivere. 1, 2 e 3 sono pagine da verificare. Nomi e testi sono esempi.

    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

Spiegazione dei parametri e dell’esecuzione:

• Il libro desiderato deve essere aperto, le pagine necessarie ricevute e il libro modificabile per scrivere. 1, 2 e 3 sono pagine da verificare. Nomi e testi sono esempi.

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