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

Define as propriedades (representadas por bits) para o controle .

Sintaxe

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

Parâmetros

[in] dwMask

Tipo: DWORD

Bits que representam as propriedades a serem alteradas. Para obter os valores de bit possíveis, consulte a lista de valores TXTBIT_* em dwBits.

[in] dwBits

Tipo: DWORD

Novos valores para propriedades de bit. Pode ser qualquer combinação do seguinte.

Valor Significado
TXTBIT_ALLOWBEEP
Se TRUE, o bipe estará habilitado.
TXTBIT_AUTOWORDSEL
Se TRUE, o recurso AutoWordSelect estará habilitado.
TXTBIT_BACKSTYLECHANGE
Se TRUE, o backstyle foi alterado. Consulte TxGetBackStyle.
TXTBIT_CHARFORMATCHANGE
Se TRUE, o formato de caractere foi alterado.
TXTBIT_CLIENTRECTCHANGE
Se TRUE, o retângulo do cliente foi alterado.
TXTBIT_DISABLEDRAG
Se TRUE, arrastar será desabilitado.
TXTBIT_D2DDWRITE
Use Direct2D/DirectWrite para essa instância e não GDI/Uniscribe.
TXTBIT_D2DPIXELSNAPPED
Renderize glifos para as posições de pixel mais próximas. Válido somente se D2DDWRITE estiver definido.
TXTBIT_D2DSUBPIXELLINES
Desenhar linhas com precisão de subpixel. Não ajuste linhas de texto, sublinhados e tachado na direção do fluxo de texto secundário (geralmente vertical). Válido somente se D2DDWRITE estiver definido e D2DPIXELSNAPPED não estiver definido.
TXTBIT_D2DSIMPLETYPOGRAPHY
Renderize texto usando tipografia simples (sem renderização de glifo). Esse valor será válido somente se TXTBIT_D2DDWRITE também for especificado.
TXTBIT_EXTENTCHANGE
Se TRUE, o tamanho do retângulo do cliente foi alterado.
TXTBIT_HIDESELECTION
Se TRUE, o objeto de serviços de texto deverá ocultar a seleção quando o controle estiver inativo. Se FALSE, a seleção deverá ser exibida quando o controle estiver inativo.

Observe que isso implica TXTBIT_SAVESELECTION é TRUE.

TXTBIT_MAXLENGTHCHANGE
Se TRUE, o comprimento máximo do texto no controle foi alterado.
TXTBIT_MULTILINE
Se TRUE, o objeto de serviços de texto deverá funcionar no modo multilinha. Use o valor TXTBIT_WORDWRAP para determinar se as linhas devem ser encapsuladas no retângulo de exibição ou recortá-las.

Se FALSE, o objeto de serviços de texto não deve processar um retorno de carro/alimentação de linha da tecla ENTER e deve truncar o texto de entrada que contém quebras de linha dura pouco antes da primeira quebra de linha. Também é aceitável truncar o texto definido com ITextServices::TxSetText, pois é responsabilidade do host não usar um controle de linha única quando associado a um campo de várias linhas.

TXTBIT_NOTHREADREFCOUNT
Não faça referência a dados TLS em nome dessa instância.
TXTBIT_PARAFORMATCHANGE
Se TRUE, o formato do parágrafo foi alterado.
TXTBIT_READONLY
Se TRUE, o objeto de serviços de texto não deverá aceitar nenhuma alteração de edição por meio da interface do usuário. No entanto, ele ainda deve aceitar alterações programáticas por meio de EM_SETTEXTEX, EM_REPLACESEL e ITextServices::TxSetText. Além disso, o usuário ainda deve ser capaz de mover o ponto de inserção, selecionar texto e executar outras operações que não modificam o conteúdo, como Copiar.
TXTBIT_RICHTEXT
Se TRUE, o objeto de serviços de texto deverá estar no modo rich-text.

Se for FALSE, ele estará no modo de texto sem formatação.

Observe que isso afeta a forma como os comandos de edição são aplicados. Por exemplo, aplicar negrito a parte do texto em um controle de edição sem formatação torna todo o texto em negrito. No entanto, para um controle de edição avançada, isso torna apenas o texto selecionado em negrito.

TXTBIT_SAVESELECTION
Se TRUE, os limites da seleção deverão ser salvos quando o controle estiver inativo.

Se FALSE, quando o controle ficar ativo novamente, os limites de seleção poderão ser redefinidos para iniciar = 0, comprimento = 0.

TXTBIT_SCROLLBARCHANGE
Se TRUE, a barra de rolagem foi alterada.
TXTBIT_SELBARCHANGE
Se TRUE, a largura da barra de seleção foi alterada
TXTBIT_SHOWACCELERATOR
Se definido, o caractere de acelerador deve ser sublinhado.

Isso deve ser definido para chamar TxGetAcceleratorPos.

TXTBIT_SHOWPASSWORD
Mostrar cadeias de caracteres de senha.
TXTBIT_USECURRENTBKG
Não há suporte.
TXTBIT_USEPASSWORD
Se TRUE, exiba o texto usando o caractere de senha obtido por TxGetPasswordChar.

A notificação nessa propriedade pode significar que o caractere de senha foi alterado ou que o caractere de senha não foi usado antes, mas é usado agora (ou vice-versa).

TXTBIT_VERTICAL
Não há suporte.
TXTBIT_VIEWINSETCHANGE
Se TRUE, o inset foi alterado.
TXTBIT_WORDWRAP
Se TRUE e TXTBIT_MULTILINE também for TRUE, os controles multilinha deverão encapsular a linha no retângulo de exibição. Se essa propriedade for FALSE e TXTBIT_MULTILINE for TRUE, as linhas não deverão ser encapsuladas, mas recortadas. O lado direito do retângulo de exibição deve ser ignorado.

Se TXTBIT_MULTILINE for FALSE, essa propriedade não terá efeito.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será S_OK.

Se o método falhar, o valor retornado será o código HRESULT a seguir. Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Código de retorno Descrição
E_NOTIMPL
Não implementado.

Comentários

O retângulo do cliente é o retângulo que o objeto de serviços de texto é responsável por pintar e gerenciar. O host depende do objeto de serviços de texto para pintar essa área. O objeto de serviços de texto não deve pintar ou invalidar áreas fora desse retângulo. Além disso, o host encaminhará mensagens do mouse para o objeto de serviços de texto quando o cursor estiver sobre esse retângulo. Esse retângulo é expresso nas coordenadas do cliente da janela que contém.

O conjunto de exibição é a quantidade de espaço em cada lado entre o retângulo do cliente e o retângulo de exibição. O retângulo de exibição (também chamado de retângulo formatação) é o retângulo no qual o texto deve ser formatado. Para obter mais informações, consulte TxGetViewInset.

O backstyle é o estilo da tela de fundo do retângulo do cliente. Pode ser TXTBACK_TRANSPARENT ou TXTBACK_SOLID. Consulte TXTBACKSTYLE.

A propriedade da barra de rolagem indica alterações na barra de rolagem: qual barra de rolagem está presente, se as barras de rolagem estão ocultas ou desabilitadas quando a rolagem é impossível e também se a rolagem automática está habilitada quando o ponto de inserção sai do retângulo do cliente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho textserv.h
DLL Msftedit.dll

Confira também

Conceitual

ITextServices

Outros recursos

RECT

Referência

TxGetAcceleratorPos

TxGetBackStyle

TxGetClientRect

TxGetPasswordChar

TxSetText

Controles de edição avançada sem janelas