Método ITfRange::ShiftStartRegion (msctf.h)

Artigo
08/24/2023

Move a âncora inicial para uma região adjacente.

Sintaxe

HRESULT ShiftStartRegion(
  [in]  TfEditCookie ec,
  [in]  TfShiftDir   dir,
  [out] BOOL         *pfNoRegion
);

Parâmetros

[in] ec

Contém um cookie de edição que identifica o contexto de edição obtido de ITfDocumentMgr::CreateContext ou ITfEditSession::D oEditSession.

[in] dir

Contém um dos valores TfShiftDir que especifica para qual região adjacente a âncora inicial é movida.

[out] pfNoRegion

Ponteiro para um BOOL que recebe um sinalizador que indica se a âncora está posicionada adjacente a outra região. Receberá um valor diferente de zero se a âncora não for adjacente a outra região ou zero caso contrário.

Valor retornado

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	pfNoRegion é inválido.
TF_E_NOLOCK	O contexto de edição identificado por ec não tem um bloqueio somente leitura.

Comentários

As posições inicial e final de um intervalo são chamadas de âncoras.

A âncora deve ser posicionada adjacente à região desejada antes de chamar esse método. Se não estiver, pfNoRegion receberá um valor diferente de zero e a âncora não será movida. Se a âncora for adjacente à região desejada, pfNoRegion receberá zero e a âncora será movida para a região.

Requisitos


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