XAML

The WinX User Interface can be vastly customized using XAML.

1 Templates
- 1.1 General
  - 1.1.1 AuthenticationPage
- 1.2 Content Pages
2 Specific UBIK^® Elements
3 Converters
- 3.1 Basic
- 3.2 Advanced
4 Behaviors
5 Properties
6 Commands

Templates

The UI is controlled by several predefined XAML templates which are loaded into the App at startup. There is a set of default template deployed with the App at installation, however, each of them can be overridden by placing the respective file in the folder [AppInstallPath]\LocalState\XAML

General

UBIKThemes.xaml

Controls the overall styling and behavior of the App, like standard Brushes (Colors) and Fonts.

AuthenticationPage

UBIKSplashArea.xaml
UBIKPageNavigation.xaml -> Deprecated and changed to UBIKHomePageButtons.xaml
UBIKProfileItem.xaml

Content Pages

UBIKObjectIcon.xaml
UBIKObjectIconSmall.xaml

RootPage

UBIKMainLeftArea.xaml
UBIKMainItem.xaml
UBIKMainItemSmall.xaml

ChildPage

UBIKChildItem.xaml
UBIKChildItemSmall.xaml
UBIKChildArea.xaml
UBIKChildAreaSmall.xaml
UBIKChildAction.xaml
UBIKPriorityPropertyItem.xaml

DetailsPage

UBIKDocumentItem.xaml
UBIKDocumentItemSmall.xaml

Specific UBIK^® Elements

Converters

Basic

BooleanToVisibilityConverter

Converts a Boolean into a Visibility, where true will result in Visibility.Visible.

BooleanToCollapsedConverter

Converts a Boolean into a Visibility, where true will result in Visibility.Collapsed.

BooleanInvertConverter

Converts boolean input into the inverted bool value.

BooleanToScrollbarVisibilityConverter

Converts a boolean Value to ScrollbarVisibility

BooleanToVisibilityConverter/BooleanToCollapsedConverter

Converts a boolean Value to Visibility

ByteToImageSourceValueConverter

Converts a byte array to an ImageSource

ChildItemTemplateSelectorSuffixConverter
ClassificationToVisibilityConverter/ClassificationToCollapsedConverter

Converts the presence of a classification to visibility. One or more classification UIDs have to be provided separated by '|'.

ContainsToVisibilityConverter/ContainsToCollapsedConverter

Converts the presence of one or more item(s) in a collection (e.g. int array) to visibility. Parameter with one or more items has to be provided separated with '|'.

DistanceToStringConverter

A distance in meters provided as double will be converted into a comfortable redable distance (e.g. "0.5 m", "1.7 km")

DoubleToLocalizedStringConverter

A double value will be converted to the current localisation

EditablePropertyToVisibilityConverter/EditablePropertyToCollapseConverter
EnumerableGetToValueConverter
EqualToTrueConverter
EqualToVisibilityConverter/EqualToCollapsedConverter

Converts equality to visibility. A parameter with a compare value hast to be provided.

IntToSolidBrushConverter

Converts the 4 bytes (ARGB) of an integer value to a Brush

ItemCountToVisibilityConverter/ItemCountToCollapseConverter

Converts presence of items in a collection to visibility.

NullableIntToStringConverter

Converts a nullable int to a string. {null} will be an empty string

NullObjectToBooleanConverter

Converts an object to boolean depending from being null or not.

NullObjectToVisibilityConverter/NullObjectToCollapsedConverter

Converts an object to visibility depending from being null or not.

NullOrEmptyStringToVisibilityConverter/NullOrEmptyStringToVisibilityConverter

Converts a string to visibility depending from being null/empty or not.

NumericToGridLengthConverter

Converts an integer to grid length.

NumericToVisibilityConverter/NumericToCollapsedConverter

Converts a number to visibility, deppending from being '0'.

PropertyItemToValueConverter
PropertyNameExistsToVisibility
PropertyNameToItemConverter
PropertyNameToSymbolConverter
PropertyNameToValueConverter
PushpinScaleConverter
SelectiveListToItemsConverter
SortDirectionToSymbolConverter
ToStringFormatConverter

