CDC::Escape

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.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CDC

Gráfico de hierarquia

CDC::ResetDC

EnumObjects

Outros recursos

Membros do CDC