Metodo ITextHost::TxActivate (textserv.h)
Notifica all'host di testo che il controllo è attivo.
Sintassi
HRESULT TxActivate(
LONG *plOldState
);
Parametri
plOldState
Tipo: LONG*
Stato di attivazione precedente.
Valore restituito
Tipo: HRESULT
Restituisce S_OK se il metodo ha esito positivo.
Restituisce il codice di errore COM seguente se il metodo ha esito negativo. Per altre informazioni sui codici di errore COM, vedere Gestione degli errori in COM.
| Codice restituito | Descrizione |
|---|---|
|
L'attivazione non è possibile in questo momento. |
Commenti
È legale che l'host rifiuti una richiesta di attivazione; ad esempio, il controllo può essere ridotto al minimo e quindi invisibile.
Il chiamante deve essere in grado di gestire correttamente l'errore di attivazione.
Indipendentemente dal numero di chiamate di questo metodo, è necessaria una sola chiamata ITextHost::TxDeactivate per disattivare il controllo.
Questa funzione restituisce un handle opaco in plOldState. Il chiamante (oggetto servizi di testo) deve salvare questo handle e usarlo in una chiamata successiva a ITextHost::TxDeactivate.
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 |
Vedi anche
Informazioni concettuali
Riferimento