use insert function instead of for loop
[LibreOffice.git] / offapi / com / sun / star / awt / XPrinter.idl
blobba62afe065c558ad40a7b1702fb7245a5f0a6c5e
1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2 /*
3 * This file is part of the LibreOffice project.
5 * This Source Code Form is subject to the terms of the Mozilla Public
6 * License, v. 2.0. If a copy of the MPL was not distributed with this
7 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
9 * This file incorporates work covered by the following license notice:
11 * Licensed to the Apache Software Foundation (ASF) under one or more
12 * contributor license agreements. See the NOTICE file distributed
13 * with this work for additional information regarding copyright
14 * ownership. The ASF licenses this file to you under the Apache
15 * License, Version 2.0 (the "License"); you may not use this file
16 * except in compliance with the License. You may obtain a copy of
17 * the License at http://www.apache.org/licenses/LICENSE-2.0 .
22 module com { module sun { module star { module awt {
25 /** represents a virtual printer.
27 <p>All properties are vetoable properties.
28 If you change the properties between a call to
29 com::sun::star::awt::XPrinter::startPage() and a call
30 to com::sun::star::awt::XPrinter::endPage(),
31 a com::sun::star::beans::PropertyVetoException is
32 thrown.</p>
34 published interface XPrinter: com::sun::star::awt::XPrinterPropertySet
37 /** puts the job into the printer spooler.
39 <p>This call may block the thread. So release all resources
40 (mutex, semaphore, etc.) before this call.</p>
42 boolean start( [in] string nJobName,
43 [in] short nCopies,
44 [in] boolean nCollate )
45 raises( com::sun::star::awt::PrinterException,
46 com::sun::star::lang::IllegalArgumentException );
49 /** notifies the printer spooler that the job is done and printing
50 starts.
52 @see terminate
54 void end()
55 raises( com::sun::star::awt::PrinterException );
58 /** stops the current print job.
60 <p>If the method
61 com::sun::star::awt::XPrinter::end()
62 is called beforehand, then this call does nothing. If you call
63 com::sun::star::awt::XPrinter::terminate()
64 in or before the call to
65 com::sun::star::awt::XPrinter::start(),
66 com::sun::star::awt::XPrinter::terminate()
67 returns `FALSE`. This call must not block the thread.</p>
69 @see end
71 void terminate();
74 /** begins with a new page.
76 com::sun::star::awt::XDevice startPage()
77 raises( com::sun::star::awt::PrinterException );
80 /** ends the current page.
82 void endPage()
83 raises( com::sun::star::awt::PrinterException );
88 }; }; }; };
90 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */