offapi/com/sun/star/document/MacroExecMode.idl

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   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/.
   8  *
   9  * This file incorporates work covered by the following license notice:
  10  *
  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 .
  18  */
  19
  20
  21 module com { module sun { module star { module document {
  22
  23 /** Specify whether a macro can be executed.
  24
  25     @since OOo 1.1.2
  26 */
  27 published constants MacroExecMode
  28 {
  29     /** A macro should not be executed at all.
  30     */
  31
  32     const short NEVER_EXECUTE = 0;
  33
  34     /** Execute macros from secure list quietly.
  35
  36         <p>
  37         If a macro is not in the list a confirmation for it executing will
  38         appear.
  39         </p>
  40     */
  41
  42     const short FROM_LIST = 1;
  43
  44     /** Execute any macro, macros signed with trusted certificates and macros
  45         from secure list are executed quietly.
  46
  47         <p>
  48             If the macro is neither in secure list nor signed a confirmation
  49             will be requested.
  50         </p>
  51     */
  52
  53     const short ALWAYS_EXECUTE = 2;
  54
  55     /** Use configuration to retrieve macro settings. In case a user
  56         confirmation is required a dialog is output.
  57     */
  58
  59     const short USE_CONFIG = 3;
  60
  61
  62     /** A macro should be executed always no confirmation should be provided.
  63     */
  64
  65     const short ALWAYS_EXECUTE_NO_WARN = 4;
  66
  67     /** Use configuration to retrieve macro settings. Treat cases when user
  68         confirmation required as rejected.
  69     */
  70
  71     const short USE_CONFIG_REJECT_CONFIRMATION = 5;
  72
  73     /** Use configuration to retrieve macro settings. Treat cases when user
  74         confirmation required as approved.
  75     */
  76
  77     const short USE_CONFIG_APPROVE_CONFIRMATION = 6;
  78
  79     /** Execute only macros from secure list. Macros that are not from the list
  80         are not executed.
  81     */
  82     const short FROM_LIST_NO_WARN = 7;
  83
  84     /** Execute only macros from secure list or macros that are signed by
  85         trusted certificates.
  86
  87         <p> If the macro is neither in secure list nor signed it will not be
  88             executed.
  89         </p>
  90
  91         <p> If the macro is signed with unknown certificate a warning will
  92             appear. The macro either will not be executed or if the warning
  93             allows confirmation, it will be executed after user agrees to
  94             trust the certificate.
  95         </p>
  96     */
  97     const short FROM_LIST_AND_SIGNED_WARN = 8;
  98
  99     /** Execute only macros from secure list or macros that are signed by
 100         trusted certificates. No warning/confirmation should be shown.
 101     */
 102     const short FROM_LIST_AND_SIGNED_NO_WARN = 9;
 103
 104 };
 105
 106
 107 }; }; }; };
 108
 109 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */