All Frameworks  Object Hierarchy  This Framework  Previous  Next  Indexes  

PrintersSettingAtt (Object)

IUnknown
  |
  +---IDispatch
    |
    +---CATBaseUnknown
      |
      +---CATBaseDispatch
        |
        +---AnyObject
          |
          +---SettingController
            |
            +---PrintersSettingAtt
 


Represents a setting controller for the printer settings.
Role: This interface is implemented by a component which represents the controller of the printer settings.

Method Index

AddPrinterDirectory
Add a printer file directory to printer directories list and define its state.
AddPrinterGroup
Add a printer group and define the printers included in this group.
GetDriverConfigurationPath
Returns the driver configuration file.
GetDriverConfigurationPathInfo
Retrieves environment informations for the driver configuration file.
GetNewPrinterDirectory
Returns the directory where new printers will be added.
GetNewPrinterDirectoryInfo
Retrieves environment informations for the directory where printers will be added.
GetPrinterArrayForGroup
Returns the definition of the printer group.
GetPrinterDirectories
Returns the directories of printer files.
GetPrinterDirectoriesInfo
Retrieves environment informations for the directories of printer files and their states.
GetPrinterDirectoryState
Returns the state of the directory of printer files.
GetPrinterGroups
Returns the printer groups.
GetPrinterGroupsInfo
Retrieves environment informations for the definition of each printer group.
ModifyPrinterArrayForGroup
Modify a printer group: redefine the array of printers included in this group.
ModifyPrinterDirectoryState
Modify a printer file directory state.
RemoveAllPrinterDirectories
Remove all the directories including printer files.
RemoveAllPrinterGroups
Remove all the groups of printers.
RemovePrinterDirectory
Remove a directory of printer files from the directories list.
RemovePrinterGroup
Remove a group of printers.
SetDriverConfigurationPath
Sets the driver configuration file.
SetDriverConfigurationPathLock
Locks or unlocks the driver configuration file.
SetNewPrinterDirectory
Sets the directory where new printers will be added.
SetNewPrinterDirectoryLock
Locks or unlocks the directory where printers will be added.
SetPrinterDirectoriesLock
Locks or unlocks the directories of printer files and their states.
SetPrinterGroupsLock
Locks or unlocks the definition of each printer group.

Methods


