Metodo ITfRange::AdjustForInsert (msctf.h)

Articolo
03/08/2023

Il metodo ITfRange::AdjustForInsert espande o crea un intervallo di testo da modificare per l'inserimento di testo.

Sintassi

HRESULT AdjustForInsert(
  [in]  TfEditCookie ec,
  [in]  ULONG        cchInsert,
  [out] BOOL         *pfInsertOk
);

Parametri

[in] ec

Modificare il cookie ottenuto da ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.

[in] cchInsert

Numero di caratteri del testo inserito. Questo conteggio viene usato in una chiamata futura a ITfRange::SetText. Se il conteggio dei caratteri è sconosciuto, è possibile usare 0.

[out] pfInsertOk

Puntatore a un flag che indica se il proprietario del contesto accetta (TRUE) o rifiuta (FALSE) l'inserimento.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_FAIL	Il metodo non è riuscito.
E_INVALIDARG	Uno o più parametri non sono validi.
E_NOTIMPL	L'applicazione non è riuscita a sostituire la selezione.
TF_E_NOLOCK	Il valore nel parametro ec è un cookie non valido oppure il chiamante non ha un blocco di sola lettura.

Commenti

Questo metodo deve essere usato per preparare un intervallo per avviare una nuova composizione, prima di iniziare la modifica. Deve essere usato solo quando il testo non viene inserito nella selezione corrente. ITFInsertAtSelection:InsertTextAtSelection o ITfInsertAtSelection::InsertEmbeddedAtSelection sono i metodi corretti da usare quando il testo viene inserito nella selezione corrente.

Il proprietario del contesto può usare questo metodo per mantenere il comportamento e mantenere un'esperienza utente coerente. Ad esempio, alcuni caratteri o oggetti nel contesto possono essere conservati dalle modifiche o la sovratipizzazione può essere supportata.

Questo metodo non è necessario quando si modifica una composizione esistente. È accettabile chiamare ITfRange::SetText direttamente per modificare il testo immesso in precedenza dal chiamante.

Se *pfInsertOk è impostato su FALSE, una chiamata futura a ITfRange::SetText o ITfRange::InsertEmbeddeded con questo intervallo potrebbe non riuscire. In caso contrario, *pfInsertOk verrà impostato su TRUE e l'ancoraggio iniziale o finale dell'intervallo può essere riposizionato a discrezione del proprietario del contesto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	msctf.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional