xref: /trunk/main/offapi/com/sun/star/document/MacroExecMode.idl (revision 1ecadb572e7010ff3b3382ad9bf179dbc6efadbb)
1/*************************************************************************
2 *
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * Copyright 2000, 2010 Oracle and/or its affiliates.
6 *
7 * OpenOffice.org - a multi-platform office productivity suite
8 *
9 * This file is part of OpenOffice.org.
10 *
11 * OpenOffice.org is free software: you can redistribute it and/or modify
12 * it under the terms of the GNU Lesser General Public License version 3
13 * only, as published by the Free Software Foundation.
14 *
15 * OpenOffice.org is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18 * GNU Lesser General Public License version 3 for more details
19 * (a copy is included in the LICENSE file that accompanied this code).
20 *
21 * You should have received a copy of the GNU Lesser General Public License
22 * version 3 along with OpenOffice.org.  If not, see
23 * <http://www.openoffice.org/license.html>
24 * for a copy of the LGPLv3 License.
25 *
26 ************************************************************************/
27
28#ifndef __com_sun_star_document_MacroExecMode_idl__
29#define __com_sun_star_document_MacroExecMode_idl__
30
31//=============================================================================
32
33module com { module sun { module star { module document {
34
35//=============================================================================
36/** Specify whether a macro can be executed.
37
38    @since OOo 1.1.2
39*/
40published constants MacroExecMode
41{
42    //-------------------------------------------------------------------------
43    /** A macro should not be executed at all.
44    */
45
46    const short NEVER_EXECUTE = 0;
47
48    //-------------------------------------------------------------------------
49    /** Execute macros from secure list quietly.
50
51        <p>
52        If a macro is not in the list a conformation for it executing will
53        appear.
54        </p>
55    */
56
57    const short FROM_LIST = 1;
58
59    //-------------------------------------------------------------------------
60    /** Execute any macro, macros signed with trusted sertificates and macros
61        from secure list are executed quietly.
62
63        <p>
64            If the macro is neither in secure list nor signed a conformation
65            will be requested.
66        </p>
67    */
68
69    const short ALWAYS_EXECUTE = 2;
70
71    //-------------------------------------------------------------------------
72    /** Use configuration to retrieve macro settings. In case a user
73        confirmation is required a dialog is output.
74    */
75
76    const short USE_CONFIG = 3;
77
78
79    //-------------------------------------------------------------------------
80    /** A macro should be executed always no conformation should be provided.
81    */
82
83    const short ALWAYS_EXECUTE_NO_WARN = 4;
84
85    //-------------------------------------------------------------------------
86    /** Use configuration to retrieve macro settings. Treat cases when user
87        confirmation required as rejected.
88    */
89
90    const short USE_CONFIG_REJECT_CONFIRMATION = 5;
91
92    //-------------------------------------------------------------------------
93    /** Use configuration to retrieve macro settings. Treat cases when user
94        confirmation required as approved.
95    */
96
97    const short USE_CONFIG_APPROVE_CONFIRMATION = 6;
98
99    //-------------------------------------------------------------------------
100    /** Execute only macros from secure list. Macros that are not from the list
101        are not executed.
102    */
103    const short FROM_LIST_NO_WARN = 7;
104
105    //-------------------------------------------------------------------------
106    /** Execute only macros from secure list or macros that are signed by
107        trusted certificates.
108
109        <p> If the macro is neither in secure list nor signed it will not be
110            executed.
111        </p>
112
113        <p> If the macro is signed with unknown certificate a warning will
114            appear. The macro either will not be executed or if the warning
115            allows conformation, it will be executed after user agrees.
116        </p>
117    */
118    const short FROM_LIST_AND_SIGNED_WARN = 8;
119
120    //-------------------------------------------------------------------------
121    /** Execute only macros from secure list or macros that are signed by
122        trusted certificates. No warning/conformation should be shown.
123    */
124    const short FROM_LIST_AND_SIGNED_NO_WARN = 9;
125
126};
127
128//=============================================================================
129
130}; }; }; };
131
132#endif
133