UO.TradeContainer

ClassicUO • Runtime API

Devuelve el serial del contenedor propio como cadena hexadecimal.

Sintaxis exacta

UO.TradeContainer(windowIndex:Any) -> String

Parámetros

• windowIndex — Índice entero actual: 0..TradeCount()-1. Negativo/ausente da resultado vacío. No es serial.

Devuelve

String: ID hexadecimal como "0x40000011", o "0x00000000" si falta. Contenedor propio, no Boolean ni cadena vacía.

Comportamiento

• GetTradeContainer/GetTradeOpponent/GetTradeOpponentName/ConfirmTrade/CancelTrade empiezan en 1; TradeContainer/TradeOpponent/TradeName y todas las formas TradeCheck en 0. Este cliente conserva esas convenciones; las referencias de distintos motores difieren.
• Lee en el hilo del juego las ventanas vivas del World actual, excluyendo las cerradas. Leer no envía paquetes ni espera respuestas. Abrir, cerrar o traer al frente cambia el orden UI; el índice no es un ID permanente.
• ConfirmTrade y escribir su TradeCheck envían solo si cambia la aceptación. El servidor controla la casilla ajena. CancelTrade envía una vez. 1/TRUE indica estado/procesamiento local, no transferencia completa. Nombres y casillas no prueban que los objetos sigan iguales.

Funciones internas: de la llamada al resultado

Se explica la ruta C# y después se muestran ejemplos Basic ejecutables. Los scripts no reimplementan el protocolo de red.

1. TradeContainer

El registro selecciona según cantidad de argumentos; NumberConversions convierte números. TradeCheck de dos argumentos valida 1/2 y los transforma en 0/1 del bridge. ToHex formatea serials heredados.

String: ID hexadecimal como "0x40000011", o "0x00000000" si falta. Contenedor propio, no Boolean ni cadena vacía.

Código del proyecto: external/InjectionScript/src/InjectionScript/Runtime/InjectionApiUO.cs; función TradeContainer.

2. TradeContainer

Invoke lleva lectura/escritura al hilo del juego con cancelación del script; lee ID1/ID2, LocalSerial, OpponentName o casillas del TradingGump seleccionado.

Devuelve el serial del contenedor propio como cadena hexadecimal.

Código del proyecto: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; función TradeContainer.

3. FindTrade

FindNumberedTrade comprueba number>0 antes de restar 1; FindTrade rechaza índices negativos y enumera solo TradingGump abiertos de este World.

GetTradeContainer/GetTradeOpponent/GetTradeOpponentName/ConfirmTrade/CancelTrade empiezan en 1; TradeContainer/TradeOpponent/TradeName y todas las formas TradeCheck en 0. Este cliente conserva esas convenciones; las referencias de distintos motores difieren.

Código del proyecto: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; función FindTrade.

La función está completa y Main la llama. Comprobar límites/ID reduce errores pero las llamadas no son atómicas: puede cambiar la ventana. expectedPartner es el serial guardado del personaje, no una validación de precio/contenido.

Ejemplos

Lectura o acción directa

# Lectura o acción directa
#
# Devuelve el serial del contenedor propio como cadena hexadecimal.
#
# String: ID hexadecimal como "0x40000011", o "0x00000000" si falta. Contenedor propio, no
# Boolean ni cadena vacía.

SUB Main()
    # Una llamada guardada en value/result. 0 es el primer índice, 1 el primer número (ver
    # sintaxis). HEX muestra serials numéricos; CStr números o texto.

    VAR value = UO.TradeContainer(0)
    UO.Print(CStr(value))
END SUB

Explicación de los parámetros y la ejecución:

• Una llamada guardada en value/result. 0 es el primer índice, 1 el primer número (ver sintaxis). HEX muestra serials numéricos; CStr números o texto.

Otro escenario y parámetros

# Otro escenario y parámetros
#
# Devuelve el serial del contenedor propio como cadena hexadecimal.
#
# String: ID hexadecimal como "0x40000011", o "0x00000000" si falta. Contenedor propio, no
# Boolean ni cadena vacía.

SUB Main()
    # total guarda la cantidad de ventanas; index es el índice/número actual. Enumerar no confirma
    # nada. GetTradeContainer lee los contenedores propio (1) y ajeno (2) de la ventana 1.

    VAR total = UO.TradeCount()
    FOR VAR index = 0 TO total - 1
        VAR value = UO.TradeContainer(index)
        UO.Print(CStr(index) + ": " + CStr(value))
    NEXT
END SUB

Explicación de los parámetros y la ejecución:

• total guarda la cantidad de ventanas; index es el índice/número actual. Enumerar no confirma nada. GetTradeContainer lee los contenedores propio (1) y ajeno (2) de la ventana 1.

Función auxiliar completa

# Función auxiliar completa
#
# Devuelve el serial del contenedor propio como cadena hexadecimal.
#
# String: ID hexadecimal como "0x40000011", o "0x00000000" si falta. Contenedor propio, no
# Boolean ni cadena vacía.

SUB Main()
    # La función está completa y Main la llama. Comprobar límites/ID reduce errores pero las
    # llamadas no son atómicas: puede cambiar la ventana. expectedPartner es el serial guardado del
    # personaje, no una validación de precio/contenido.

    VAR value = ReadTradeValue(0)
    UO.Print(CStr(value))
END SUB

FUNCTION ReadTradeValue(index)
    VAR total = UO.TradeCount()
    IF index < 0 OR index >= total + 0 THEN
        RETURN "0x00000000"
    END IF
    RETURN UO.TradeContainer(index)
END FUNCTION

Explicación de los parámetros y la ejecución:

• La función está completa y Main la llama. Comprobar límites/ID reduce errores pero las llamadas no son atómicas: puede cambiar la ventana. expectedPartner es el serial guardado del personaje, no una validación de precio/contenido.

---

en · ru · uk · fr · de · it · es · zh-tw · ja · ko

Basic