API UO CancelTarget

UO.CancelTarget

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

ClassicUO • Runtime API

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

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

UO.CancelTarget() -> Unit

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

Параметры

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

Возвращает

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

Поведение

• Уже отправленные серверу ответы не отзываются.
• Локальный callback-прицел получает отмену; для активного серверного прицела отправляется отмена цели.
• Очередь общая для клиента: её очистка относится к подготовленным ответам всех процедур.

Примеры

Пример 1. Снять подготовку

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

SUB Main()
    # Аргументов нет.
    # Отложенный ответ на self удаляется.

    UO.WaitTargetSelf()
    UO.CancelTarget()
END SUB

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

• Аргументов нет.
• Отложенный ответ на self удаляется.

Пример 2. Заменить ранее подготовленную точку

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

SUB Main()
    # 1445/1690/0 — пример новой точки мира.
    # Старые ответы убираются до постановки новой цели.

    UO.CancelTarget()
    UO.WaitTargetXYZ(1445, 1690, 0)
END SUB

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

• 1445/1690/0 — пример новой точки мира.
• Старые ответы убираются до постановки новой цели.

Пример 3. Отказаться после тайм-аута

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

SUB Main()
    # WAIT=1000 мс — ограничение этого примера.
    # Проверяется оставшаяся очередь, а не успешность навыка. При отсутствии серверного прицела
    # следующая посторонняя команда не получит старый ответ.

    UO.WaitTargetSelf()
    UO.UseSkill('Anatomy')
    WAIT(1000)
    IF UO.IsWaitTargetActive() THEN
        UO.CancelTarget()
    END IF
END SUB

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

• WAIT=1000 мс — ограничение этого примера.
• Проверяется оставшаяся очередь, а не успешность навыка. При отсутствии серверного прицела следующая посторонняя команда не получит старый ответ.