Método ITextServices::OnTxSetCursor (textserv.h)

Artigo
03/05/2024

Notifica o objeto de serviços de texto para definir o cursor.

Sintaxe

HRESULT OnTxSetCursor(
  [in] DWORD          dwDrawAspect,
       LONG           lindex,
  [in] void           *pvAspect,
  [in] DVTARGETDEVICE *ptd,
  [in] HDC            hdcDraw,
  [in] HDC            hicTargetDev,
  [in] LPCRECT        lprcClient,
  [in] INT            x,
  [in] INT            y
);

Parâmetros

[in] dwDrawAspect

Tipo: DWORD

O aspecto de desenho pode ser um dos valores a seguir.

Valor	Significado
DVASPECT_CONTENT	Renderiza uma imagem de tela do conteúdo do texto para o contexto do dispositivo hdcDraw . Os parâmetros hicTargetDev e ptd fornecem informações sobre o contexto do dispositivo de destino, se houver (geralmente uma impressora).
DVASPECT_DOCPRINT	Renderiza o objeto para o contexto do dispositivo hdcDraw como se ele fosse impresso em uma impressora. Assim, o objeto de serviços de texto pode otimizar para a impressora (por exemplo, não pintar a cor da tela de fundo, se for branco). Além disso, determinados elementos específicos da tela (como a seleção) não devem ser renderizados. ITextServices::OnTxSetCursor deve renderizar o retângulo lprcClient , começando na posição de rolagem atual.

Valor

Significado

DVASPECT_CONTENT

Renderiza uma imagem de tela do conteúdo do texto para o contexto do dispositivo hdcDraw . Os parâmetros hicTargetDev e ptd fornecem informações sobre o contexto do dispositivo de destino, se houver (geralmente uma impressora).

DVASPECT_DOCPRINT

Renderiza o objeto para o contexto do dispositivo hdcDraw como se ele fosse impresso em uma impressora. Assim, o objeto de serviços de texto pode otimizar para a impressora (por exemplo, não pintar a cor da tela de fundo, se for branco). Além disso, determinados elementos específicos da tela (como a seleção) não devem ser renderizados.

ITextServices::OnTxSetCursor deve renderizar o retângulo lprcClient , começando na posição de rolagem atual.

lindex

Tipo: LONG

Não há suporte.

[in] pvAspect

Tipo: void*

Informações para otimizações de desenho.

[in] ptd

Tipo: DVTARGETDEVICE*

O dispositivo de destino.

[in] hdcDraw

Tipo: HDC

Renderizando o contexto do dispositivo.

[in] hicTargetDev

Tipo: HDC

Contexto de informações de destino.

[in] lprcClient

Tipo: LPCRECT

O retângulo do cliente do controle. As coordenadas do retângulo estão nas coordenadas do cliente da janela que o contém. NULL é um valor legal.

[in] x

Tipo: INT

x posição do cursor, nas coordenadas do cliente da janela que o contém.

[in] y

Tipo: INT

y posição do cursor, nas coordenadas do cliente da janela que o contém.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será S_OK.

Se o método falhar, o valor retornado será o código HRESULT a seguir. Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Código de retorno	Descrição
E_INVALIDARG	Um ou mais parâmetros ilegais.

Comentários

O objeto de serviços de texto pode ser remisso como resultado dessa chamada para determinar o cursor correto. O cursor correto é definido por meio de TxSetCursor.

O parâmetro lprcClient é o retângulo do cliente da exibição do controle sobre o qual o cursor do mouse está posicionado. O parâmetro lprcClient está nas coordenadas do dispositivo da janela que contém da mesma forma que a mensagem de WM_SIZE . Essa pode não ser a exibição que foi renderizada por último. Além disso, se o controle estiver ativo in-loco, esse pode não ser o modo de exibição ativo atual. Como consequência, o objeto de serviços de texto deve marcar esse retângulo em relação ao valor do cache atual e determinar se o recálculo das linhas é necessário ou não. O fator de zoom deve ser incluído nessa computação. Para obter uma discussão sobre o fator de zoom, consulte TxGetExtent.

Esse método deve ser chamado apenas para exibições de tela do controle. Portanto, o DC (contexto do dispositivo) não é passado, mas deve ser considerado um DC de tela.

Para obter mais informações, consulte os Comentários em ITextServices::TxDraw.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	textserv.h
DLL	Msftedit.dll