Metodo ITextServices::OnTxPropertyBitsChange (textserv.h)

Articolo
03/02/2024

Imposta le proprietà (rappresentate dai bit) per il controllo .

Sintassi

HRESULT OnTxPropertyBitsChange(
  [in] DWORD dwMask,
  [in] DWORD dwBits
);

Parametri

[in] dwMask

Tipo: DWORD

Bit che rappresentano le proprietà da modificare. Per i valori di bit possibili, vedere l'elenco dei valori TXTBIT_* in dwBits.

[in] dwBits

Tipo: DWORD

Nuovi valori per le proprietà di bit. Può essere una qualsiasi combinazione di quanto segue.

Valore	Significato
TXTBIT_ALLOWBEEP	Se TRUE, il beeping è abilitato.
TXTBIT_AUTOWORDSEL	Se TRUE, la funzionalità AutoWordSelect è abilitata.
TXTBIT_BACKSTYLECHANGE	Se TRUE, il backstyle è cambiato. Vedere TxGetBackStyle.
TXTBIT_CHARFORMATCHANGE	Se TRUE, il formato del carattere è cambiato.
TXTBIT_CLIENTRECTCHANGE	Se TRUE, il rettangolo client è cambiato.
TXTBIT_DISABLEDRAG	Se TRUE, il trascinamento è disabilitato.
TXTBIT_D2DDWRITE	Usare Direct2D/DirectWrite per questa istanza e non GDI/Uniscribe.
TXTBIT_D2DPIXELSNAPPED	Eseguire il rendering dei glifi nelle posizioni in pixel più vicine. Valido solo se D2DDWRITE è impostato.
TXTBIT_D2DSUBPIXELLINES	Disegnare linee con precisione subpixel. Non bloccare le linee di testo, la sottolineatura e lo barrato nella direzione del flusso di testo secondario (in genere verticale). Valido solo se D2DDWRITE è impostato e D2DPIXELSNAPPED non è impostato.
TXTBIT_D2DSIMPLETYPOGRAPHY	Eseguire il rendering del testo usando semplici tipografia (nessun rendering del glifo). Questo valore è valido solo se viene specificato anche TXTBIT_D2DDWRITE.
TXTBIT_EXTENTCHANGE	Se TRUE, le dimensioni del rettangolo client sono cambiate.
TXTBIT_HIDESELECTION	Se TRUE, l'oggetto servizi di testo deve nascondere la selezione quando il controllo è inattivo. Se FALSE, la selezione deve essere visualizzata quando il controllo è inattivo. Si noti che questo implica TXTBIT_SAVESELECTION è TRUE.
TXTBIT_MAXLENGTHCHANGE	Se TRUE, la lunghezza massima per il testo nel controllo è stata modificata.
TXTBIT_MULTILINE	Se TRUE, l'oggetto servizi di testo deve funzionare in modalità multilinea. Utilizzare il valore TXTBIT_WORDWRAP per determinare se eseguire il wrapping delle righe nel rettangolo di visualizzazione o ritagliarle. Se FALSE, l'oggetto servizi di testo non deve elaborare un avanzamento ritorno a capo/riga dalla chiave INVIO e deve troncare il testo in ingresso contenente interruzioni di riga rigida appena prima della prima interruzione di riga. È anche accettabile troncare il testo impostato con ITextServices::TxSetText, perché è responsabilità dell'host non usare un controllo a riga singola se associato a un campo multilinea.
TXTBIT_NOTHREADREFCOUNT	Non fare riferimento ai dati TLS per conto di questa istanza.
TXTBIT_PARAFORMATCHANGE	Se TRUE, il formato del paragrafo è stato modificato.
TXTBIT_READONLY	Se TRUE, l'oggetto servizi di testo non deve accettare alcuna modifica tramite l'interfaccia utente. Tuttavia, deve comunque accettare modifiche a livello di codice tramite EM_SETTEXTEX, EM_REPLACESEL e ITextServices::TxSetText. Inoltre, l'utente deve comunque essere in grado di spostare il punto di inserimento, selezionare il testo ed eseguire altre operazioni che non modificano il contenuto, ad esempio Copia.
TXTBIT_RICHTEXT	Se TRUE, l'oggetto servizi di testo deve essere in modalità RTF. Se FALSE, è in modalità testo normale. Si noti che ciò influisce sulla modalità di applicazione dei comandi di modifica. Ad esempio, l'applicazione del grassetto a parte del testo in un controllo di modifica normale rende l'intero testo in grassetto. Tuttavia, per un controllo di modifica rtf, questo rende solo il testo selezionato in grassetto.
TXTBIT_SAVESELECTION	Se TRUE, i limiti della selezione devono essere salvati quando il controllo è inattivo. Se FALSE, quando il controllo torna attivo, è possibile reimpostare i limiti di selezione per iniziare = 0, lunghezza = 0.
TXTBIT_SCROLLBARCHANGE	Se TRUE, la barra di scorrimento è stata modificata.
TXTBIT_SELBARCHANGE	Se TRUE, la larghezza della barra di selezione è stata modificata
TXTBIT_SHOWACCELERATOR	Se impostato, il carattere di scelta rapida deve essere sottolineato. Questa impostazione deve essere impostata per chiamare TxGetAcceleratorPos.
TXTBIT_SHOWPASSWORD	Mostra stringhe password.
TXTBIT_USECURRENTBKG	Non supportato.
TXTBIT_USEPASSWORD	Se TRUE, visualizzare il testo usando il carattere password ottenuto da TxGetPasswordChar. La notifica su questa proprietà può indicare che il carattere della password è stato modificato o che il carattere della password non è stato usato prima, ma viene usato ora (o viceversa).
TXTBIT_VERTICAL	Non supportato.
TXTBIT_VIEWINSETCHANGE	Se TRUE, l'oggetto inset è stato modificato.
TXTBIT_WORDWRAP	Se TRUE e TXTBIT_MULTILINE è true, i controlli multilinea devono eseguire il wrapping della riga nel rettangolo di visualizzazione. Se questa proprietà è FALSE e TXTBIT_MULTILINE è TRUE, le righe non devono essere racchiuse ma ritagliate. Il lato destro del rettangolo di visualizzazione deve essere ignorato. Se TXTBIT_MULTILINE è FALSE, questa proprietà non ha alcun effetto.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito viene S_OK.

