次の方法で共有

CPSUI 指定の関数

  • [アーティクル]

重要

Windows でプリンターとの通信手段として推奨されるのは、最新の印刷プラットフォームです。 プリンターデバイス開発におけるWindows 10および11での印刷体験をカスタマイズするために、MicrosoftのIPPインボックスクラスドライバーとPrint Support Apps (PSA)の使用を推奨します。

詳細については、最新の印刷プラットフォームに関する記事および「印刷サポート アプリの設計ガイド」を参照してください 。

CPSUI は、アプリケーションに対して次の 2 つの重要な機能を提供します：

  • CommonPropertySheetUI

    CommonPropertySheetUI 関数は CPSUI のエントリ ポイントです。 この関数を使用すると、プロパティ シート ページが作成、表示され、ユーザーが表示、変更できるようになります。

    アプリケーションが CommonPropertySheetUI を呼び出すと、作成するページを記述するページ作成コールバックのアドレスが提供されます。 CPSUI はこのコールバックを呼び出して、ページの説明を取得します。 次に、ページが表示され、アプリケーション ユーザーがページに含まれる値を変更でき、ページ イベント コールバックを使用して 変更された値がアプリケーションに配信されます。 CommonPropertySheetUI 関数は、ユーザーが [OK] または [キャンセル] をクリックしてプロパティ シートを閉じるまで戻りません。

    プリンター インターフェイス DLL では、この関数は呼び出されないことに注意してください。これは、印刷スプーラーによって呼び出されます。

  • ComPropSheet

    ComPropSheet 関数は、CPSUI がプロパティ シート ページを作成して表示できるように、アプリケーションが CPSUI にプロパティ シート ページを記述する手段です。 CPSUI アプリケーションは、ページ作成コールバック内 からこの関数を呼び出します。 通常、ページの説明には、アプリケーション ユーザーがページ値を 変更したときに CPSUI によって呼び出されるページ イベント コールバックへのポインターが含まれます。

これらの関数が呼び出されるタイミングの詳細については、「プリンター ドライバーでの CPSUI の使用」を参照してください。

アプリケーション指定のダイアログ ボックス プロシージャでは、追加の 2 つの CPSUI 提供関数 SetCPSUIUserData と GetCPSUIUserData を使用して、アプリケーション指定の値を格納および取得できます。