PrintBooleanProperty Class

Reference

Definition

Namespace:: System.Printing.IndexedProperties

Assembly:: System.Printing.dll

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.

Represents a Boolean property (and its value) of a printing system hardware or software component.

public ref class PrintBooleanProperty sealed : System::Printing::IndexedProperties::PrintProperty

public sealed class PrintBooleanProperty : System.Printing.IndexedProperties.PrintProperty

type PrintBooleanProperty = class
    inherit PrintProperty

Public NotInheritable Class PrintBooleanProperty
Inherits PrintProperty

Inheritance: Object

PrintProperty
PrintBooleanProperty

Examples

The following example shows how to use this class while installing a second printer whose properties differ from an existing printer only in location, port, and shared status.

LocalPrintServer myLocalPrintServer = new LocalPrintServer(PrintSystemDesiredAccess.AdministrateServer);
PrintQueue sourcePrintQueue = myLocalPrintServer.DefaultPrintQueue;
PrintPropertyDictionary myPrintProperties = sourcePrintQueue.PropertiesCollection;

// Share the new printer using Remove/Add methods
PrintBooleanProperty shared = new PrintBooleanProperty("IsShared", true);
myPrintProperties.Remove("IsShared");
myPrintProperties.Add("IsShared", shared);

// Give the new printer its share name using SetProperty method
PrintStringProperty theShareName = new PrintStringProperty("ShareName", "\"Son of " + sourcePrintQueue.Name +"\"");
myPrintProperties.SetProperty("ShareName", theShareName);

// Specify the physical location of the new printer using Remove/Add methods
PrintStringProperty theLocation = new PrintStringProperty("Location", "the supply room");
myPrintProperties.Remove("Location");
myPrintProperties.Add("Location", theLocation);

// Specify the port for the new printer
String[] port = new String[] { "COM1:" };

// Install the new printer on the local print server
PrintQueue clonedPrinter = myLocalPrintServer.InstallPrintQueue("My clone of " + sourcePrintQueue.Name, "Xerox WCP 35 PS", port, "WinPrint", myPrintProperties);
myLocalPrintServer.Commit();

// Report outcome
Console.WriteLine("{0} in {1} has been installed and shared as {2}", clonedPrinter.Name, clonedPrinter.Location, clonedPrinter.ShareName);
Console.WriteLine("Press Return to continue ...");
Console.ReadLine();

Dim myLocalPrintServer As New LocalPrintServer(PrintSystemDesiredAccess.AdministrateServer)
Dim sourcePrintQueue As PrintQueue = myLocalPrintServer.DefaultPrintQueue
Dim myPrintProperties As PrintPropertyDictionary = sourcePrintQueue.PropertiesCollection

' Share the new printer using Remove/Add methods
Dim [shared] As New PrintBooleanProperty("IsShared", True)
myPrintProperties.Remove("IsShared")
myPrintProperties.Add("IsShared", [shared])

' Give the new printer its share name using SetProperty method
Dim theShareName As New PrintStringProperty("ShareName", """Son of " & sourcePrintQueue.Name & """")
myPrintProperties.SetProperty("ShareName", theShareName)

' Specify the physical location of the new printer using Remove/Add methods
Dim theLocation As New PrintStringProperty("Location", "the supply room")
myPrintProperties.Remove("Location")
myPrintProperties.Add("Location", theLocation)

' Specify the port for the new printer
Dim port() As String = { "COM1:" }


' Install the new printer on the local print server
Dim clonedPrinter As PrintQueue = myLocalPrintServer.InstallPrintQueue("My clone of " & sourcePrintQueue.Name, "Xerox WCP 35 PS", port, "WinPrint", myPrintProperties)
myLocalPrintServer.Commit()

' Report outcome
Console.WriteLine("{0} in {1} has been installed and shared as {2}", clonedPrinter.Name, clonedPrinter.Location, clonedPrinter.ShareName)
Console.WriteLine("Press Return to continue ...")
Console.ReadLine()

Constructors

PrintBooleanProperty(String)	Initializes a new instance of the PrintBooleanProperty class for the specified attribute.
PrintBooleanProperty(String, Object)	Initializes a new instance of the PrintBooleanProperty class for the specified property that is using the specified value.

Properties

IsDisposed	Gets or sets a value that indicates whether the object has been disposed. (Inherited from PrintProperty)
IsInitialized	Gets or sets a value that indicates whether the object has been initialized. (Inherited from PrintProperty)
Name	When overridden in a derived class, gets the name of the property that the object represents. (Inherited from PrintProperty)
Value	Gets or sets the value of the property that the PrintBooleanProperty represents.

Methods

Dispose()	Releases all resources that are being used by the PrintProperty. (Inherited from PrintProperty)
Dispose(Boolean)	Releases the unmanaged resources that are being used by the PrintProperty and optionally releases the managed resources. (Inherited from PrintProperty)
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
InternalDispose(Boolean)	Releases the unmanaged resources that are being used by the PrintProperty and optionally releases the managed resources. (Inherited from PrintProperty)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
OnDeserialization(Object)	When overridden in a derived class, implements the ISerializable interface and raises the deserialization event when the deserialization is complete. (Inherited from PrintProperty)
ToString()	Returns a string that represents the current object. (Inherited from Object)

Operators

Implicit(PrintBooleanProperty to Boolean)

Provides implicit conversion to a Boolean from a pointer to a PrintBooleanProperty.

Applies to