Metodo ITextServices::OnTxInPlaceActivate (textserv.h)

Articolo
08/26/2023

Notifica all'oggetto servizi di testo che questo controllo è attivo sul posto.

Sintassi

HRESULT OnTxInPlaceActivate(
  [in] LPCRECT prcClient
);

Parametri

[in] prcClient

Tipo: const RECT*

Rettangolo client del controllo.

Valore restituito

Tipo: HRESULT

Se l'oggetto viene attivato correttamente, il valore restituito viene S_OK.

Se non è stato possibile attivare l'oggetto a causa di un errore, il valore restituito viene E_FAIL. Per altre informazioni sui codici di errore COM, vedere Gestione degli errori in COM.

Commenti

Attivo sul posto significa che un oggetto incorporato è in esecuzione sul posto (ad esempio, per controlli regolari e incorporamenti, avrebbe una finestra in cui disegnare). Al contrario, l'interfaccia utente attiva indica che attualmente un oggetto ha lo stato attivo per la modifica. Ad esempio, elementi come menu e barre degli strumenti nel contenitore possono contenere anche elementi del controllo/incorporamento attivi dell'interfaccia utente. È presente un solo controllo attivo dell'interfaccia utente in qualsiasi momento, mentre possono essere presenti molti controlli attivi sul posto.

Nota, l'attivazione dell'interfaccia utente è diversa da quella di ottenere lo stato attivo. Per segnalare all'oggetto servizi di testo che il controllo riceve o perde lo stato attivo, l'host invia messaggi WM_SETFOCUS e WM_KILLFOCUS . Si noti inoltre che un host senza finestra passerà NULL come wParam (finestra che ha perso lo stato attivo) per questi messaggi.

Quando si effettua la transizione direttamente da uno stato non attivo allo stato attivo dell'interfaccia utente, l'host deve chiamare prima ITextServices::OnTxInPlaceActivate e quindi ITextServices::OnTxUIActivate.

ITextServices::OnTxInPlaceActivate accetta come parametro il rettangolo client della visualizzazione da attivare. Questo rettangolo viene specificato nelle coordinate client della finestra contenitore. È lo stesso ottenuto chiamando TxGetClientRect nell'host.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	textserv.h
DLL	Msftedit.dll