Condividi tramite


Metodo ITextServices::OnTxPropertyBitsChange (textserv.h)

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

Vedi anche

Informazioni concettuali

ITextServices

Altre risorse

RECT

Riferimento

TxGetAcceleratorPos

TxGetBackStyle

TxGetClientRect

TxGetPasswordChar

TxSetText

Controlli Rich Edit senza finestre