Se il metodo ha esito negativo, il valore restituito è il codice HRESULT seguente. Per altre informazioni sui codici di errore COM, vedere Gestione degli errori in COM.

Codice restituito	Descrizione
E_NOTIMPL	Non implementato.

Commenti

Il rettangolo client è il rettangolo che l'oggetto servizi di testo è responsabile della creazione e della gestione. L'host si basa sull'oggetto servizi di testo per disegnare tale area. L'oggetto servizi di testo non deve disegnare o invalidare aree al di fuori di tale rettangolo. Inoltre, l'host inoltra i messaggi del mouse all'oggetto servizi di testo quando il cursore si trova su questo rettangolo. Questo rettangolo è espresso nelle coordinate client della finestra contenitore.

L'inset di visualizzazione è la quantità di spazio su ogni lato tra il rettangolo client e il rettangolo di visualizzazione. Il rettangolo di visualizzazione (detto anche rettangolo di formattazione) è il rettangolo in cui deve essere formattato il testo. Per altre informazioni, vedere TxGetViewInset.

Il backstyle è lo stile dello sfondo del rettangolo client. Può essere TXTBACK_TRANSPARENT o TXTBACK_SOLID. Vedere TXTBACKSTYLE.

La proprietà della barra di scorrimento indica le modifiche apportate alla barra di scorrimento: la barra di scorrimento è presente, se le barre di scorrimento sono nascoste o disabilitate quando lo scorrimento è impossibile e anche se lo scorrimento automatico è abilitato quando il punto di inserimento si allontana dal rettangolo client.

Requisiti

Requisito	Valore
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