Metodo ITextStoreACP2::FindNextAttrTransition (textstor.h)

Articolo
08/26/2023

Determina la posizione del carattere in cui si verifica una transizione in un valore di attributo. L'attributo specificato da controllare dipende dall'applicazione.

Sintassi

HRESULT FindNextAttrTransition(
  [in]  LONG            acpStart,
  [in]  LONG            acpHalt,
  [in]  ULONG           cFilterAttrs,
  [in]  const TS_ATTRID *paFilterAttrs,
  [in]  DWORD           dwFlags,
  [out] LONG            *pacpNext,
  [out] BOOL            *pfFound,
  [out] LONG            *plFoundOffset
);

Parametri

[in] acpStart

Specifica la posizione del carattere per avviare la ricerca di una transizione dell'attributo.

[in] acpHalt

Specifica la posizione del carattere per terminare la ricerca di una transizione dell'attributo.

[in] cFilterAttrs

Specifica il numero di attributi da controllare.

[in] paFilterAttrs

Puntatore al tipo di dati TS_ATTRID che specifica l'attributo da controllare.

[in] dwFlags

Specifica la direzione di ricerca di una transizione dell'attributo. Per impostazione predefinita, il metodo esegue la ricerca in avanti.

valore	Significato
TS_ATTR_FIND_BACKWARDS	Il metodo esegue la ricerca all'indietro.
TS_ATTR_FIND_WANT_OFFSET	Il parametro plFoundOffset riceve l'offset di caratteri della transizione dell'attributo da acpStart.

[out] pacpNext

Riceve la posizione successiva del carattere per verificare la presenza di una transizione dell'attributo.

[out] pfFound

Riceve un valore booleano true se è stata trovata una transizione dell'attributo; in caso contrario, viene restituito FALSE .

[out] plFoundOffset

Riceve la posizione del carattere della transizione dell'attributo (non le posizioni ACP). Se TS_ATTR_FIND_WANT_OFFSET flag è impostato in dwFlags, riceve l'offset di caratteri della transizione dell'attributo da acpStart.

Valore restituito

Questo metodo può restituire uno di questi valori.

valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
TS_E_INVALIDPOS	Le posizioni dei caratteri specificate superano il testo del documento.

Commenti

Nota Se un'applicazione non implementa FindNextAttrTransition, ITfReadOnlyProperty::EnumRanges ha esito negativo con E_FAIL.

Requisiti


Client minimo supportato	Windows 8 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	textstor.h
DLL	Msctf.dll

Vedi anche

ITextStoreACP2

TS_ATTRID

costanti TS_ATTR_*

Condividi tramite