Converts an object ot a formatted string. A format string has to be provided as Parameter (e.g. "#.0"). A special behavior is provided by the format string "0.": in this case the numeric value will be truncated at the separator instead of being rounded!

TypeToVisibilityConverter

Converts the presence of a type to visbility (e.g. whether an object is "String")

ValueValidityToVisibilityConverter

Advanced

StringFormatConverter

Returns a formatted string where placeholders will be filled with values supplied to its parameter properties (Param0, Param1, Param2).

Example:

EvalExpressionConverter

Evaluates a C# expression with 3 optional variables (Param0, Param1, Param2) and returns the result. The object fed into the converter can be referenced in the expression as Context.

Example:

CollectionToViewConverter

Converts a collection into a view that can be filtered using C# expressions and returns the (filtered) result. The object fed into the converter can be referenced in the expression as Item.

Example:

ChildItemTemplateSelectorSuffixConverter

Converts a template selector to use templates with a certain suffix (e.g. "_Grid" to use "UBIKChildItem_Grid.xaml" instead of "UBIKChildItem.xaml"). The small template file name will be combined as <TemplateName><Suffix>Small.xaml (e.g. "UBIKChildItem_GridSmall.xaml").

Example:

Behaviors

Properties

ViewModel
- CurrentDateTime: the current date and time
- UserName: the current user name
- Self: the viewmodel itself
- AppStatus: the appplication status view model

Content
- IsLocked: true, if the content islocked - false, if not
- IsReadOnly: true, if the content can be read only - false, if it is writeable
- ValueSeries: the value series, if available
- MROViewModel: if the content is an MRO related content, this is the sub view model for MRO
- GeoDataViewModel: if the content represents a geo object, this is the geo sub view model
- MetaDefinition: the meta definition of the content object
- Possible Children: collection if meta defintions the user can create new child content with
- ClassificationHandler: a classification handling object
- Content: the actual content object embedded in the viewmodel
- Icon: the content icon as a byte array
- HasIcon: true, if content object has an icon - false, if not
- Title: the content objects title
- SubTitle: the content objects sub title
- OrderId: the order id of the content
- GroupId: the group id of the content
- DownloadEnabled: true, if download is enabled - false, if not
- IsNewObject: true, if the object is created and not yet saved by the user - false, if not
- ToCommit: true, if the object is yet to be committed by pressing save - false, if not
- OfflineDate: date of the last offline download
- ToSave: true, if the object is yet to be saved by pressing save - false, if not
- ToEvaluateQuery: true, if a new query can be evaluated by pressing the sending the query
- ActionOverlayExpanded: true, if the action overlay is expanded - false, if not
- DeletionAllowed: true, if deletion of the object is allowed - false, if not
- RevertLocalChangesAllowed: true, if reverting the object is allowed - false, if not
- IsPictureChildCreationAllowed: true, if the creation of a picture child is allowed - false, if not

GeographyList
- ItemsSortedByZLevel: true, if the current items are sorted by z level - false, if not

PolygonItem
- FillColor: the fill color of the polygon
- FillTransparency: the transparency if the polygon filling

MRO
- ProjectData
- ParentViewModel
- Progress
- Weight
- TechStatus

TaskOwner
- OrgaStatus
- IsConfirmed

Task
- IsBooleanTask
- IsInspectionTask
- IsProgressReportingTask
- IsMeasurementTask
- Value
- PropertyItem
- DisplayValue
- PreviousValue
- Unit
- NotAppliccable
- IsTaskFinished
- IsValueMIssing

WorkPackage
- WPOrgaStatus
- CanConfirm

AlternativeNonDocumentChildrenList

AppStatus
- Initializing
- UserAuthenticated

Authentication
- LandscapeImage
- PortraitImage
- LoginState
- LoginType
- IsLoggedIn
- ShowLoginButton
- EnableLoginButton
- ShowTeamLoginButton
- EnableTeamLoginButton
- ShowLogoutButton
- EnableLogoutButton
- ShowTeamLogoutButton
- EnableTeamLogoutButton
- StatusText
- SplashImage
- AppVersion
- SyncModes
- ContentServiceConfigs
- KeyValues
- Profiles