Metodo ITfContextOwner::GetACPFromPoint (msctf.h)

  • Articolo

Il metodo ITfContextOwner::GetACPFromPoint converte un punto nelle coordinate dello schermo in una posizione del carattere dell'applicazione.

Sintassi

HRESULT GetACPFromPoint(
  [in]  const POINT *ptScreen,
  [in]  DWORD       dwFlags,
  [out] LONG        *pacp
);

Parametri

[in] ptScreen

Puntatore alla struttura POINT con le coordinate dello schermo del punto.

[in] dwFlags

Specifica la posizione del carattere da restituire in base alle coordinate dello schermo del punto rispetto a un rettangolo di selezione dei caratteri. Per impostazione predefinita, la posizione del carattere restituita è il rettangolo di selezione dei caratteri contenente le coordinate dello schermo del punto. Se il punto si trova all'esterno del rettangolo di delimitazione di un carattere, il metodo restituisce NULL o TF_E_INVALIDPOINT.

Se per questo parametro viene specificato il flag di GXFPF_ROUND_NEAREST e le coordinate dello schermo del punto sono contenute in un riquadro delimitatore di caratteri, la posizione del carattere restituita è il bordo di delimitazione più vicino alle coordinate dello schermo del punto.

Se per questo parametro viene specificato il flag di GXFPF_NEAREST e le coordinate dello schermo del punto non sono contenute in un riquadro delimitatore di caratteri, viene restituita la posizione del carattere più vicina.

I flag di bit possono essere combinati.

[out] pacp

Riceve la posizione del carattere corrispondente alle coordinate dello schermo del punto

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore Descrizione
S_OK
 Il metodo è stato eseguito correttamente.
TS_E_INVALIDPOINT
 Il parametro ptScreen non si trova all'interno del rettangolo di selezione di alcun carattere.
TS_E_NOLAYOUT
 L'applicazione non ha calcolato un layout di testo.

Commenti

Il punto 1 si trova nel rettangolo di delimitazione dei caratteri e il punto 2 non rientra nel rettangolo di selezione dei caratteri. Usare l'illustrazione per determinare la posizione del carattere restituita in base ai flag usati nel parametro dwFlags .

Punto 1

  • Default-- pacp = 0 --Le coordinate dello schermo del punto si trova all'interno del riquadro delimitatore di caratteri di Posizione carattere 0.
  • GXFPF_ROUND_NEAREST-- pacp = 1 - Le coordinate dello schermo del punto sono più vicine alla posizione di intervallo 1, ovvero la posizione dell'intervallo iniziale della posizione carattere 1.
  • GXFPF_NEAREST-- pacp = 0 --Il comportamento predefinito si verifica perché il punto si trova all'interno del riquadro delimitatore di caratteri di Posizione carattere 0.
Punto 2
  • Default-- hr = TF_E_INVALIDPOINT --Le coordinate dello schermo del punto si trovano all'esterno di un rettangolo di selezione dei caratteri.
  • GXFPF_ROUND_NEAREST-- hr = TF_E_INVALIDPOINT --Il comportamento predefinito si verifica perché le coordinate dello schermo del punto si trovano all'esterno di un rettangolo di selezione dei caratteri.
  • GXFPF_NEAREST-- pacp = 1 - La posizione del carattere più vicina alle coordinate dello schermo del punto è Posizione carattere 1.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione msctf.h
DLL Msimtf.dll
Componente ridistribuibile TSF 1.0 in Windows 2000 Professional

Vedi anche

ITextStoreACP::GetACPFromPoint

ITfContextOwner

ITfContextView::GetRangeFromPoint

TsViewCookie