PrintBooleanProperty Class
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.
Represents a Boolean property (and its value) of a printing system hardware or software component.
public ref class PrintBooleanProperty sealed : System::Printing::IndexedProperties::PrintPropertypublic sealed class PrintBooleanProperty : System.Printing.IndexedProperties.PrintPropertytype PrintBooleanProperty = class
inherit PrintPropertyPublic NotInheritable Class PrintBooleanProperty
Inherits PrintProperty- Inheritance
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, Object) |
Initializes a new instance of the PrintBooleanProperty class for the specified property that is using the specified value. |
| PrintBooleanProperty(String) |
Initializes a new instance of the PrintBooleanProperty class for the specified attribute. |
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. |
