PrinterSettings.IsDefaultPrinter Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets a value indicating whether the PrinterName property designates the default printer, except when the user explicitly sets PrinterName.
public:
property bool IsDefaultPrinter { bool get(); };public bool IsDefaultPrinter { get; }member this.IsDefaultPrinter : boolPublic ReadOnly Property IsDefaultPrinter As BooleanProperty Value
true if PrinterName designates the default printer; otherwise, false.
Examples
The following example demonstrates how to use the IsDefaultPrinter property. To run this example, paste the following code into a form and call PopulateInstalledPrintersCombo from the form's constructor or Load event-handling method.
private ComboBox comboInstalledPrinters = new ComboBox();
private PrintDocument printDoc = new PrintDocument();
private void PopulateInstalledPrintersCombo()
{
comboInstalledPrinters.Dock = DockStyle.Top;
Controls.Add(comboInstalledPrinters);
// Add list of installed printers found to the combo box.
// The pkInstalledPrinters string will be used to provide the display string.
int i;
string pkInstalledPrinters;
for (i = 0; i < PrinterSettings.InstalledPrinters.Count; i++)
{
pkInstalledPrinters = PrinterSettings.InstalledPrinters[i];
comboInstalledPrinters.Items.Add(pkInstalledPrinters);
if (printDoc.PrinterSettings.IsDefaultPrinter)
{
comboInstalledPrinters.Text = printDoc.PrinterSettings.PrinterName;
}
}
}
Private WithEvents comboInstalledPrinters As New ComboBox
Private WithEvents printDoc As New PrintDocument
Private Sub PopulateInstalledPrintersCombo()
comboInstalledPrinters.Dock = DockStyle.Top
Controls.Add(comboInstalledPrinters)
' Add list of installed printers found to the combo box.
' The pkInstalledPrinters string will be used to provide the display string.
Dim i As Integer
Dim pkInstalledPrinters As String
For i = 0 To PrinterSettings.InstalledPrinters.Count - 1
pkInstalledPrinters = PrinterSettings.InstalledPrinters.Item(i)
comboInstalledPrinters.Items.Add(pkInstalledPrinters)
If (printDoc.PrinterSettings.IsDefaultPrinter()) Then
comboInstalledPrinters.Text = printDoc.PrinterSettings.PrinterName
End If
Next
End Sub
Remarks
IsDefaultPrinter always returns false when you explicitly set the PrinterName property to a string value other than null.
