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

Artigo
08/23/2023

Define a posição do cursor e as opções de atualização.

Sintaxe

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

Parâmetros

[in] X

Tipo: INT

A nova posição X do cursor nas coordenadas da área de trabalho virtual. Consulte Observações.

[in] Y

Tipo: INT

A nova posição Y do cursor nas coordenadas da área de trabalho virtual. Consulte Observações.

[in] Flags

Tipo: DWORD

Especifica as opções de atualização para o cursor. Atualmente, apenas um sinalizador é definido.

Valor	Significado
D3DCURSOR_IMMEDIATE_UPDATE	Atualize o cursor na taxa de atualização. Se esse sinalizador for especificado, o sistema garantirá que o cursor será atualizado no mínimo metade da taxa de atualização de exibição, mas nunca com mais frequência do que a taxa de atualização de exibição. Caso contrário, o método atrasará as atualizações do cursor até a próxima chamada IDirect3DDevice9::P resent . Não definir esse sinalizador geralmente resulta em um desempenho melhor do que se o sinalizador estiver definido. No entanto, os aplicativos devem definir esse sinalizador se a taxa de chamadas para Apresentar for baixa o suficiente para que os usuários observem um atraso significativo no movimento do cursor. Esse sinalizador não tem efeito em um aplicativo de modo de janela. Algumas placas de vídeo implementam cursores de cor de hardware. Esse sinalizador não tem efeito sobre esses cartões.

Valor

Significado

D3DCURSOR_IMMEDIATE_UPDATE

Atualize o cursor na taxa de atualização.

Se esse sinalizador for especificado, o sistema garantirá que o cursor será atualizado no mínimo metade da taxa de atualização de exibição, mas nunca com mais frequência do que a taxa de atualização de exibição. Caso contrário, o método atrasará as atualizações do cursor até a próxima chamada IDirect3DDevice9::P resent . Não definir esse sinalizador geralmente resulta em um desempenho melhor do que se o sinalizador estiver definido. No entanto, os aplicativos devem definir esse sinalizador se a taxa de chamadas para Apresentar for baixa o suficiente para que os usuários observem um atraso significativo no movimento do cursor. Esse sinalizador não tem efeito em um aplicativo de modo de janela. Algumas placas de vídeo implementam cursores de cor de hardware. Esse sinalizador não tem efeito sobre esses cartões.

Valor retornado

Nenhum

Comentários

Ao executar no modo de tela inteira, as coordenadas de espaço na tela são as coordenadas do buffer de fundo dimensionadas adequadamente para o modo de exibição atual. Ao executar no modo de janela, as coordenadas de espaço na tela são as coordenadas da área de trabalho. A imagem do cursor é desenhada na posição especificada menos o deslocamento de hotspot especificado pelo método SetCursorProperties .

Se o cursor tiver sido oculto por ShowCursor, o cursor não será desenhado.