Partager via


Méthode ITextServices ::OnTxPropertyBitsChange (textserv.h)

Définit les propriétés (représentées par des bits) pour le contrôle .

Syntaxe

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

Paramètres

[in] dwMask

Type : DWORD

Bits représentant les propriétés à modifier. Pour connaître les valeurs de bits possibles, consultez la liste des valeurs TXTBIT_* dans dwBits.

[in] dwBits

Type : DWORD

Nouvelles valeurs pour les propriétés de bits. Il peut s’agir de n’importe quelle combinaison des éléments suivants.

Valeur Signification
TXTBIT_ALLOWBEEP
Si la valeur est TRUE, le signal sonore est activé.
TXTBIT_AUTOWORDSEL
Si la valeur est TRUE, la fonctionnalité AutoWordSelect est activée.
TXTBIT_BACKSTYLECHANGE
Si la valeur est TRUE, le style arrière a changé. Consultez TxGetBackStyle.
TXTBIT_CHARFORMATCHANGE
Si la valeur est TRUE, le format du caractère a changé.
TXTBIT_CLIENTRECTCHANGE
Si la valeur est TRUE, le rectangle client a changé.
TXTBIT_DISABLEDRAG
Si la valeur est TRUE, le glissement est désactivé.
TXTBIT_D2DDWRITE
Utilisez Direct2D/DirectWrite pour cette instance, et non GDI/Uniscribe.
TXTBIT_D2DPIXELSNAPPED
Afficher les glyphes aux positions de pixels les plus proches. Valide uniquement si D2DDWRITE est défini.
TXTBIT_D2DSUBPIXELLINES
Dessinez des lignes avec une précision de sous-pixel. N’alignez pas les lignes de texte, le soulignement et le barré dans le sens du flux de texte secondaire (généralement vertical). Valide uniquement si D2DDWRITE est défini et D2DPIXELSNAPPED n’est pas défini.
TXTBIT_D2DSIMPLETYPOGRAPHY
Rendu du texte à l’aide d’une typographie simple (aucun rendu de glyphe). Cette valeur est valide uniquement si TXTBIT_D2DDWRITE est également spécifié.
TXTBIT_EXTENTCHANGE
Si la valeur est TRUE, la taille du rectangle client a changé.
TXTBIT_HIDESELECTION
Si la valeur est TRUE, l’objet services de texte doit masquer la sélection lorsque le contrôle est inactif. Si la valeur est FALSE, la sélection doit s’afficher lorsque le contrôle est inactif.

Notez que cela implique TXTBIT_SAVESELECTION a la valeur TRUE.

TXTBIT_MAXLENGTHCHANGE
Si la valeur est TRUE, la longueur maximale du texte dans le contrôle a changé.
TXTBIT_MULTILINE
Si la valeur est TRUE, l’objet services de texte doit fonctionner en mode multiligne. Utilisez la valeur TXTBIT_WORDWRAP pour déterminer s’il faut encapsuler les lignes dans le rectangle d’affichage ou les découper.

Si la valeur est FALSE, l’objet de services de texte ne doit pas traiter un retour chariot/flux de ligne à partir de la touche ENTRÉE et il doit tronquer le texte entrant contenant des sauts de ligne durs juste avant le premier saut de ligne. Il est également acceptable de tronquer le texte défini avec ITextServices ::TxSetText, car il est de la responsabilité de l’hôte de ne pas utiliser de contrôle à ligne unique lorsqu’il est lié à un champ multiligne.

TXTBIT_NOTHREADREFCOUNT
Ne référencez pas les données TLS pour le compte de ce instance.
TXTBIT_PARAFORMATCHANGE
Si la valeur est TRUE, le format du paragraphe a changé.
TXTBIT_READONLY
Si la valeur est TRUE, l’objet services de texte ne doit pas accepter de modification par le biais de l’interface utilisateur. Toutefois, il doit toujours accepter les modifications de programmation via EM_SETTEXTEX, EM_REPLACESEL et ITextServices ::TxSetText. En outre, l’utilisateur doit toujours être en mesure de déplacer le point d’insertion, de sélectionner du texte et d’effectuer d’autres opérations qui ne modifient pas le contenu, telles que Copier.
TXTBIT_RICHTEXT
Si la valeur est TRUE, l’objet services de texte doit être en mode texte enrichi.

