Gets the color on the printer. 
                  	  
               
            
 
            	 
            
               		
               Restriction: This routine is not currently supported on UNIX platforms. 
                  		
               
               	 
              
            	 
            
               Syntax:
 
               		 
               		call "PC_PRINTER_GET_COLOR" using        printer-handle
                            by value     fore-or-back
                            by reference color-red
                            by reference color-green
                            by reference color-blue
                            returning    status-code 
               	   
            	 
            
               Parameters:
 
               		 
               		
                
                  		
                  
                      
                        			  
                        			  
                        			  
                        			 
                         
                           				
                            
                              				  
                              |   |  
                              				  
                              Using call prototype (see 
                                 					 Key) 
                                 				  
                               |  
                              				  
                              Picture 
                                 				  
                               |  
                              				
                           
 
                           			 
                         
                        			 
                         
                           				
                            
                              				  
                              |  
                                 					 printer-handle 
                                 				  
                               |  
                              				  
                              cblt-x4-comp5 
                                 				  
                               |  
                              				  
                              pic x(4) comp-5. 
                                 				  
                               |  
                              				
                           
 
                           				
                            
                              				  
                              |  
                                 					 fore-or-back 
                                 				  
                               |  
                              				  
                              cblt-x2-comp5 
                                 				  
                               |  
                              				  
                              pic x(2) comp-5. 
                                 				  
                               |  
                              				
                           
 
                           				
                            
                              				  
                              |  
                                 					 color-red 
                                 				  
                               |  
                              				  
                              cblt-x2-comp5 
                                 				  
                               |  
                              				  
                              pic x(2) comp-5. 
                                 				  
                               |  
                              				
                           
 
                           				
                            
                              				  
                              |  
                                 					 color-green 
                                 				  
                               |  
                              				  
                              cblt-x2-comp5 
                                 				  
                               |  
                              				  
                              pic x(2) comp-5. 
                                 				  
                               |  
                              				
                           
 
                           				
                            
                              				  
                              |  
                                 					 color-blue 
                                 				  
                               |  
                              				  
                              cblt-x2-comp5 
                                 				  
                               |  
                              				  
                              pic x(2) comp-5. 
                                 				  
                               |  
                              				
                           
 
                           				
                            
                              				  
                              |  
                                 					 status-code 
                                 				  
                               |  
                              				  
                              See 
                                 					 Library Routines - Key 
                                 				  
                               |  
                              				  
                                |  
                              				
                           
 
                           			 
                         
                        		  
                     
                    
                  		
                 
               	 
              
            	 
            
               On Entry:
 
               		 
               		
                
                  		   
                  			 
                  -  
                     				printer-handle 
                     			 
                  
  
                  			 
                  - The printer handle returned when the printer was opened. 
                     			 
                  
  
                  		   
                  		   
                  			 
                  -  
                     				fore-or-back 
                     			 
                  
  
                  			 
                  - Whether to get the foreground or background color: 
                     				
                     
                         
                           					  
                           					  
                           					 
                            
                              						
                               
                                 						  
                                 | 1 
                                    						  
                                  |  
                                 						  
                                 Foreground 
                                    						  
                                  |  
                                 						
                              
 
                              						
                               
                                 						  
                                 | 2 
                                    						  
                                  |  
                                 						  
                                 Background 
                                    						  
                                  |  
                                 						
                              
 
                              					 
                            
                           				  
                        
                       
                     			 
                    
                  		   
                  		
               
 
               	 
              
            	 
            
               On Exit:
 
               		 
               		
                
                  		   
                  			 
                  -  
                     				color-red 
                     			 
                  
  
                  			 
                  - A value between 0 and 255, giving the intensity of red. 
                     			 
                  
  
                  		   
                  		   
                  			 
                  -  
                     				color-greem 
                     			 
                  
  
                  			 
                  - A value between 0 and 255, giving the intensity of green. 
                     			 
                  
  
                  		   
                  		   
                  			 
                  -  
                     				color-blue 
                     			 
                  
  
                  			 
                  - A value between 0 and 255, giving the intensity of blue. 
                     			 
                  
  
                  		   
                  		   
                  			 
                  -  
                     				status-code 
                     			 
                  
  
                  			 
                  - Printer status code: 
                     				
                     
                         
                           					  
                           					  
                           					 
                            
                              						
                               
                                 						  
                                 | 0 
                                    						  
                                  |  
                                 						  
                                 Successful 
                                    						  
                                  |  
                                 						
                              
 
                              						
                               
                                 						  
                                 | 3 
                                    						  
                                  |  
                                 						  
                                 Printer device not open 
                                    						  
                                  |  
                                 						
                              
 
                              						
                               
                                 						  
                                 | 22 
                                    						  
                                  |  
                                 						  
                                 Failed to free bitmap 
                                    						  
                                  |  
                                 						
                              
 
                              					 
                            
                           				  
                        
                       
                     			 
                    
                  		   
                  		
               
 
               	 
              
            	 
             
            
           
         
         
Comments:
You must open the printer before using this routine.
You can find out if your printer supports color by using the PC_PRINTER_INFO library routine.