Compartilhar via

Método ITextStoreACP2::FindNextAttrTransition (textstor.h)

  • Artigo

Determina a posição do caractere em que ocorre uma transição em um valor de atributo. O atributo especificado para marcar depende do aplicativo.

Sintaxe

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

Parâmetros

[in] acpStart

Especifica a posição do caractere para iniciar a pesquisa de uma transição de atributo.

[in] acpHalt

Especifica a posição do caractere para encerrar a pesquisa de uma transição de atributo.

[in] cFilterAttrs

Especifica o número de atributos a marcar.

[in] paFilterAttrs

Ponteiro para o tipo de dados TS_ATTRID que especifica o atributo a marcar.

[in] dwFlags

Especifica a direção para pesquisar uma transição de atributo. Por padrão, o método pesquisa para frente.

Valor Significado
TS_ATTR_FIND_BACKWARDS
 O método pesquisa para trás.
TS_ATTR_FIND_WANT_OFFSET
 O parâmetro plFoundOffset recebe o deslocamento de caractere da transição de atributo do acpStart.

[out] pacpNext

Recebe a próxima posição de caractere para marcar para uma transição de atributo.

[out] pfFound

Receberá um valor booliano de TRUE se uma transição de atributo for encontrada, caso contrário, FALSE será retornado.

[out] plFoundOffset

Recebe a posição de caractere da transição de atributo (não as posições ACP). Se TS_ATTR_FIND_WANT_OFFSET sinalizador for definido em dwFlags, receberá o deslocamento de caractere da transição de atributo do acpStart.

Valor retornado

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
 O método foi bem-sucedido.
TS_E_INVALIDPOS
 As posições de caractere especificadas estão além do texto no documento.

Comentários

Nota Se um aplicativo não implementar FindNextAttrTransition, ITfReadOnlyProperty::EnumRanges falhará com E_FAIL.
 

Requisitos

   
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho textstor.h
DLL Msctf.dll

Confira também

ITextStoreACP2

TS_ATTRID

Constantes TS_ATTR_*