Merge branch 'master' of git://anongit.kde.org/kde-runtime

This commit is contained in:
Giorgos Tsiapaliwkas 2011-12-22 16:44:32 +02:00
commit fe1c771a76
28 changed files with 154 additions and 57 deletions

View File

@ -18,7 +18,7 @@
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**Documentanted API
/**Documented API
Inherits:
Item
@ -27,7 +27,7 @@ Imports:
QtQuick 1.1
Description:
It is just a simple BusyIndicator.
It is just a simple Busy Indicator, it is used to indicate a task which duration is unknown. If the task duration/number of steps is known, a ProgressBar should be used instead.
TODO An image has to be added!
Properties:

View File

@ -20,7 +20,7 @@
*/
/**Documentanted API
/**Documented API
Inherits:
Item

View File

@ -39,7 +39,7 @@
**
****************************************************************************/
/**Documentanted API
/**Documented API
Inherits:
Column
@ -53,7 +53,6 @@ Description:
Note: This component don't support the enabled property.
If you need to disable it you should disable all the buttons inside it.
TODO we need an example here...
This is an example,
<code>

View File

@ -39,7 +39,7 @@
**
****************************************************************************/
/**Documentanted API
/**Documented API
Inherits:
Row
@ -53,7 +53,6 @@ Description:
Note: This component don't support the enabled property.
If you need to disable it you should disable all the buttons inside it.
TODO we need an example here...
This is an example,
<code>

View File

@ -18,7 +18,7 @@
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**Documentanted API
/**Documented API
Inherits:
Item

View File

@ -17,17 +17,27 @@
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**Documentanted API
/**Documented API
Inherits:
DualStateButton
The private DualStateButton
Imports:
QtQuick 1.0
org.kde.plasma.core
Description:
TODO i need more info here
A check box is a component that can be switched on (checked) or off (unchecked). Check boxes are typically used to represent features in an application that can be enabled or disabled without affecting others, but different types of behavior can be implemented. When a check box is checked or unchecked it sends a clicked signal for the application to handle.
When a check box has the focus, its state can be toggled using the Qt.Key_Select, Qt.Key_Return, and Qt.Key_Enter hardware keys that send the clicked signal.
Properties:
bool checked: If the button is checked, its checked property is true; otherwise false. The property is false by default.
bool pressed: If the button is pressed, its pressed property is true.
See also clicked.
string text: The text is shown beside the check box. By default text is an empty string.
Signals:
clicked():
Emitted when the user clicked a mouse button over the checkbox (or tapped on the touch screen)
**/
import QtQuick 1.0

View File

@ -40,6 +40,56 @@
**
****************************************************************************/
/**Documented API
Inherits:
Item
Imports:
QtQuick 1.0
org.kde.plasma.core
Description:
Provides a top-level window for short-term tasks and brief interaction with the user.
A dialog floats on the top layer of the application view, usually overlapping the area reserved for the application content. Normally, a dialog provides information and gives warnings to the user, or asks the user to answer a question or select an option.
Properties:
list<Item> buttons: A list of items in the dialog's button area. For example, you can use Row or Button components but you can also use any number of components that are based on Item component.
list<Item> content: A list of items in the dialog's content area. You can use any component that is based on Item. For example, you can use ListView, so that the user can select from a list of names.
int status: Indicates the dialog's phase in its life cycle. The values are as follows:
- DialogStatus.Opening - the dialog is opening
- DialogStatus.Open - the dialog is open and visible to the user
- DialogStatus.Closing - the dialog is closing
- DialogStatus.Closed - the dialog is closed and not visible to the user
- The dialog's initial status is DialogStatus.Closed.
list<Item> title: A list of items in the dialog's title area. You can use a Text component but also any number of components that are based on Item. For example, you can use Text and Image components.
Item visualParent: The item that is dimmed when the dialog opens. By default the root parent object is visualParent.
Signals:
accepted(): This signal is emitted when the user accepts the dialog's request or the accept() method is called.
See also rejected().
clickedOutside(): This signal is emitted when the user taps in the area that is inside the dialog's visual parent area but outside the dialog's area. Normally the visual parent is the root object. In that case this signal is emitted if the user taps anywhere outside the dialog's area.
See also visualParent.
rejected(): This signal is emitted when the user rejects the dialog's request or the reject() method is called.
See also accepted().
Methods:
void accept(): Accepts the dialog's request without any user interaction. The method emits the accepted() signal and closes the dialog.
See also reject().
void close(): Closes the dialog without any user interaction.
void open(): Shows the dialog to the user.
void reject(): Rejects the dialog's request without any user interaction. The method emits the rejected() signal and closes the dialog.
See also accept().
**/
import QtQuick 1.0
import org.kde.plasma.core 0.1 as PlasmaCore
import "AppManager.js" as Utils

View File

