CDC::escape

Artigo
06/10/2015

Essa função de membro é praticamente obsoleta para a programação do Win32.

virtual int Escape( 
   int nEscape, 
   int nCount, 
   LPCSTR lpszInData, 
   LPVOID lpOutData  
); 
int Escape( 
   int nEscape, 
   int nInputSize, 
   LPCSTR lpszInputData, 
   int nOutputSize, 
   LPSTR lpszOutputData  
);

Parâmetros

nEscape
Especifica a função de escape a ser executada.

Para obter uma lista completa de funções de escape, consulte escape em Windows SDK.
nCount
Especifica o número de bytes de dados apontados por lpszInData.
lpszInData
Pontos a estrutura de dados de entrada necessária para este escape.
lpOutData
Pontos a estrutura que é receber saída de esse escape. o parâmetro de lpOutData é NULO se nenhum dados é retornado.
nInputSize
Especifica o número de bytes de dados apontados pelo parâmetro de lpszInputData .
lpszInputData
Pontos a estrutura de entrada necessária para o escape especificado.
nOutputSize
Especifica o número de bytes de dados apontados pelo parâmetro de lpszOutputData .
lpszOutputData
Pontos a estrutura que recebe saída de esse escape. Este parâmetro deve ser NULO se nenhum dados é retornado.

Valor de retorno

Um valor positivo é retornado se a função é bem-sucedida, exceto para o escape de QUERYESCSUPPORT , que verifica somente a existência da implementação. Zero são retornados se o escape não é implementado. Um valor negativo é retornado se um erro ocorrer. Os seguintes valores são comuns de erro:

Erro de gerais deSP_ERROR .
SP_OUTOFDISK não espaço suficiente em disco está disponível no momento para rolar, e não será mais espaço disponível.
SP_OUTOFMEMORY memória suficiente não está disponível para rolar.
O usuário terminou deSP_USERABORT funciona através do gerenciador de impressão.

Comentários

Os escapes de impressora de original, somente QUERYESCSUPPORT é suportado para aplicações Win32. Todos outros vazamentos de impressora estão obsoletos e são suportados apenas para compatibilidade com aplicativos de 16 bits.

Para que O programa, CDC agora fornece seis funções de membro que substituem suas referências correspondentes da impressora:

Além de isso, os índices do Win32 de suporte de CDC::GetDeviceCaps que substituem outra impressora escapam. Consulte GetDeviceCaps em Windows SDK para mais informações.

Essa função de membro permite que aplicativos acessar os recursos de um dispositivo específico que não são diretamente GDI módulos disponíveis.

Use a primeira versão se seu aplicativo usa para escapam valores predefinidos. Use a segunda versão se seu aplicativo define valores exclusivos de escape. Consulte ExtEscape em Windows SDK para obter mais informações sobre a segunda versão.