Compartir a través de


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

Establece las propiedades (representadas por bits) para el control.

Sintaxis

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

Parámetros

[in] dwMask

Tipo: DWORD

Bits que representan las propiedades que se van a cambiar. Para conocer los valores de bits posibles, consulte la lista de valores de TXTBIT_* en dwBits.

[in] dwBits

Tipo: DWORD

Nuevos valores para las propiedades de bits. Puede ser cualquier combinación de lo siguiente.

Valor Significado
TXTBIT_ALLOWBEEP
Si es TRUE, el pitido está habilitado.
TXTBIT_AUTOWORDSEL
Si es TRUE, la característica AutoWordSelect está habilitada.
TXTBIT_BACKSTYLECHANGE
Si es TRUE, el estilo trasero cambió. Consulte TxGetBackStyle.
TXTBIT_CHARFORMATCHANGE
Si es TRUE, el formato de caracteres cambió.
TXTBIT_CLIENTRECTCHANGE
Si es TRUE, el rectángulo del cliente cambió.
TXTBIT_DISABLEDRAG
Si es TRUE, el arrastre está deshabilitado.
TXTBIT_D2DDWRITE
Use Direct2D/DirectWrite para esta instancia y no GDI/Uniscribe.
TXTBIT_D2DPIXELSNAPPED
Representar glifos en las posiciones de píxeles más cercanas. Válido solo si se establece D2DDWRITE.
TXTBIT_D2DSUBPIXELLINES
Dibuje líneas con precisión de subpíxel. No ajuste las líneas de texto de ajuste de píxeles, el subrayado y el tachado en la dirección del flujo de texto secundario (normalmente vertical). Válido solo si se establece D2DDWRITE y no se establece D2DPIXELSNAPPED.
TXTBIT_D2DSIMPLETYPOGRAPHY
Representar texto mediante tipografía simple (sin representación de glifo). Este valor solo es válido si también se especifica TXTBIT_D2DDWRITE.
TXTBIT_EXTENTCHANGE
Si es TRUE, el tamaño del rectángulo de cliente cambió.
TXTBIT_HIDESELECTION
Si es TRUE, el objeto de servicios de texto debe ocultar la selección cuando el control está inactivo. Si es FALSE, la selección debe mostrarse cuando el control está inactivo.

Tenga en cuenta que esto implica que TXTBIT_SAVESELECTION es TRUE.

TXTBIT_MAXLENGTHCHANGE
Si es TRUE, la longitud máxima para el texto del control ha cambiado.
TXTBIT_MULTILINE
Si es TRUE, el objeto de servicios de texto debe funcionar en modo multilínea. Use el valor TXTBIT_WORDWRAP para determinar si se deben ajustar las líneas al rectángulo de vista o recortarlas.

Si es FALSE, el objeto de servicios de texto no debe procesar un retorno de carro o una fuente de línea desde la tecla ENTRAR y debe truncar el texto entrante que contiene saltos de línea duros justo antes del primer salto de línea. También es aceptable truncar texto que se establece con ITextServices::TxSetText, ya que es responsabilidad del host no usar un control de una sola línea cuando se enlaza a un campo de varias líneas.

TXTBIT_NOTHREADREFCOUNT
No haga referencia a datos TLS en nombre de esta instancia.
TXTBIT_PARAFORMATCHANGE
Si es TRUE, el formato de párrafo cambió.
TXTBIT_READONLY
Si es TRUE, el objeto de servicios de texto no debe aceptar ningún cambio de edición a través de la interfaz de usuario. Sin embargo, todavía debe aceptar cambios mediante programación a través de EM_SETTEXTEX, EM_REPLACESEL e ITextServices::TxSetText. Además, el usuario todavía debe poder mover el punto de inserción, seleccionar texto y llevar a cabo otras operaciones que no modifiquen el contenido, como Copiar.
TXTBIT_RICHTEXT
Si es TRUE, el objeto de servicios de texto debe estar en modo de texto enriquecido.

