UO.ClientRequestObjectTarget

Оглавление · Алфавитный указатель · Targeting

ClassicUO • Runtime API

Открывает локальный прицел для ручного выбора предмета или персонажа.

Точный синтаксис

UO.ClientRequestObjectTarget() -> Unit

Выберите одну из зарегистрированных форм. Параметры передаются позиционно. Any означает значение BASIC с преобразованием внутри команды; Unit — отсутствие возвращаемого значения.

Параметры

Параметров нет.

Возвращает

Unit — возвращаемого значения нет. Вызывайте отдельной строкой; не используйте как true/false, serial или type. Метадата Any у совместимых форм не меняет фактический результат Unit.

Поведение

• Предыдущий результат этого runtime сбрасывается. Команда возвращает сразу, не дожидаясь клика.
• Результат читается через ClientTargetResponse после WaitForClientTargetResponse либо ClientTargetResponsePresent.
• Остановка выполняющейся процедуры снимает принадлежащий ей прицел в ближайшем кадре. Если другой запрос уже заменил курсор, его отмена не затрагивает.
• Один прицел клиентского интерфейса нельзя одновременно использовать для двух независимых ручных выборов. Не запускайте новый запрос, пока не обработали предыдущий.

Примеры

Пример 1. Выбрать предмет или персонажа

# Выбрать предмет или персонажа
#
# Открывает локальный прицел для ручного выбора предмета или персонажа.
#
# Unit — возвращаемого значения нет. Вызывайте отдельной строкой; не используйте как true/false,
# serial или type. Метадата Any у совместимых форм не меняет фактический результат Unit.

SUB Main()
    # 5000 — тайм-аут ожидания клика в миллисекундах. Новый запрос сбрасывает предыдущий результат.
    # Массив из пяти полей означает выбранный объект. result[0] — serial, а не type.

    UO.ClientRequestObjectTarget()
    IF UO.WaitForClientTargetResponse(5000) THEN
        VAR result = UO.ClientTargetResponse()
        IF GetArrayLength(result) = 5 THEN
            UO.Print('Serial: ' + UO.Int2Hex(result[0]))
        ELSE
            UO.Print('Selection cancelled')
        END IF
    END IF
END SUB

Разбор параметров и выполнения:

• 5000 — тайм-аут ожидания клика в миллисекундах. Новый запрос сбрасывает предыдущий результат.
• Массив из пяти полей означает выбранный объект. result[0] — serial, а не type.

Пример 2. Прочитать координаты выбранного тайла

# Прочитать координаты выбранного тайла
#
# Открывает локальный прицел для ручного выбора предмета или персонажа.
#
# Unit — возвращаемого значения нет. Вызывайте отдельной строкой; не используйте как true/false,
# serial или type. Метадата Any у совместимых форм не меняет фактический результат Unit.

SUB Main()
    # result[1] — graphic, result[2]/[3]/[4] — X/Y/Z. У тайла мира serial result[0] равен 0.
    # Тип, координаты и serial — отдельные поля. Индекса статического слоя в этом массиве нет.

    UO.ClientRequestTileTarget()
    IF UO.WaitForClientTargetResponse(5000) THEN
        VAR result = UO.ClientTargetResponse()
        IF GetArrayLength(result) = 5 THEN
            UO.Print('Type: ' + UO.Int2Hex(result[1]))
            UO.Print(STR(result[2]) + ',' + STR(result[3]) + ',' + STR(result[4]))
        END IF
    END IF
END SUB

Разбор параметров и выполнения:

• result[1] — graphic, result[2]/[3]/[4] — X/Y/Z. У тайла мира serial result[0] равен 0.
• Тип, координаты и serial — отдельные поля. Индекса статического слоя в этом массиве нет.

Пример 3. Отмена является ответом, но не объектом

# Отмена является ответом, но не объектом
#
# Открывает локальный прицел для ручного выбора предмета или персонажа.
#
# Unit — возвращаемого значения нет. Вызывайте отдельной строкой; не используйте как true/false,
# serial или type. Метадата Any у совместимых форм не меняет фактический результат Unit.

SUB Main()
    # CancelTarget отменяет локальный выбор; callback возвращает пустой результат.
    # ClientTargetResponsePresent даёт 1, но длина массива равна 0. Не обращайтесь к result[0] без
    # проверки длины.

    UO.ClientRequestObjectTarget()
    UO.CancelTarget()
    IF UO.ClientTargetResponsePresent() THEN
        VAR result = UO.ClientTargetResponse()
        UO.Print('Fields: ' + STR(GetArrayLength(result)))
    END IF
END SUB

Разбор параметров и выполнения:

• CancelTarget отменяет локальный выбор; callback возвращает пустой результат.
• ClientTargetResponsePresent даёт 1, но длина массива равна 0. Не обращайтесь к result[0] без проверки длины.