Метод IDirect3DDevice9::SetCursorPosition (d3d9.h)

Статья
08/23/2023

Задает положение курсора и параметры обновления.

Синтаксис

void SetCursorPosition(
  [in] int   X,
  [in] int   Y,
  [in] DWORD Flags
);

Параметры

[in] X

Тип: INT

Новая позиция курсора по оси X в координатах виртуального рабочего стола. См. заметки.

[in] Y

Тип: INT

Новая позиция курсора по оси Y в координатах виртуального рабочего стола. См. заметки.

[in] Flags

Тип: DWORD

Задает параметры обновления для курсора. В настоящее время определен только один флаг.

Значение	Значение
D3DCURSOR_IMMEDIATE_UPDATE	Обновление курсора с частотой обновления. Если этот флаг указан, система гарантирует, что курсор будет обновляться не менее половины частоты обновления экрана, но никогда не чаще, чем частота обновления экрана. В противном случае метод задерживает обновление курсора до следующего вызова IDirect3DDevice9::P resent . Если этот флаг не задан, производительность обычно выше, чем при установке флага. Однако приложения должны устанавливать этот флаг, если частота вызовов Present достаточно низка, чтобы пользователи замечали значительную задержку при перемещении курсора. Этот флаг не действует в приложении в оконном режиме. Некоторые видеоадаптеры реализуют аппаратные цветовые курсоры. Этот флаг не влияет на эти карточки.

Значение

D3DCURSOR_IMMEDIATE_UPDATE

Обновление курсора с частотой обновления.

Если этот флаг указан, система гарантирует, что курсор будет обновляться не менее половины частоты обновления экрана, но никогда не чаще, чем частота обновления экрана. В противном случае метод задерживает обновление курсора до следующего вызова IDirect3DDevice9::P resent . Если этот флаг не задан, производительность обычно выше, чем при установке флага. Однако приложения должны устанавливать этот флаг, если частота вызовов Present достаточно низка, чтобы пользователи замечали значительную задержку при перемещении курсора. Этот флаг не действует в приложении в оконном режиме. Некоторые видеоадаптеры реализуют аппаратные цветовые курсоры. Этот флаг не влияет на эти карточки.

Возвращаемое значение

None

Remarks

При работе в полноэкранном режиме координаты экранного пространства — это координаты обратного буфера, соответствующим образом масштабируемые до текущего режима отображения. При работе в оконном режиме координатами экранного пространства являются координаты рабочего стола. Изображение курсора рисуется в указанной позиции за вычетом смещения хот-спота, заданного методом SetCursorProperties .

Если курсор был скрыт с помощью ShowCursor, он не рисуется.