Compartilhar via

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

  • Artigo

O método ITextStoreACP::FindNextAttrTransition 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 de acpStart.

[out] pacpNext

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

[out] pfFound

Recebe um valor booliano true se uma transição de atributo foi encontrada; caso contrário, FALSE é retornado.

[out] plFoundOffset

Recebe a posição do 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 de 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 ITextStoreACP::FindNextAttrTransition, ITfReadOnlyProperty::EnumRanges falhará com E_FAIL.
 

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho textstor.h
DLL Msctf.dll
Redistribuível TSF 1.0 no Windows 2000 Professional

Confira também

Itextstoreacp

TS_ATTRID

Constantes TS_ATTR_*