Metodo ITfContextOwnerCompositionServices::TerminateComposition (msctf.h)

Articolo
08/24/2023

Termina una composizione.

Sintassi

HRESULT TerminateComposition(
  [in] ITfCompositionView *pComposition
);

Parametri

[in] pComposition

Puntatore a un'interfaccia ITfCompositionView che rappresenta la composizione da terminare. Se questo valore è NULL, tutte le composizioni nel contesto vengono terminate.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
TF_E_DISCONNECTED	Il contesto non si trova in uno stack di documenti.
TF_E_NOLOCK	Un servizio di testo attualmente contiene un blocco sul documento.
E_UNEXPECTED	Questo metodo è stato chiamato durante un'altra operazione di composizione.
E_FAIL	Si è verificato un errore non specificato.

Commenti

Un servizio di testo usa ITfComposition::EndComposition per terminare una composizione creata.

Se il proprietario del contesto implementa l'archivio di testo, il proprietario del contesto deve essere in grado di concedere un blocco di scrittura sincrono prima di chiamare questo metodo.

Questo metodo esegue anche le operazioni seguenti:

Per ogni composizione terminata, ITfCompositionSink::OnCompositionTermitted viene chiamato per tutti i sink di composizione installati.
Se il proprietario del contesto ha installato una composizione del proprietario del contesto consiglia sink, ITfContextOwnerCompositionSink::OnEndComposition viene chiamato per ogni composizione terminata.
La proprietà GUID_PROP_COMPOSING verrà cancellata per il testo coperto da ogni composizione terminata.

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

Vedi anche

ITfComposition::EndComposition, nf-msctf-itfcompositionsink-oncompositiontermitted, interfaccia ITfCompositionView, interfaccia ITfContextOwnerCompositionServices, ITfContextOwnerCompositionSink::OnEndComposition

Condividi tramite