API UO BookGetPageText fr

UO.BookGetPageText

ClassicUO / Basic IDE

Home · API · Books

Lit une page du dernier livre ouvert.

Syntaxe exacte

UO.BookGetPageText(Page:Any) -> Any

Paramètres

• Page — Numéro de page à partir de 1, pas l’ID du livre. Le serveur fournit le nombre de pages.

Retour

String : lignes séparées par des sauts de ligne, sans lignes vides finales. Une chaîne vide peut aussi signaler aucun livre ouvert, une page non reçue ou un numéro incorrect ; elle ne prouve pas que la page existe ou est modifiable.

Comportement

• Ouvrez d’abord le livre voulu dans le jeu. La commande vise le dernier livre ouvert, sans paramètre ID. Vérifiez la sélection si plusieurs livres sont ouverts. Get lit les données reçues et ne demande pas de page manquante.
• Le gestionnaire conserve les livres dans la session, même sans affichage. Fermer et rouvrir la vue conserve livre et brouillon. Fermer le livre le retire des livres ouverts ; une déconnexion efface les livres serveur.
• Seuls les livres modifiables acceptent l’écriture. Page invalide et texte excessif sont refusés. BookSetText valide toutes les pages avant l’envoi : une erreur tardive ne produit pas d’écriture partielle.

Fonctions internes : de l’appel au résultat

Le serveur envoie en-tête, nombre de pages et contenu. SessionBooks valide chaque paquet complet, conserve les données et actualise la vue. Basic sélectionne le dernier livre via le bridge ; SessionBook lit les lignes ou valide puis envoie les modifications. ModernBookGump affiche ces données et conserve les brouillons lors du détachement graphique.

1. GetOpenBook

Ouvrez d’abord le livre voulu dans le jeu. La commande vise le dernier livre ouvert, sans paramètre ID. Vérifiez la sélection si plusieurs livres sont ouverts. Get lit les données reçues et ne demande pas de page manquante.

Le gestionnaire conserve les livres dans la session, même sans affichage. Fermer et rouvrir la vue conserve livre et brouillon. Fermer le livre le retire des livres ouverts ; une déconnexion efface les livres serveur.

Source du projet: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; fonction GetOpenBook.

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

Seuls les livres modifiables acceptent l’écriture. Page invalide et texte excessif sont refusés. BookSetText valide toutes les pages avant l’envoi : une erreur tardive ne produit pas d’écriture partielle.

String : lignes séparées par des sauts de ligne, sans lignes vides finales. Une chaîne vide peut aussi signaler aucun livre ouvert, une page non reçue ou un numéro incorrect ; elle ne prouve pas que la page existe ou est modifiable.

Source du projet: src/ClassicUO.Client/Game/Managers/SessionBooks.cs; fonction SessionBooks.ReceiveHeader/ReceivePages; SessionBook.Yoko*.

Ouvrez d’abord le livre voulu dans le jeu. La commande vise le dernier livre ouvert, sans paramètre ID. Vérifiez la sélection si plusieurs livres sont ouverts. Get lit les données reçues et ne demande pas de page manquante.

Exemples

Utilisation directe

# Utilisation directe
#
# Lit une page du dernier livre ouvert.
#
# String : lignes séparées par des sauts de ligne, sans lignes vides finales. Une chaîne vide
# peut aussi signaler aucun livre ouvert, une page non reçue ou un numéro incorrect ; elle ne
# prouve pas que la page existe ou est modifiable.

SUB Main()
    # Le livre voulu doit être ouvert, ses pages reçues et modifiable pour écrire. 1, 2 et 3 sont
    # des numéros de page à vérifier. Noms et textes sont des exemples.

    VAR text = UO.BookGetPageText(1)
    IF text <> "" THEN
        UO.Print(text)
    END IF
END SUB

Explication des paramètres et du déroulement:

• Le livre voulu doit être ouvert, ses pages reçues et modifiable pour écrire. 1, 2 et 3 sont des numéros de page à vérifier. Noms et textes sont des exemples.

Scénario pratique

# Scénario pratique
#
# Lit une page du dernier livre ouvert.
#
# String : lignes séparées par des sauts de ligne, sans lignes vides finales. Une chaîne vide
# peut aussi signaler aucun livre ouvert, une page non reçue ou un numéro incorrect ; elle ne
# prouve pas que la page existe ou est modifiable.

SUB Main()
    # Le livre voulu doit être ouvert, ses pages reçues et modifiable pour écrire. 1, 2 et 3 sont
    # des numéros de page à vérifier. Noms et textes sont des exemples.

    VAR firstPage = UO.BookGetPageText(1)
    IF firstPage <> "" THEN
        UO.BookSetPageText(3, firstPage)
    END IF
END SUB

Explication des paramètres et du déroulement:

• Le livre voulu doit être ouvert, ses pages reçues et modifiable pour écrire. 1, 2 et 3 sont des numéros de page à vérifier. Noms et textes sont des exemples.

Fonction auxiliaire complète

# Fonction auxiliaire complète
#
# Lit une page du dernier livre ouvert.
#
# String : lignes séparées par des sauts de ligne, sans lignes vides finales. Une chaîne vide
# peut aussi signaler aucun livre ouvert, une page non reçue ou un numéro incorrect ; elle ne
# prouve pas que la page existe ou est modifiable.

SUB Main()
    # Le livre voulu doit être ouvert, ses pages reçues et modifiable pour écrire. 1, 2 et 3 sont
    # des numéros de page à vérifier. Noms et textes sont des exemples.

    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

Explication des paramètres et du déroulement:

• Le livre voulu doit être ouvert, ses pages reçues et modifiable pour écrire. 1, 2 et 3 sont des numéros de page à vérifier. Noms et textes sont des exemples.

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