Stapling 列挙型
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
プリンターが複数ページのドキュメントをステープル処理するかどうか、およびどの位置でステープル処理するかを指定します。
public enum class Staplingpublic enum Staplingtype Stapling = Public Enum Stapling- 継承
フィールド
| None | 10 | ドキュメントはステープル処理されません。 |
| SaddleStitch | 1 | 折り目に沿って複数回ステープル処理します。 中とじステープル処理とも呼ばれます。 |
| StapleBottomLeft | 2 | 左下隅に 1 回ステープル処理します。 |
| StapleBottomRight | 3 | 右下隅に 1 回ステープル処理します。 |
| StapleDualBottom | 7 | 下端に沿って 2 回ステープル処理します。 |
| StapleDualLeft | 4 | 左端に沿って 2 回ステープル処理します。 |
| StapleDualRight | 5 | 右端に沿って 2 回ステープル処理します。 |
| StapleDualTop | 6 | 上端に沿って 2 回ステープル処理します。 |
| StapleTopLeft | 8 | 左上隅に 1 回ステープル処理します。 |
| StapleTopRight | 9 | 右上隅に 1 回ステープル処理します。 |
| Unknown | 0 | 機能 (オプションはこの列挙体によって表されます) が、 印刷スキーマで定義されていないオプションに設定されます。 |
例
次の例は、プリンターの機能をテストし、それらを利用するように印刷ジョブを構成する方法を示しています。
// ---------------------- GetPrintTicketFromPrinter -----------------------
/// <summary>
/// Returns a PrintTicket based on the current default printer.</summary>
/// <returns>
/// A PrintTicket for the current local default printer.</returns>
PrintTicket^ GetPrintTicketFromPrinter ()
{
PrintQueue^ printQueue = nullptr;
LocalPrintServer^ localPrintServer = gcnew LocalPrintServer();
// Retrieving collection of local printer on user machine
PrintQueueCollection^ localPrinterCollection = localPrintServer->GetPrintQueues();
System::Collections::IEnumerator^ localPrinterEnumerator = localPrinterCollection->GetEnumerator();
if (localPrinterEnumerator->MoveNext())
{
// Get PrintQueue from first available printer
printQueue = ((PrintQueue^)localPrinterEnumerator->Current);
} else
{
return nullptr;
}
// Get default PrintTicket from printer
PrintTicket^ printTicket = printQueue->DefaultPrintTicket;
PrintCapabilities^ printCapabilities = printQueue->GetPrintCapabilities();
// Modify PrintTicket
if (printCapabilities->CollationCapability->Contains(Collation::Collated))
{
printTicket->Collation = Collation::Collated;
}
if (printCapabilities->DuplexingCapability->Contains(Duplexing::TwoSidedLongEdge))
{
printTicket->Duplexing = Duplexing::TwoSidedLongEdge;
}
if (printCapabilities->StaplingCapability->Contains(Stapling::StapleDualLeft))
{
printTicket->Stapling = Stapling::StapleDualLeft;
}
return printTicket;
};// end:GetPrintTicketFromPrinter()
// ---------------------- GetPrintTicketFromPrinter -----------------------
/// <summary>
/// Returns a PrintTicket based on the current default printer.</summary>
/// <returns>
/// A PrintTicket for the current local default printer.</returns>
private PrintTicket GetPrintTicketFromPrinter()
{
PrintQueue printQueue = null;
LocalPrintServer localPrintServer = new LocalPrintServer();
// Retrieving collection of local printer on user machine
PrintQueueCollection localPrinterCollection =
localPrintServer.GetPrintQueues();
System.Collections.IEnumerator localPrinterEnumerator =
localPrinterCollection.GetEnumerator();
if (localPrinterEnumerator.MoveNext())
{
// Get PrintQueue from first available printer
printQueue = (PrintQueue)localPrinterEnumerator.Current;
}
else
{
// No printer exist, return null PrintTicket
return null;
}
// Get default PrintTicket from printer
PrintTicket printTicket = printQueue.DefaultPrintTicket;
PrintCapabilities printCapabilities = printQueue.GetPrintCapabilities();
// Modify PrintTicket
if (printCapabilities.CollationCapability.Contains(Collation.Collated))
{
printTicket.Collation = Collation.Collated;
}
if ( printCapabilities.DuplexingCapability.Contains(
Duplexing.TwoSidedLongEdge) )
{
printTicket.Duplexing = Duplexing.TwoSidedLongEdge;
}
if (printCapabilities.StaplingCapability.Contains(Stapling.StapleDualLeft))
{
printTicket.Stapling = Stapling.StapleDualLeft;
}
return printTicket;
}// end:GetPrintTicketFromPrinter()
' ---------------------- GetPrintTicketFromPrinter -----------------------
''' <summary>
''' Returns a PrintTicket based on the current default printer.</summary>
''' <returns>
''' A PrintTicket for the current local default printer.</returns>
Private Function GetPrintTicketFromPrinter() As PrintTicket
Dim printQueue As PrintQueue = Nothing
Dim localPrintServer As New LocalPrintServer()
' Retrieving collection of local printer on user machine
Dim localPrinterCollection As PrintQueueCollection = localPrintServer.GetPrintQueues()
Dim localPrinterEnumerator As System.Collections.IEnumerator = localPrinterCollection.GetEnumerator()
If localPrinterEnumerator.MoveNext() Then
' Get PrintQueue from first available printer
printQueue = CType(localPrinterEnumerator.Current, PrintQueue)
Else
' No printer exist, return null PrintTicket
Return Nothing
End If
' Get default PrintTicket from printer
Dim printTicket As PrintTicket = printQueue.DefaultPrintTicket
Dim printCapabilities As PrintCapabilities = printQueue.GetPrintCapabilities()
' Modify PrintTicket
If printCapabilities.CollationCapability.Contains(Collation.Collated) Then
printTicket.Collation = Collation.Collated
End If
If printCapabilities.DuplexingCapability.Contains(Duplexing.TwoSidedLongEdge) Then
printTicket.Duplexing = Duplexing.TwoSidedLongEdge
End If
If printCapabilities.StaplingCapability.Contains(Stapling.StapleDualLeft) Then
printTicket.Stapling = Stapling.StapleDualLeft
End If
Return printTicket
End Function ' end:GetPrintTicketFromPrinter()
注釈
この型の値は、主に次の目的に使用します。
プロパティであるコレクションのStaplingCapabilityPrintCapabilitiesメンバーとして、これらの値は、プリンターがサポートするステープリングの種類を示します。
このPrintTicket値は、プロパティのStapling値として、プリンターにホチキス止めするかどうかを示します。
この Unknown 値は、オブジェクトの PrintCapabilities プロパティでは使用されません。
プロパティUnknownを設定PrintTicketしないでください。 他PrintTicketの生成アプリケーションが、認識できないオプション (つまり 、印刷スキーマで定義されていないオプション) PrintTicket にステープリング機能を設定する PrintTicket ドキュメント を作成した場合、そのドキュメントで構築されたアプリケーション内のオブジェクトはプロパティのStapling値として使用Unknownされます。
クラスとPrintCapabilitiesクラスはPrintTicket継承できませんが、印刷スキーマを拡張して、クラスでPrintCapabilities考慮されていない印刷デバイス機能をPrintTicket認識できます。 詳細については、「 方法: 印刷スキーマを拡張し、新しい印刷システム クラスを作成する」を参照してください。