/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*************************************************************************
*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* Copyright 2000, 2010 Oracle and/or its affiliates.
*
* OpenOffice.org - a multi-platform office productivity suite
*
* This file is part of OpenOffice.org.
*
* OpenOffice.org is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License version 3
* only, as published by the Free Software Foundation.
*
* OpenOffice.org is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License version 3 for more details
* (a copy is included in the LICENSE file that accompanied this code).
*
* You should have received a copy of the GNU Lesser General Public License
* version 3 along with OpenOffice.org. If not, see
* Every element of the sequence must contain information to create a
If a sequence element contains an instance implementing the
This attribute is usually only evaluated by the
The order of factories is important: If two property handlers declare themselves responsible
for the same property, the one whose factory is listed last wins. Also,
if a handler B
wants to supersede a property of another handler A
,
A
's factory must precede the factory of B
.
Properties can be sorted into different categories, described by the
Those names provided by the handlers are programmatic names. All other information
about categories is part of the
In the user interface of an ObjectInspector, single properties are represented by
single lines, and those lines are displayed successively. To determine an order of
the property lines, the inspector model can associate an "order index" with each property.
The
Note that the concrete value the model returns for a given property does not
matter. All what matters is that if you want a certain property Foo
to be displayed after another property Bar
, then the order index
of Foo
should be greater than the order index of Bar
.
If for two different properties the same order index is returned, the
If two such properties originate from different handlers, they will be ordered according
to the order of the handlers, as provided in the
The object inspector displays lines of property/values, optionally grouped
into categories, as described by the property handlers.
Additionally, the inspector can optionally display a section dedicated to help
texts. Clients could use this section to display context-sensitive help, for
instance short texts explaining the currently selected property.
This property is ignored by the
The layout of the
This property is ignored by the
The layout of the
In this case, the user is able to browse through all properties, but cannot change any of them.
In a read-only object inspector, the property controls are readonly or disabled themselves, and the primary and secondary buttons of a property line are both disabled.
@see XPropertyControl @see LineDescriptor */ [attribute, bound] boolean IsReadOnly; }; //============================================================================= }; }; }; }; #endif /* vim:set shiftwidth=4 softtabstop=4 expandtab: */