Skip to content

API UO BookSetHeader it

Codex edited this page Sep 23, 2026 · 1 revision

UO.BookSetHeader

ClassicUO / Basic IDE

Home · API · Books

Imposta titolo e autore del libro modificabile aperto.

Sintassi esatta

UO.BookSetHeader(Title:Any, Author:Any) -> Unit

Parametri

  • Title — Titolo: comando ed editor mantengono i primi 47 caratteri.
  • Author — Autore: vengono mantenuti i primi 29 caratteri.

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.

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*.

La funzione ausiliaria è completa. Il suo TRUE indica solo verifica locale e chiamata, non conferma la memorizzazione sul server.

Esempi

Uso diretto

# Uso diretto
#
# Imposta titolo e autore del libro modificabile aperto.
#
# Unit: nessun valore restituito. Richiede una scrittura, senza TRUE/FALSE  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.BookSetHeader("Mining route", "Alice")
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
#
# Imposta titolo e autore del libro modificabile aperto.
#
# Unit: nessun valore restituito. Richiede una scrittura, senza TRUE/FALSE  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.

    VAR route = "Northern mine"
    VAR author = "Alice"
    UO.BookSetHeader("Route: " + route, author)
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
#
# Imposta titolo e autore del libro modificabile aperto.
#
# Unit: nessun valore restituito. Richiede una scrittura, senza TRUE/FALSE  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.
    # La funzione ausiliaria è completa. Il suo TRUE indica solo verifica locale e chiamata, non
    # conferma la memorizzazione sul server.

    VAR requested = SetNotebookHeader("Supply list", "Alice")
END SUB

FUNCTION SetNotebookHeader(title, author)
    IF Len(title) > 47 OR Len(author) > 29 THEN
        RETURN FALSE
    END IF
    UO.BookSetHeader(title, author)
    RETURN TRUE
END FUNCTION

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.
  • La funzione ausiliaria è completa. Il suo TRUE indica solo verifica locale e chiamata, non conferma la memorizzazione sul server.

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

Clone this wiki locally