From 567a4fcf02bee6e989ddefcff81ad186b1a02eea Mon Sep 17 00:00:00 2001 From: Lionel Elie Mamane Date: Mon, 22 Apr 2013 17:37:17 +0200 Subject: Data-aware bindable ListBox new feature: bind *value* As opposed to index in list or *display* string Change-Id: I5fa74c80b28db843d45ee68523a4349ba44d229b --- .../star/form/binding/BindableDatabaseListBox.idl | 21 ++++++++++++++++----- 1 file changed, 16 insertions(+), 5 deletions(-) (limited to 'offapi') diff --git a/offapi/com/sun/star/form/binding/BindableDatabaseListBox.idl b/offapi/com/sun/star/form/binding/BindableDatabaseListBox.idl index 64acb45c4d04..4540dde132a4 100644 --- a/offapi/com/sun/star/form/binding/BindableDatabaseListBox.idl +++ b/offapi/com/sun/star/form/binding/BindableDatabaseListBox.idl @@ -26,17 +26,28 @@ module com { module sun { module star { module form { module binding { - /** This service specifies a list box model which is data-aware and thus can be bound to a database field, and additionally supports binding to arbitrary external values. -

There are four possible ways how a BindableDatabaseListBox exchanges - values with an external binding, the following lists explains all of them. If a new binding +

There are six possible ways that a BindableDatabaseListBox exchanges + values with an external binding. If a new binding is set at a BindableDatabaseListBox, the types from the following list are tried in descending order: The first type supported by the binding is used for data exchange. -

  1. sequences of integers: When used, the integers in the sequence will represent +
      +
    1. sequences of anys: + The elements in the sequence will represent + the values the selected entries of the list box + (taken from ValueList or read from BoundColumn). + In other words, the SelectedValues property.
      2. +
    2. any value: + The value will represent the value of the selected entry + (taken from ValueList or read from BoundColumn). + If more than one entry is selected, + will be transfered. + In other words, the SelectedValue property.
      3. +
    3. sequences of long integers: When used, the integers in the sequence will represent the indexes of the selected entries of the list box.
      4. -
    4. integer values: When used, the value will represent the index of the selected entry. +
    5. long integer value: When used, the value will represent the index of the selected entry. If no entry is selected, -1 will be transfered. If more than one entry is selected, will be transfered.
    6. sequences of strings: When used, the strings in the sequence present the texts -- cgit