---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Hint.md
---

# geoObject.Hint

Менеджер хинта геообъекта. Позволяет управлять хинтом геообъекта, открывать и скрывать его. Использует внутри себя менеджер хинтов карты [map.Hint](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Hint.md). Геообъекты содержат экземпляр этого класса, доступный как myGeoObject.hint. Не создавайте экземпляры этого класса без необходимости.

**См.:**[GeoObject.hint](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObject.md#hint)

## Конструктор {#constructor}

```javascript
geoObject.Hint(geoObject)
```

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `geoObject`[*](*parametr) | — | Тип: Object

Геообъект. ||
|#

\* Обязательный параметр/опция.

## Поля {#fields}

#|
|| **Имя** | **Тип** | **Описание** ||
|| [events](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Hint.md#events) | [event.Manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/event.Manager.md) | Менеджер событий хинта геообъекта. ||
|#

## События {#events}

#|
|| **Имя** | **Описание** ||
|| [hide](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Hint.md#event-hide) | Скрытие хинта. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). ||
|| [show](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Hint.md#event-show) | Показ хинта над геообъектом. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• hint - экземпляр класса [Hint](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Hint.md). ||
|#

## Методы {#method}

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [hide](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Hint.md#hide)([[callback](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Hint.md#hide-param-callback)[, [urgently](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Hint.md#hide-param-urgently)]]) |  | Скрывает хинт. ||
|| [isShown](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Hint.md#isShown)() | Boolean | Проверяет состояние хинта на карте. Проксирует вызов [Hint](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Hint.md).isShown(). ||
|| [move](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Hint.md#move)([pixelPosition](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Hint.md#move-param-pixelPosition)) |  | Передвигает хинт, если он в данный момент показан. ||
|| [show](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Hint.md#show)([pixelPosition](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Hint.md#show-param-pixelPosition)) | [Hint](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Hint.md) | Показывает хинт. ||
|#

## Описание полей {#description-fields}

### events

```javascript
{event.Manager} events
```

Менеджер событий хинта геообъекта.

## Описание событий {#description-events}

### hide

Скрытие хинта. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md).

### show

Показ хинта над геообъектом. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• hint - экземпляр класса [Hint](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Hint.md).

## Описание методов {#description-methods}

### hide

```javascript
{} hide([callback[, urgently]])
```

Скрывает хинт.

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| callback | — | Тип: Function

Функция, которая будет вызвана после скрытия хинта. ||
|| urgently | false | Тип: Boolean

Если true, то хинт будет скрыт моментально, без таймаута. ||
|#

**Пример:**

```javascript
// Моментально (без таймаута) скрываем хинт при клике на нем.
// Примечание: такое поведение также можно реализовать, задав геообъекту опцию hintHideTimeout = false.
myPoint.hint.events.add('mouseleave', function () {
    myPoint.hint.hide(function () {
        alert('Пока, хинт!');
    }, true);
});
```

### isShown

```javascript
{Boolean} isShown()
```

Проверяет состояние хинта на карте. Проксирует вызов [Hint](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Hint.md).isShown().

**Returns** true, если хинт показывается, false, - если спрятан.

### move

```javascript
{} move(pixelPosition)
```

Передвигает хинт, если он в данный момент показан.

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `pixelPosition`[*](*parametr) | — | Тип: Number[]

Новая позиция хинта в глобальных пиксельных координатах. ||
|#

\* Обязательный параметр/опция.

**Пример:**

```javascript
// Заставляем хинт двигаться при наведении на геообъект плавными круговыми движениями в размеренном темпе.
var interval = null;

point.hint.events
    .add('show', function (e) {
        var angle = 0,
            position = point.options.get('projection').toGlobalPixels(point.geometry.getCoordinates(), myMap.getZoom());

        interval = setInterval(function () {
            point.hint.move([
                position[0] + 50 + Math.cos(angle) * 50,
                position[1] + 50 + Math.sin(angle) * 50
            ]);
            angle += Math.PI / 90;
            if (angle >= 2 * Math.PI) {
                angle = 0;
            }
        }, 50);
    })
    .add('hide', function () {
        if (interval) {
            clearInterval(interval);
        }
    });
```
### show

```javascript
{Hint} show(pixelPosition)
```

Показывает хинт.

**Returns** экземпляр хинта.

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `pixelPosition`[*](*parametr) | — | Тип: Number[]

Позиция хинта в глобальных пиксельных координатах. ||
|#

\* Обязательный параметр/опция.

**Пример:**

```javascript
// Отключает открытие хинта при наведении мыши и открывает его при клике,
// вместо балуна.
myMap.geoObjects.options.set({
    showHintOnHover: false,
    openBalloonOnClick: false
});

myMap.geoObjects.events.add('click', function (e) {
    var geoObject = e.get('target'),
        position = e.get('globalPixelPosition');

    geoObject.hint.show(position);
});
```

[*parametr]:Обязательный параметр/опция.