ITextServices::OnTxPropertyBitsChange-Methode (textserv.h)
Legt Eigenschaften (dargestellt durch Bits) für das Steuerelement fest.
Syntax
HRESULT OnTxPropertyBitsChange(
[in] DWORD dwMask,
[in] DWORD dwBits
);
Parameter
[in] dwMask
Typ: DWORD
Bits, die zu ändernde Eigenschaften darstellen. Die möglichen Bitwerte finden Sie in der Liste TXTBIT_*-Werte in dwBits.
[in] dwBits
Typ: DWORD
Neue Werte für Biteigenschaften. Dies kann eine beliebige Kombination der folgenden Sein.
| Wert | Bedeutung |
|---|---|
|
Wenn TRUE, ist das Pieping aktiviert. |
|
Bei TRUE ist das AutoWordSelect-Feature aktiviert. |
|
Wenn TRUE, hat sich die Hintergrundart geändert. Siehe TxGetBackStyle. |
|
Bei TRUE hat sich das Zeichenformat geändert. |
|
Bei TRUE hat sich das Clientrechteck geändert. |
|
Bei TRUE ist das Ziehen deaktiviert. |
|
Verwenden Sie Direct2D/DirectWrite für diese instance und nicht GDI/Uniscribe. |
|
Rendern von Glyphen an die nächstgelegenen Pixelpositionen. Nur gültig, wenn D2DDWRITE festgelegt ist. |
|
Zeichnen Sie Linien mit Subpixelgenauigkeit. Fügen Sie Textzeilen, Unterstrichen und Streichen nicht pixelgenau in die sekundäre Textflussrichtung (normalerweise vertikal) ein. Nur gültig, wenn D2DDWRITE festgelegt und D2DPIXELSNAPPED nicht festgelegt ist. |
|
Rendern von Text mit einfacher Typografie (kein Glyphenrendering). Dieser Wert ist nur gültig, wenn auch TXTBIT_D2DDWRITE angegeben ist. |
|
Bei TRUE hat sich die Größe des Clientrechtecks geändert. |
|
Bei TRUE sollte das Textdienstobjekt die Auswahl ausblenden, wenn das Steuerelement inaktiv ist. Bei FALSE sollte die Auswahl angezeigt werden, wenn das Steuerelement inaktiv ist.
Beachten Sie, dass dies impliziert, dass TXTBIT_SAVESELECTIONTRUE ist. |
|
Bei TRUE hat sich die maximale Länge für Text im Steuerelement geändert. |
|
Bei TRUE sollte das Textdienstobjekt im Mehrzeilenmodus funktionieren. Verwenden Sie den TXTBIT_WORDWRAP Wert, um zu bestimmen, ob die Linien in das Ansichtsrechteck umgebrochen oder beschnitten werden sollen.
Bei FALSE sollte das Textdienstobjekt keinen Wagenrücklauf/Zeilenvorschub aus der EINGABETASTE verarbeiten und eingehenden Text mit harten Zeilenumbrüchen kurz vor dem ersten Zeilenumbruch abschneiden. Es ist auch akzeptabel, Text abzuschneiden, der mit ITextServices::TxSetText festgelegt wird, da der Host dafür verantwortlich ist, kein einzeiliges Steuerelement zu verwenden, wenn es an ein mehrzeiliges Feld gebunden ist. |
|
Verweisen Sie nicht im Namen dieses instance auf TLS-Daten. |
|
Bei TRUE hat sich das Absatzformat geändert. |
|
Wenn TRUE, sollte das Textdienstobjekt keine Bearbeitungsänderungen über die Benutzeroberfläche akzeptieren. Sie sollte jedoch weiterhin programmgesteuerte Änderungen über EM_SETTEXTEX, EM_REPLACESEL und ITextServices::TxSetText akzeptieren. Außerdem sollte der Benutzer weiterhin in der Lage sein, die Einfügemarke zu verschieben, Text auszuwählen und andere Vorgänge auszuführen, die inhalte nicht ändern, z. B. Kopieren. |
|
Bei TRUE sollte sich das Textdienstobjekt im Rich-Text-Modus befinden.
Wenn FALSE, befindet er sich im Nur-Text-Modus. Beachten Sie, dass sich dies darauf auswirkt, wie Bearbeitungsbefehle angewendet werden. Durch das Anwenden von Fettdruck auf einen Teil des Texts in einem Einfachen Bearbeitungssteuerelement wird der gesamte Text fett formatiert. Bei einem Rich-Edit-Steuerelement wird dadurch jedoch nur der ausgewählte Text fett formatiert. |
|
Bei TRUE sollten die Grenzen der Auswahl gespeichert werden, wenn das Steuerelement inaktiv ist.
Bei FALSE können die Auswahlgrenzen zurückgesetzt werden, wenn das Steuerelement wieder aktiv wird, auf start = 0, length = 0. |
|
Bei TRUE hat sich die Bildlaufleiste geändert. |
|
Bei TRUE hat sich die Breite der Auswahlleiste geändert. |
|
Wenn dieser Wert festgelegt ist, sollte das Zugriffstastenzeichen unterstrichen werden.
Dies muss festgelegt werden, um TxGetAcceleratorPos aufzurufen. |
|
Kennwortzeichenfolgen anzeigen. |
|
Wird nicht unterstützt. |
|
Bei TRUE wird Text mit dem Kennwortzeichen angezeigt, das von TxGetPasswordChar abgerufen wurde.
Die Benachrichtigung zu dieser Eigenschaft kann bedeuten, dass sich das Kennwortzeichen geändert hat oder dass das Kennwortzeichen nicht zuvor verwendet wurde, sondern jetzt verwendet wird (oder umgekehrt). |
|
Wird nicht unterstützt. |
|
Wenn TRUE, hat sich die Einstellung geändert. |
|
Wenn TRUE und TXTBIT_MULTILINE ebenfalls TRUE sind, sollten mehrzeilige Steuerelemente die Zeile in das Ansichtsrechteck umschließen. Wenn diese Eigenschaft FALSE und TXTBIT_MULTILINETRUE ist, sollten die Zeilen nicht umschlossen, sondern beschnitten werden. Die rechte Seite des Ansichtsrechtecks sollte ignoriert werden.
Wenn TXTBIT_MULTILINEFALSE ist, hat diese Eigenschaft keine Auswirkung. |
Rückgabewert
Typ: HRESULT
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK.
Wenn die Methode fehlschlägt, ist der Rückgabewert der folgende HRESULT-Code . Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung in COM.
| Rückgabecode | Beschreibung |
|---|---|
|
Nicht implementiert. |
Hinweise
Das Clientrechteck ist das Rechteck, das das Textdienstobjekt für das Malen und Verwalten verantwortlich ist. Der Host verlässt sich auf das Textdienstobjekt zum Zeichnen dieses Bereichs. Das Textdienstobjekt darf keine Bereiche außerhalb dieses Rechtecks zeichnen oder ungültig werden. Darüber hinaus leitet der Host Mausnachrichten an das Textdienstobjekt weiter, wenn sich der Cursor über diesem Rechteck befindet. Dieses Rechteck wird in Clientkoordinaten des enthaltenden Fensters ausgedrückt.
Der Sichteinsatz ist der Speicherplatz auf jeder Seite zwischen dem Clientrechteck und dem Sichtrechteck. Das Ansichtsrechteck (auch als Formatierungsrechteck bezeichnet) ist das Rechteck, in dem der Text formatiert werden soll. Weitere Informationen finden Sie unter TxGetViewInset.
Der Hintergrundstil ist der Stil des Hintergrunds des Clientrechtecks. Es kann entweder TXTBACK_TRANSPARENT oder TXTBACK_SOLID sein. Siehe TXTBACKSTYLE.
Die Scrollleisteneigenschaft gibt Änderungen an der Bildlaufleiste an: Welche Bildlaufleiste vorhanden ist, ob Bildlaufleisten ausgeblendet oder deaktiviert sind, wenn das Scrollen unmöglich ist, und auch, wenn das automatische Scrollen aktiviert ist, wenn die Einfügemarke aus dem Clientrechteck ausgeht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | textserv.h |
| DLL | Msftedit.dll |
Siehe auch
Konzept
Andere Ressourcen
Referenz