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 |
|---|---|
|
Se TRUE, o bipe estará habilitado. |
|
Se TRUE, o recurso AutoWordSelect estará habilitado. |
|
Se TRUE, o backstyle foi alterado. Consulte TxGetBackStyle. |
|
Se TRUE, o formato de caractere foi alterado. |
|
Se TRUE, o retângulo do cliente foi alterado. |
|
Se TRUE, arrastar será desabilitado. |
|
Use Direct2D/DirectWrite para essa instância e não GDI/Uniscribe. |
|
Renderize glifos para as posições de pixel mais próximas. Válido somente se D2DDWRITE estiver definido. |
|
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. |
|
Renderize texto usando tipografia simples (sem renderização de glifo). Esse valor será válido somente se TXTBIT_D2DDWRITE também for especificado. |
|
Se TRUE, o tamanho do retângulo do cliente foi alterado. |
|
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. |
|
Se TRUE, o comprimento máximo do texto no controle foi alterado. |
|
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. |
|
Não faça referência a dados TLS em nome dessa instância. |
|
Se TRUE, o formato do parágrafo foi alterado. |
|
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. |
|
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. |
|
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. |
|
Se TRUE, a barra de rolagem foi alterada. |
|
Se TRUE, a largura da barra de seleção foi alterada |
|
Se definido, o caractere de acelerador deve ser sublinhado.
Isso deve ser definido para chamar TxGetAcceleratorPos. |
|
Mostrar cadeias de caracteres de senha. |
|
Não há suporte. |
|
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). |
|
Não há suporte. |
|
Se TRUE, o inset foi alterado. |
|
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 |
|---|---|
|
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
Outros recursos
Referência
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de