Função DrvMovePointer (winddi.h)

A função DrvMovePointer move o ponteiro para uma nova posição e garante que a GDI não interfira na exibição do ponteiro.

Sintaxe

void DrvMovePointer(
  [in] SURFOBJ *pso,
  [in] LONG    x,
  [in] LONG    y,
  [in] RECTL   *prcl
);

Parâmetros

[in] pso

Ponteiro para uma estrutura SURFOBJ que descreve a superfície de um dispositivo de exibição.

[in] x

Especifique a coordenada x na exibição em que o driver deve posicionar o ponto de acesso do ponteiro.

Um valor x negativo indica que o driver deve remover o ponteiro da exibição porque o desenho está prestes a ocorrer onde ele está localizado atualmente. Se o ponteiro tiver sido removido da exibição e o valor x for não negativo, o driver deverá restaurar o ponteiro.

[in] y

Especifique a coordenada y na exibição em que o driver deve posicionar o ponto de acesso do ponteiro.

Quando o driver tiver definido o sinalizador GCAPS_PANNING na estrutura DEVINFO , um valor y negativo indica que a GDI está chamando essa função apenas para notificar o driver da posição atual do cursor. A posição atual pode ser computada como (x, y+pso-sizlBitmap.cy>). Um driver que não define o sinalizador GCAPS_PANNING nunca receberá uma coordenada y negativa.

[in] prcl

Ponteiro para uma estrutura RECTL definindo uma área que vincula todos os pixels afetados pelo ponteiro na tela. O GDI não desenhará neste retângulo sem primeiro remover o ponteiro da tela. Este parâmetro pode ser NULL.

Retornar valor

Nenhum

Comentários

Os drivers às vezes precisam saber a posição atual do ponteiro na tela – mesmo quando a GDI está simulando o ponteiro (de modo que o driver não recebe mais chamadas normais do DrvMovePointer ) – para lidar com exibições virtuais de movimento panorâmico. Para receber essa notificação, o driver deve definir o sinalizador GCAPS_PANNING no campo flGraphicsCaps da estrutura DEVINFO .

DrvMovePointer não será chamado enquanto qualquer thread estiver desenhando no driver de exibição, a menos que o sinalizador GCAPS_ASYNCMOVE seja definido no membro flGraphicsCaps de DEVINFO.

DrvMovePointer deve ser implementado em drivers de exibição somente quando DrvSetPointerShape também é implementado.

Se um driver tiver registrado o ponteiro especificado usando DrvSetPointerShape, DrvMovePointer não deverá falhar.

Requisitos

Confira também

DEVINFO

DrvSetPointerShape

SURFOBJ