Metodo ITextServices::OnTxSetCursor (textserv.h)

Articolo
03/15/2023

Notifica all'oggetto servizi di testo di impostare il cursore.

Sintassi

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
);

Parametri

[in] dwDrawAspect

Tipo: DWORD

L'aspetto di disegno può essere uno dei valori seguenti.

Valore	Significato
DVASPECT_CONTENT	Esegue il rendering di un'immagine dello schermo del contenuto di testo nel contesto di dispositivo hdcDraw . I parametri hicTargetDev e ptd forniscono informazioni sul contesto del dispositivo di destinazione, se presenti (in genere una stampante).
DVASPECT_DOCPRINT	Esegue il rendering dell'oggetto nel contesto di dispositivo hdcDraw come se fosse stampato in una stampante. Di conseguenza, l'oggetto servizi di testo può essere ottimizzato per la stampante (ad esempio, non disegnare il colore di sfondo, se bianco). Inoltre, non deve essere eseguito il rendering di alcuni elementi specifici dello schermo, ad esempio la selezione. ITextServices::OnTxSetCursor deve eseguire il rendering del rettangolo lprcClient , a partire dalla posizione di scorrimento corrente.

Valore

Significato

DVASPECT_CONTENT

Esegue il rendering di un'immagine dello schermo del contenuto di testo nel contesto di dispositivo hdcDraw . I parametri hicTargetDev e ptd forniscono informazioni sul contesto del dispositivo di destinazione, se presenti (in genere una stampante).

DVASPECT_DOCPRINT

Esegue il rendering dell'oggetto nel contesto di dispositivo hdcDraw come se fosse stampato in una stampante. Di conseguenza, l'oggetto servizi di testo può essere ottimizzato per la stampante (ad esempio, non disegnare il colore di sfondo, se bianco). Inoltre, non deve essere eseguito il rendering di alcuni elementi specifici dello schermo, ad esempio la selezione.

ITextServices::OnTxSetCursor deve eseguire il rendering del rettangolo lprcClient , a partire dalla posizione di scorrimento corrente.

lindex

Tipo: LONG

Non supportato.

[in] pvAspect

Tipo: void*

Informazioni per le ottimizzazioni del disegno.

[in] ptd

Tipo: DVTARGETDEVICE*

Dispositivo di destinazione

[in] hdcDraw

Tipo: HDC

Rendering del contesto del dispositivo.

[in] hicTargetDev

Tipo: HDC

Contesto delle informazioni di destinazione.

[in] lprcClient

Tipo: LPCRECT

Rettangolo client del controllo. Le coordinate del rettangolo si trovano nelle coordinate client della finestra contenitore. NULL è un valore legale.

[in] x

Tipo: INT

x posizione del cursore, nelle coordinate client della finestra contenitore.

[in] y

Tipo: INT

Posizione y del cursore, nelle coordinate client della finestra contenitore.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito viene S_OK.

Se il metodo ha esito negativo, il valore restituito è il codice HRESULT seguente. Per altre informazioni sui codici di errore COM, vedere Gestione degli errori in COM.

Codice restituito	Descrizione
E_INVALIDARG	Uno o più parametri non validi.

Commenti

L'oggetto servizi di testo può rimecurarsi in seguito a questa chiamata per determinare il cursore corretto. Il cursore corretto viene impostato tramite TxSetCursor.

Il parametro lprcClient è il rettangolo client della visualizzazione del controllo su cui è posizionato il cursore del mouse. Il parametro lprcClient si trova nelle coordinate del dispositivo della finestra contenitore nello stesso modo in cui il messaggio WM_SIZE è. Potrebbe non trattarsi della visualizzazione di cui è stato eseguito il rendering per ultimo. Inoltre, se il controllo è attivo sul posto, potrebbe non essere la visualizzazione attiva corrente. Di conseguenza, l'oggetto servizi di testo deve controllare questo rettangolo rispetto al valore della cache corrente e determinare se ricalcolare le righe è necessario o meno. Il fattore di zoom deve essere incluso in questo calcolo. Per una descrizione del fattore di zoom, vedere TxGetExtent.

Questo metodo deve essere chiamato solo per le visualizzazioni dello schermo del controllo . Pertanto, il contesto di dispositivo (DC) non viene passato, ma deve essere considerato un controller di dominio dello schermo.

Per altre informazioni, vedere la sezione Osservazioni in ITextServices::TxDraw.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	textserv.h
DLL	Msftedit.dll