CDC::Escape

このメンバー関数は、Win32 プログラミングの仮想互換性のために残されています。

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

パラメーター

• nEscape
  エスケープ実行される関数を指定します。

  エスケープ関数の一覧については、Windows SDKの [エスケープ] を参照してください。

• nCount
  lpszInDataが指すデータのバイト数を指定します。

• lpszInData
  このエスケープに必要な入力データ構造体へのポインター。

• lpOutData
  このエスケープからの出力を受け取ることになっている構造体へのポインター。lpOutData のパラメーターは、データが返されない場合 null です。

• nInputSize
  lpszInputData のパラメーターが指すデータのバイト数を指定します。

• lpszInputData
  指定したエスケープに必要な入力構造体へのポインター。

• nOutputSize
  lpszOutputData のパラメーターが指すデータのバイト数を指定します。

• lpszOutputData
  このエスケープからの出力を受け取る構造体へのポインター。このパラメーターは、データが返されない場合 null 必要があります。

戻り値

正の値は関数は、の実装であるように、対応する QUERYESCSUPPORT のエスケープを除き、成功した場合はを返します。ゼロはエスケープが実行されて返されます。負の値はエラーが発生した場合はを返します。次は、一般的なエラーの値です:

• SP_ERROR の一般的なエラー。

• SP_OUTOFDISK は十分なディスク容量巻くために現在使用できないし、その空白は使用できません。

• SP_OUTOFMEMORY は十分なメモリ巻くに使用できません。

• SP_USERABORT のユーザーは、マネージャーで印刷ジョブを終了します。

解説

元ののプリンター エスケープの QUERYESCSUPPORT のみ、Win32 アプリケーションでサポートされます。他のすべてのプリンター エスケープは廃止され、16 ビット アプリケーションの互換性のためにのみサポートされます。

Win32 プログラムするに CDC は、対応するプリンターのエスケープされた優先される 6 種類のメンバー関数を提供します:

• CDC::AbortDoc

• CDC::EndDoc

• CDC::EndPage

• CDC::SetAbortProc

• CDC::StartDoc

• CDC::StartPage

また、の代わり CDC::GetDeviceCaps サポートの Win32 のインデックスは、他のプリンター エスケープします。詳細については、Windows SDK の GetDeviceCaps を参照してください。

このメンバー関数は、GDI で直接使用できない特定のデバイスの機能にアクセスするアプリケーションができます。

値が定義したアプリケーションを使用してをエスケープする場合は、最初のバージョンを使用します。アプリケーションのプライベートのエスケープ値を定義する 2 番目のバージョンを使用します。2 番目のバージョンに関する詳細については、Windows SDK の ExtEscape を参照してください。

必要条件

ヘッダー: afxwin.h

参照

関連項目

CDC クラス

階層図

CDC::ResetDC

EnumObjects