Freigeben über


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
TXTBIT_ALLOWBEEP
Wenn TRUE, ist das Pieping aktiviert.
TXTBIT_AUTOWORDSEL
Bei TRUE ist das AutoWordSelect-Feature aktiviert.
TXTBIT_BACKSTYLECHANGE
Wenn TRUE, hat sich die Hintergrundart geändert. Siehe TxGetBackStyle.
TXTBIT_CHARFORMATCHANGE
Bei TRUE hat sich das Zeichenformat geändert.
TXTBIT_CLIENTRECTCHANGE
Bei TRUE hat sich das Clientrechteck geändert.
TXTBIT_DISABLEDRAG
Bei TRUE ist das Ziehen deaktiviert.
TXTBIT_D2DDWRITE
Verwenden Sie Direct2D/DirectWrite für diese instance und nicht GDI/Uniscribe.
TXTBIT_D2DPIXELSNAPPED
Rendern von Glyphen an die nächstgelegenen Pixelpositionen. Nur gültig, wenn D2DDWRITE festgelegt ist.
TXTBIT_D2DSUBPIXELLINES
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.
TXTBIT_D2DSIMPLETYPOGRAPHY
Rendern von Text mit einfacher Typografie (kein Glyphenrendering). Dieser Wert ist nur gültig, wenn auch TXTBIT_D2DDWRITE angegeben ist.
TXTBIT_EXTENTCHANGE
Bei TRUE hat sich die Größe des Clientrechtecks geändert.
TXTBIT_HIDESELECTION
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.

TXTBIT_MAXLENGTHCHANGE
Bei TRUE hat sich die maximale Länge für Text im Steuerelement geändert.
TXTBIT_MULTILINE
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.

TXTBIT_NOTHREADREFCOUNT
Verweisen Sie nicht im Namen dieses instance auf TLS-Daten.
TXTBIT_PARAFORMATCHANGE
Bei TRUE hat sich das Absatzformat geändert.
TXTBIT_READONLY
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.
TXTBIT_RICHTEXT
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.

TXTBIT_SAVESELECTION
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.

TXTBIT_SCROLLBARCHANGE
Bei TRUE hat sich die Bildlaufleiste geändert.
TXTBIT_SELBARCHANGE
Bei TRUE hat sich die Breite der Auswahlleiste geändert.
TXTBIT_SHOWACCELERATOR
Wenn dieser Wert festgelegt ist, sollte das Zugriffstastenzeichen unterstrichen werden.

Dies muss festgelegt werden, um TxGetAcceleratorPos aufzurufen.

TXTBIT_SHOWPASSWORD
Kennwortzeichenfolgen anzeigen.
TXTBIT_USECURRENTBKG
Wird nicht unterstützt.
TXTBIT_USEPASSWORD
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).

TXTBIT_VERTICAL
Wird nicht unterstützt.
TXTBIT_VIEWINSETCHANGE
Wenn TRUE, hat sich die Einstellung geändert.
TXTBIT_WORDWRAP
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
E_NOTIMPL
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

ITextServices

Andere Ressourcen

RECT

Referenz

TxGetAcceleratorPos

TxGetBackStyle

TxGetClientRect

TxGetPasswordChar

TxSetText

Fensterlose Rich-Edit-Steuerelemente