CDC::Escape

Artigo
08/25/2010

Essa função de membro é praticamente obsoleta para programação 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 para ser executada.

Para obter uma lista completa das funções de escape, consulte Escape in the Windows SDK.
nCount
Especifica o número de bytes de dados apontados por lpszInData.
lpszInData
Aponta para a estrutura de dados de entrada necessário para esta escape.
lpOutData
Aponta para a estrutura que deve receber saída desse escape.The lpOutData o parâmetro é NULO se nenhum dados é retornado.
nInputSize
Especifica o número de bytes de dados apontados pelo lpszInputData parâmetro.
lpszInputData
Aponta para a estrutura de entrada necessário para escape especificada.
nOutputSize
Especifica o número de bytes de dados apontados pelo lpszOutputData parâmetro.
lpszOutputData
Aponta para a estrutura que recebe saída desse escape.Esse parâmetro deve ser NULO se nenhum dado é retornado.

Valor de retorno

Um valor positivo é retornado se a função for bem-sucedida, exceto para o QUERYESCSUPPORT escape, que apenas verifica a implementação.Zero será retornado se o escape não está implementado.Um valor negativo é retornado se ocorreu um erro.Valores de erro comuns são:

SP_ERROR Erro geral.
SP_OUTOFDISK Não há espaço suficiente em disco é atualmente disponíveis para o spool, e não há mais espaço ficará disponível.
SP_OUTOFMEMORY Não há memória suficiente está disponível para o spool.
SP_USERABORT Usuário terminou o trabalho por meio do Gerenciador de impressão.

Comentários

Da escapa impressora original, somente QUERYESCSUPPORT há suporte para aplicativos Win32.Todos os outros sai da impressora está obsoleto e têm suporte somente para compatibilidade com aplicativos de 16 bit.

Para programação do Win32, CDC agora fornece seis funções de membro substituem seus escapa de impressora correspondente:

Além disso, CDC::GetDeviceCaps oferece suporte a índices Win32 que substituem outros sai da impressora.See GetDeviceCaps in the Windows SDK Para obter mais informações.

Essa função de membro permite que aplicativos acessem os recursos de um determinado dispositivo que não estão diretamente disponível por meio da GDI.

Use a primeira versão se seu aplicativo usa os valores de escape predefinidos.Use a segunda versão se seu aplicativo define os valores de escape particular.See ExtEscape in the Windows SDK Para obter mais informações sobre a segunda versão.