Método IDirect3DDevice9::SetCursorPosition (d3d9.h)

Artículo
08/23/2023

Establece la posición del cursor y las opciones de actualización.

Sintaxis

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

Parámetros

[in] X

Tipo: INT

Nueva posición X del cursor en coordenadas de escritorio virtual. Vea la sección Comentarios.

[in] Y

Tipo: INT

Nueva posición Y del cursor en coordenadas de escritorio virtual. Vea la sección Comentarios.

[in] Flags

Tipo: DWORD

Especifica las opciones de actualización del cursor. Actualmente, solo se define una marca.

Valor	Significado
D3DCURSOR_IMMEDIATE_UPDATE	Actualice el cursor a la velocidad de actualización. Si se especifica esta marca, el sistema garantiza que el cursor se actualizará como mínimo a la mitad de la frecuencia de actualización de la pantalla, pero nunca con más frecuencia que la frecuencia de actualización de la pantalla. De lo contrario, el método retrasa las actualizaciones del cursor hasta la siguiente llamada IDirect3DDevice9::P resent . No establecer esta marca normalmente da como resultado un mejor rendimiento que si se establece la marca. Sin embargo, las aplicaciones deben establecer esta marca si la tasa de llamadas a Present es lo suficientemente baja como para que los usuarios observen un retraso significativo en el movimiento del cursor. Esta marca no tiene ningún efecto en una aplicación en modo ventana. Algunas tarjetas de vídeo implementan cursores de color de hardware. Esta marca no tiene ningún efecto en estas tarjetas.

Valor

Significado

D3DCURSOR_IMMEDIATE_UPDATE

Actualice el cursor a la velocidad de actualización.

Si se especifica esta marca, el sistema garantiza que el cursor se actualizará como mínimo a la mitad de la frecuencia de actualización de la pantalla, pero nunca con más frecuencia que la frecuencia de actualización de la pantalla. De lo contrario, el método retrasa las actualizaciones del cursor hasta la siguiente llamada IDirect3DDevice9::P resent . No establecer esta marca normalmente da como resultado un mejor rendimiento que si se establece la marca. Sin embargo, las aplicaciones deben establecer esta marca si la tasa de llamadas a Present es lo suficientemente baja como para que los usuarios observen un retraso significativo en el movimiento del cursor. Esta marca no tiene ningún efecto en una aplicación en modo ventana. Algunas tarjetas de vídeo implementan cursores de color de hardware. Esta marca no tiene ningún efecto en estas tarjetas.

Valor devuelto

None

Observaciones

Cuando se ejecuta en modo de pantalla completa, las coordenadas de espacio de pantalla son las coordenadas del búfer de reserva que se escalan adecuadamente al modo de visualización actual. Cuando se ejecuta en modo de ventana, las coordenadas de espacio de pantalla son las coordenadas de escritorio. La imagen del cursor se dibuja en la posición especificada menos el desplazamiento de zona activa especificado por el método SetCursorProperties .

Si showCursor ha ocultado el cursor, el cursor no se dibuja.