offapi/com/sun/star/form/binding/BindableIntegerValueRange.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 form {  module binding {
  22
  23
  24 /** this service specifies a BindableControlModel which reflects
  25     an integer value, out of a range of permitted integer values.
  26
  27     <p>BindableIntegerValueRanges have a value property, a minimum, and a maximum,
  28     all of type integer.</p>
  29 */
  30 service BindableIntegerValueRange
  31 {
  32     /** specifies that the control can be bound to external values
  33
  34         <p>Any binding used with the control model (see XBindableValue::setValueBinding())
  35         must support exchanging double values.</p>
  36
  37         <p>When the (integer) value reflected by the control model is changed, it's converted
  38         into a double value and propagated to the binding.</p>
  39
  40         <p>When the external (double) value changes, it's converted as follows to an integer
  41         value:
  42         <ul><li>If the external value is `NULL`, the current value of the control model
  43                 will be set to its minimum.</li>
  44             <li>If the external value is the <em>infinite</em> value, the control value will
  45                 be set to its maximum or minimum, depending on the sign of the external value.</li>
  46             <li>If none of the aforementioned conditions is met, the external value will be simply
  47                 rounded.</li>
  48         </ul>
  49     */
  50     service com::sun::star::form::binding::BindableControlModel;
  51
  52 };
  53
  54
  55 }; }; }; }; };
  56
  57 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */