EM_STREAMOUT mensagem
Faz com que um controle de edição avançada passe seu conteúdo para uma função de retorno de chamada EditStreamCallback definida pelo aplicativo. Em seguida, a função de retorno de chamada pode gravar o fluxo de dados em um arquivo ou em qualquer outro local escolhido.
Parâmetros
-
wParam
-
Especifica o formato de dados e as opções de substituição.
Esse valor deve ser um dos valores a seguir.
Valor Significado - SF_RTF
RTF. - SF_RTFNOOBJS
RTF com espaços no lugar de objetos COM. - SF_TEXT
Texto com espaços no lugar de objetos COM. - SF_TEXTIZED
Texto com uma representação de texto de objetos COM. A opção SF_RTFNOOBJS será útil se um aplicativo armazenar objetos COM em si, pois a representação RTF de objetos COM não é muito compacta. A palavra de controle \objattph, seguida por um espaço indica a posição do objeto.
Além disso, você pode especificar os sinalizadores a seguir.
Valor Significado - SFF_PLAINRTF
Se especificado, o controle de edição avançada transmitirá apenas as palavras-chave comuns a todos os idiomas, ignorando palavras-chave específicas do idioma. Se não for especificado, o controle de edição avançada transmitirá todas as palavras-chave. Você pode combinar esse sinalizador com o sinalizador SF_RTF ou SF_RTFNOOBJS . - SFF_SELECTION
Se especificado, o controle de edição avançada transmitirá apenas o conteúdo da seleção atual. Se não for especificado, o controle transmitirá todo o conteúdo. Você pode combinar esse sinalizador com qualquer um dos valores de formato de dados. - SF_UNICODE
Microsoft Rich Edit 2.0 e posterior: Indica texto Unicode. Você pode combinar esse sinalizador com o sinalizador SF_TEXT . - SF_USECODEPAGE
Edição Avançada 3.0 e posterior: Gera RTF UTF-8 e texto usando outras páginas de código. A página de código é definida na palavra alta de wParam. Por exemplo, para UTF-8 RTF, defina wParam como (CP_UTF8 << 16) | SF_USECODEPAGE | SF_RTF. -
lParam
-
Ponteiro para uma estrutura EDITSTREAM . Na entrada, o membro pfnCallback dessa estrutura deve apontar para uma função EditStreamCallback definida pelo aplicativo. Na saída, o membro dwError poderá conter um código de erro diferente de zero se ocorrer um erro.
Retornar valor
Essa mensagem retorna o número de caracteres gravados no fluxo de dados.
Comentários
Quando você envia uma mensagem EM_STREAMOUT , o controle de edição avançada faz chamadas repetidas para a função EditStreamCallback especificada pelo membro pfnCallback da estrutura EDITSTREAM . Cada vez que ele chama a função de retorno de chamada, o controle passa um buffer que contém uma parte do conteúdo do controle. Esse processo continua até que o controle tenha passado todo o conteúdo para a função de retorno de chamada ou até que ocorra um erro.
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] |
parâmetro |
|
Confira também
-
Referência