Si es FALSE, está en modo de texto sin formato.

Tenga en cuenta que esto afecta a cómo se aplican los comandos de edición. Por ejemplo, aplicar negrita a parte del texto en un control de edición sin formato hace que todo el texto se en negrita. Sin embargo, para un control de edición enriquecida, esto hace que solo el texto seleccionado se en negrita.

TXTBIT_SAVESELECTION
Si es TRUE, los límites de la selección se deben guardar cuando el control está inactivo.

Si es FALSE, cuando el control vuelve a activarse, se pueden restablecer los límites de selección para iniciar = 0, longitud = 0.

TXTBIT_SCROLLBARCHANGE
Si es TRUE, la barra de desplazamiento ha cambiado.
TXTBIT_SELBARCHANGE
Si es TRUE, el ancho de la barra de selección ha cambiado.
TXTBIT_SHOWACCELERATOR
Si se establece, el carácter de acelerador debe estar subrayado.

Debe establecerse para llamar a TxGetAcceleratorPos.

TXTBIT_SHOWPASSWORD
Mostrar cadenas de contraseña.
TXTBIT_USECURRENTBKG
No compatible.
TXTBIT_USEPASSWORD
Si es TRUE, muestre el texto con el carácter de contraseña obtenido por TxGetPasswordChar.

La notificación de esta propiedad puede significar que el carácter de contraseña cambió o que el carácter de contraseña no se usó antes, pero se usa ahora (o viceversa).

TXTBIT_VERTICAL
No compatible.
TXTBIT_VIEWINSETCHANGE
Si es TRUE, el conjunto ha cambiado.
TXTBIT_WORDWRAP
Si TRUE y TXTBIT_MULTILINE también es TRUE, los controles de varias líneas deben encapsular la línea en el rectángulo de vista. Si esta propiedad es FALSE y TXTBIT_MULTILINE es TRUE, las líneas no se deben encapsular pero recortar. Se debe omitir el lado derecho del rectángulo de vista.

Si TXTBIT_MULTILINE es FALSE, esta propiedad no tiene ningún efecto.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto se S_OK.

Si se produce un error en el método, el valor devuelto es el siguiente código HRESULT . Para obtener más información sobre los códigos de error COM, vea Control de errores en COM.

Código devuelto Descripción
E_NOTIMPL
Sin implementar.

Comentarios

El rectángulo de cliente es el rectángulo que el objeto de servicios de texto es responsable de pintar y administrar. El host se basa en el objeto de servicios de texto para pintar esa área. El objeto de servicios de texto no debe pintar ni invalidar áreas fuera de ese rectángulo. Además, el host reenviará los mensajes del mouse al objeto de servicios de texto cuando el cursor esté sobre este rectángulo. Este rectángulo se expresa en coordenadas de cliente de la ventana contenedora.

El conjunto de vistas es la cantidad de espacio en cada lado entre el rectángulo de cliente y el rectángulo de vista. El rectángulo de vista (también denominado rectángulo de formato) es el rectángulo en el que se debe dar formato al texto. Para obtener más información, vea TxGetViewInset.

El estilo trasero es el estilo del fondo del rectángulo de cliente. Puede ser TXTBACK_TRANSPARENT o TXTBACK_SOLID. Consulte TXTBACKSTYLE.

La propiedad de barra de desplazamiento indica cambios en la barra de desplazamiento: qué barra de desplazamiento está presente, si las barras de desplazamiento están ocultas o deshabilitadas cuando el desplazamiento es imposible y también si el desplazamiento automático está habilitado cuando el punto de inserción sale del rectángulo del cliente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado textserv.h
Archivo DLL Msftedit.dll

Consulte también

Conceptual

ITextServices

Otros recursos

RECT

Referencia

TxGetAcceleratorPos

TxGetBackStyle

TxGetClientRect

TxGetPasswordChar

TxSetText

Controles de edición enriquecida sin ventanas