Compartilhar via


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
Richedit.h

Confira também

Referência

EDITSTREAM

Editstreamcallback

EM_STREAMIN