o Sub AddPrinterDirectory(CATBSTR iPrinterDir,
CatPrinterDirState iPrinterDirState)
Add a printer file directory to printer directories list and define its state.
Parameters:
iPrinterDir
directory where some 3DPLM printers are defined.
The printers defined in this directory will be available for each user.
iPrinterDirState
printer directory state.
Each directory can be protected to prevent user access to the printers it contains.
The state could be protect or free.
If the state is CatPrinterDirProtect, the parameters of each printer included in the directory cannot be changed.
If the state is CatPrinterDirFree, the parameters of each printer included in the directory can be changed, and the printers can be removed.
Legal values:
CatPrinterDirProtect : the printers included in the directory are protected.
CatPrinterDirFree : the printers included in the directory are free.
o Sub AddPrinterGroup(CATBSTR iPrinterGroupName,
CATSafeArrayVariant iPrinterNames)
Add a printer group and define the printers included in this group.
Parameters:
iPrinterGroupName
printer group name
iPrinterNames
array of printers included in the group.
o Sub GetDriverConfigurationPath(CATBSTR oDriverCfgPath)
Returns the driver configuration file.
Parameters:
oDriverCfgPath
path of the driver configuration file
o Func GetDriverConfigurationPathInfo(CATBSTR oAdminLevel,
CATBSTR oLocked) As boolean
Retrieves environment informations for the driver configuration file.
Role: Retrieves the state of the driver configuration file in the current environment.
Parameters:
oAdminLevel
If the parameter is locked, oAdminLevel gives the administration level that imposes the value of the parameter.
If the parameter is not locked, oAdminLevel gives the administration level that will give the value of the parameter after a reset.
oLocked
Indicates if the parameter has been locked.
Returns:
Indicates if the parameter has been explicitly modified or remain to the administrated value.
o Sub GetNewPrinterDirectory(CATBSTR oNewPrinterDir)
Returns the directory where new printers will be added.
Parameters:
oNewPrinterDir
directory to add new printers
Role: Each new printer created by an user is added in this directory.
o Func GetNewPrinterDirectoryInfo(CATBSTR oAdminLevel,
CATBSTR oLocked) As boolean
Retrieves environment informations for the directory where printers will be added.
Role: Retrieves the state of the directory where printers will be added in the current environment.
Parameters:
oAdminLevel
If the parameter is locked, oAdminLevel gives the administration level that imposes the value of the parameter.
If the parameter is not locked, oAdminLevel gives the administration level that will give the value of the parameter after a reset.
oLocked
Indicates if the parameter has been locked.
Returns:
Indicates if the parameter has been explicitly modified or remain to the administrated value.
o Func GetPrinterArrayForGroup(CATBSTR iPrinterGroupName) As CATSafeArrayVariant
Returns the definition of the printer group.
Parameters:
iPrinterGroupName
printer group name
Returns:
array of printers included in the group.
o Func GetPrinterDirectories() As CATSafeArrayVariant
Returns the directories of printer files.
Returns:
array of directories where 3DPLM printers are defined.
o Func GetPrinterDirectoriesInfo(CATBSTR oAdminLevel,
CATBSTR oLocked) As boolean
Retrieves environment informations for the directories of printer files and their states.
Role: Retrieves the state of the directories of printer files and their states in the current environment.
Parameters:
oAdminLevel
If the parameter is locked, oAdminLevel gives the administration level that imposes the value of the parameter.
If the parameter is not locked, oAdminLevel gives the administration level that will give the value of the parameter after a reset.
oLocked
Indicates if the parameter has been locked.
Returns:
Indicates if the parameter has been explicitly modified or remain to the administrated value.
o Func GetPrinterDirectoryState(CATBSTR iPrinterDir) As CatPrinterDirState
Returns the state of the directory of printer files.
Parameters:
iPrinterDir
directory where some 3DPLM printers are defined.
Returns:
printer directory state.
Each directory can be protected to prevent user access to the printers it contains.
The state could be protect or free.
If the state is CatPrinterDirProtect, the parameters of each printer included in the directory cannot be changed.
If the state is CatPrinterDirFree, the parameters of each printer included in the directory can be changed, and the printers can be removed.
Legal values:
CatPrinterDirProtect : the printers included in the directory are protected.
CatPrinterDirFree : the printers included in the directory are free.
o Func GetPrinterGroups() As CATSafeArrayVariant
Returns the printer groups.
Returns:
array of printer group names
o Func GetPrinterGroupsInfo(CATBSTR oAdminLevel,
CATBSTR oLocked) As boolean
Retrieves environment informations for the definition of each printer group.
Role: Retrieves the state of the definition of each printer group in the current environment.
Parameters:
oAdminLevel
If the parameter is locked, oAdminLevel gives the administration level that imposes the value of the parameter.
If the parameter is not locked, oAdminLevel gives the administration level that will give the value of the parameter after a reset.
oLocked
Indicates if the parameter has been locked.
Returns:
Indicates if the parameter has been explicitly modified or remain to the administrated value.
o Sub ModifyPrinterArrayForGroup(CATBSTR iPrinterGroupName,
CATSafeArrayVariant iPrinterNames)
Modify a printer group: redefine the array of printers included in this group.
Parameters:
iPrinterGroupName
printer group name
iPrinterNames
array of printers included in the group.
o Sub ModifyPrinterDirectoryState(CATBSTR iPrinterDir,
CatPrinterDirState iPrinterDirState)
Modify a printer file directory state.
Parameters:
iPrinterDir
directory where some 3DPLM printers are defined.
iPrinterDirState
printer directory state.
Each directory can be protected to prevent user access to the printers it contains.
The state could be protect or free.
If the state is CatPrinterDirProtect, the parameters of each printer included in the directory cannot be changed.
If the state is CatPrinterDirFree, the parameters of each printer included in the directory can be changed, and the printers can be removed.
Legal values:
CatPrinterDirProtect : the printers included in the directory are protected.
CatPrinterDirFree : the printers included in the directory are free.
o Sub RemoveAllPrinterDirectories()
Remove all the directories including printer files.
o Sub RemoveAllPrinterGroups()
Remove all the groups of printers.
o Sub RemovePrinterDirectory(CATBSTR iPrinterDir)
Remove a directory of printer files from the directories list.
Parameters:
iPrinterDir
directory where some 3DPLM printers are defined.
o Sub RemovePrinterGroup(CATBSTR iPrinterGroupName)
Remove a group of printers.
Parameters:
iPrinterGroupName
name of the group to remove.
o Sub SetDriverConfigurationPath(CATBSTR iDriverCfgPath)
Sets the driver configuration file.
Parameters:
iDriverCfgPath
path of the driver configuration file
o Sub SetDriverConfigurationPathLock(boolean iLock)
Locks or unlocks the driver configuration file.
Role: Locks or unlocks the driver configuration file if it is possible in the current administrative context. In user mode this method will always return E_FAIL.
Parameters:
iLocked
the locking operation to be performed
Legal values:
TRUE : to lock the parameter.
FALSE: to unlock the parameter.
o Sub SetNewPrinterDirectory(CATBSTR iNewPrinterDir)
Sets the directory where new printers will be added.
Parameters:
iNewPrinterDir
directory to add new printers
Role: Each new printer created by an user is added in this directory.
o Sub SetNewPrinterDirectoryLock(boolean iLock)
Locks or unlocks the directory where printers will be added.
Role: Locks or unlocks the directory where printers will be added if it is possible in the current administrative context. In user mode this method will always return E_FAIL.
Parameters:
iLocked
the locking operation to be performed
Legal values:
TRUE : to lock the parameter.
FALSE: to unlock the parameter.
o Sub SetPrinterDirectoriesLock(boolean iLock)
Locks or unlocks the directories of printer files and their states.
Role: Locks or unlocks the directories of printer files and their states if it is possible in the current administrative context. In user mode this method will always return E_FAIL.
Parameters:
iLocked
the locking operation to be performed
Legal values:
TRUE : to lock the parameter.
FALSE: to unlock the parameter.
o Sub SetPrinterGroupsLock(boolean iLock)
Locks or unlocks the definition of each printer group.
Role: Locks or unlocks the definition of each printer group if it is possible in the current administrative context. In user mode this method will always return E_FAIL.
Parameters:
iLocked
the locking operation to be performed
Legal values:
TRUE : to lock the parameter.
FALSE: to unlock the parameter.

Copyright © 2003, Dassault Systèmes. All rights reserved.