Si la valeur est FALSE, elle est en mode texte brut.

Notez que cela affecte la façon dont les commandes d’édition sont appliquées. Par exemple, l’application de gras à une partie du texte dans un contrôle de modification simple rend le texte entier en gras. Toutefois, pour un contrôle d’édition enrichie, seul le texte sélectionné est mis en gras.

TXTBIT_SAVESELECTION
Si la valeur est TRUE, les limites de la sélection doivent être enregistrées lorsque le contrôle est inactif.

Si la valeur est FALSE, lorsque le contrôle redevient actif, les limites de sélection peuvent être réinitialisées pour démarrer = 0, longueur = 0.

TXTBIT_SCROLLBARCHANGE
Si la valeur est TRUE, la barre de défilement a changé.
TXTBIT_SELBARCHANGE
Si la valeur est TRUE, la largeur de la barre de sélection a changé
TXTBIT_SHOWACCELERATOR
S’il est défini, le caractère d’accélérateur doit être souligné.

Cette valeur doit être définie pour appeler TxGetAcceleratorPos.

TXTBIT_SHOWPASSWORD
Afficher les chaînes de mot de passe.
TXTBIT_USECURRENTBKG
Non pris en charge.
TXTBIT_USEPASSWORD
Si la valeur est TRUE, affichez le texte à l’aide du caractère de mot de passe obtenu par TxGetPasswordChar.

La notification sur cette propriété peut signifier que le caractère de mot de passe a changé ou que le caractère de mot de passe n’a pas été utilisé avant, mais qu’il est utilisé maintenant (ou vice versa).

TXTBIT_VERTICAL
Non pris en charge.
TXTBIT_VIEWINSETCHANGE
Si la valeur est TRUE, l’inset a changé.
TXTBIT_WORDWRAP
Si TRUE et TXTBIT_MULTILINE ont également la valeur TRUE, les contrôles multilignes doivent encapsuler la ligne dans le rectangle d’affichage. Si cette propriété a la valeur FALSE et que TXTBIT_MULTILINE a la valeur TRUE, les lignes ne doivent pas être encapsulées, mais coupées. Le côté droit du rectangle d’affichage doit être ignoré.

Si TXTBIT_MULTILINE a la valeur FALSE, cette propriété n’a aucun effet.

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est S_OK.

Si la méthode échoue, la valeur de retour est le code HRESULT suivant. Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs dans COM.

Code de retour Description
E_NOTIMPL
Non implémenté.

Remarques

Le rectangle client est le rectangle que l’objet text services est responsable de la peinture et de la gestion. L’hôte s’appuie sur l’objet text services pour peindre cette zone. L’objet de services de texte ne doit pas peindre ou invalider des zones en dehors de ce rectangle. En outre, l’hôte transfère les messages de la souris à l’objet services de texte lorsque le curseur se trouve sur ce rectangle. Ce rectangle est exprimé en coordonnées client de la fenêtre conteneur.

L’incrustage de vue est la quantité d’espace de chaque côté entre le rectangle client et le rectangle d’affichage. Le rectangle d’affichage (également appelé rectangle de mise en forme) est le rectangle dans lequel le texte doit être mis en forme. Pour plus d’informations, consultez TxGetViewInset.

Le style arrière-plan est le style de l’arrière-plan du rectangle client. Il peut être TXTBACK_TRANSPARENT ou TXTBACK_SOLID. Consultez TXTBACKSTYLE.

La propriété de barre de défilement indique les modifications apportées à la barre de défilement : quelle barre de défilement est présente, si les barres de défilement sont masquées ou désactivées lorsque le défilement est impossible, et également si le défilement automatique est activé lorsque le point d’insertion se détache du rectangle client.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête textserv.h
DLL Msftedit.dll

Voir aussi

Conceptuel

ITextServices

Autres ressources

RECT

Référence

TxGetAcceleratorPos

TxGetBackStyle

TxGetClientRect

TxGetPasswordChar

TxSetText

Contrôles d’édition enrichis sans fenêtre