@ -17,7 +17,7 @@
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**Documentanted API
/**Documented API
Inherits:
Item

View File

@ -17,7 +17,7 @@
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**Documentanted API
/**Documented API
Inherits:
Item

View File

@ -17,7 +17,7 @@
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**Documentanted API
/**Documented API
Inherits:
Item

View File

@ -17,7 +17,7 @@
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**Documentanted API
/**Documented API
Inherits:
Text

View File

@ -38,7 +38,7 @@
**
****************************************************************************/
/**Documentanted API
/**Documented API
Inherits:
Item

View File

@ -43,7 +43,7 @@
// The PageStack item defines a container for pages and a stack-based
// navigation model. Pages can be defined as QML items or components.
/**Documentanted API
/**Documented API
Inherits:
Item

View File

@ -17,7 +17,7 @@
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**Documentanted API
/**Documented API
Inherits:
Item

View File

@ -17,18 +17,27 @@
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**Documentanted API
/**Documented API
Inherits:
DualStateButton
The private DualStateButton
Imports:
QtQuick 1.0
org.kde.plasma.core
Description:
It is a simple Radio button which is using the plasma theme.
TODO Do we need more info?
A radio button component consists of a radio button and a line of text. Only one item in a list may be selected at a time. Once an item is selected, it can be deselected only by selecting another item. Initial item selection may be set at the list creation. If not set, the list is shown without a selection.
Properties:
bool checked: If the button is checked, its checked property is true; otherwise false. The property is false by default.
bool pressed: If the button is pressed, its pressed property is true.
See also clicked.
string text: The text is shown beside the check box. By default text is an empty string.
Signals:
clicked():
Emitted when the user clicked a mouse button over the checkbox (or tapped on the touch screen)
**/
import QtQuick 1.0

View File

@ -18,7 +18,7 @@
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**Documentanted API
/**Documented API
Inherits:
Item

View File

@ -18,7 +18,7 @@
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**Documentanted API
/**Documented API
Inherits:
Item
@ -27,36 +27,55 @@ Imports:
QtQuick 1.1
Description:
Just a simple scrollbar which is using the plasma theme.
Plasma theme is the theme which changes via the systemsetting-workspace appearence
-desktop theme.
Just a simple Scroll Bar which is using the plasma theme.
This component does not belongs to the QtComponents API specification
but it was base on ScrollDecorator component.
You should not use it for touch interfaces, use a flickable and a
ScrollDecorator instead.
Properties:
Plasma Properties:
int orientation:
Sets the orientation.
bool animated:
TODO
enumeration orientation:
This property holds the orientation where the ScrollBar will scroll.
The orientation can be either Qt.Horizontal or Qt.Vertical
The default value is Qt.Vertical.
bool inverted:
Sets if the scrollbar will be inverted or not.
This property holds if the ScrollBar will increase the Flickable
content in the normal direction (Left to Right or Top to Bottom) or
if this will be inverted.
The default value is false.
bool updateValueWhileDragging: true
Sets if the Scrollbar will be resized while it is being dragged.
bool updateValueWhileDragging:
This property holds if the Scrollbar will update the Flickeble
position while dragging or only when released.
The default value is true.
alias stepSize:
Sets the step with which the scrollbar is moving.
real stepSize:
This property holds how many steps exists while moving the handler.
If you want the ScrollBar buttons to appear you must set this property
with a value bigger than 0.
The default value is 0.
alias pressed:
If the scrollbar is pressed it returns true,otherwise false.
bool pressed:
This property holds if the ScrollBar is pressed.
real scrollButtonInterval: 50
real scrollButtonInterval:
This property holds the interval time used by the ScrollBar button
to increase or decrease steps.
property Flickable flickableItem: null
Flickable flickableItem:
This property holds the Flickable component which the ScrollBar will
interact with.
property bool interactive:
If true,then the scrollbar is interactive otherwise it isn't.
bool interactive:
This property holds if the ScrollBar is interactive.
The default value is true.
bool enabeld:
This property holds if the button will be enabled for user
interaction.
The default value is true.
**/
import QtQuick 1.1

View File

@ -37,7 +37,7 @@
** $QT_END_LICENSE$
**
****************************************************************************/
/**Documentanted API
/**Documented API
Inherits:
Item

View File

@ -17,7 +17,7 @@
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**Documentanted API
/**Documented API
Inherits:
Item

View File

@ -17,7 +17,7 @@
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**Documentanted API
/**Documented API
Inherits:
DualStateButton

View File

@ -40,7 +40,7 @@
**
****************************************************************************/
/**Documentanted API
/**Documented API
Inherits:
DualStateButton

View File

@ -40,7 +40,7 @@
**
****************************************************************************/
/**Documentanted API
/**Documented API
Inherits:
Item

View File

@ -40,7 +40,7 @@
**
****************************************************************************/
/**Documentanted API
/**Documented API
Inherits:
Item

View File

@ -38,7 +38,7 @@
**
****************************************************************************/
/**Documentanted API
/**Documented API
Inherits:
Item

View File

@ -17,7 +17,7 @@
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**Documentanted API
/**Documented API
Inherits:
Item

View File

@ -17,7 +17,7 @@
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**Documentanted API
/**Documented API
Inherits:
Item

View File

@ -17,7 +17,7 @@
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**Documentanted API
/**Documented API
Inherits:
PlasmaCore.FrameSvgItem
@ -31,14 +31,25 @@ Description:
Properties:
Item tools:
The current set of tools; null if none.
The ToolBarLayout that contains the ToolButton components that
are contained in the ToolBar. ToolBarLayout is not mandatory.
The default value is NULL.
string transition:
The transition type. One of the following:
The type of transition to be used for the ToolBar when
the page changes on the relevant PageStack.
The possible values can be one of the following:
set an instantaneous change (default)
push follows page stack push animation
pop follows page stack pop animation
replace follows page stack replace animation
Methods:
setTools( tools, transition )
This sets the tools for the ToolBar and the transition type that
will be used when the page changes on the relevant PageStack.
@arg Item tools see tool property
@arg string transition see transition property
**/
import QtQuick 1.1

View File

@ -18,7 +18,7 @@
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**Documentanted API
/**Documented API
Inherits:
Item