<< Click here to display Table of Contents >> Navigation: Install, Configure and Administer GN4 > Configuring GN4 > Reference of Configuring GN4 > XAML controls:

Expander class

Build 1501 on 14/Nov/2017 This topic last edited on: 22/Mar/2016, at 16:30

Contents

Description

Contains definition of an expandable zone.

Members

Name	Identifier.

Style

typically, always {StaticResource NavigatorExpander}.

Grid.Column

Position.

ExpandDirection

Expand direction.

IsExpanded

Default status, true or false.

HorizontalAlignment

Alignment.

Margin

Margin.

Expander.Header

Non-expandable part definition.

NavigatorControl

Contains the definition of an embedded navigator.

Remarks

Under the Grid section, typically after ColumnDefinitions section, in the main tabs definition, or within <l:NavigatorControl section of navigators, you can find a named Expander section.

There are 31 such sections in various main tabs and navigators in the Ted4_TabItems.xml and Fred4_TabItems.xml files and all have various names: "LeftExpander" (9 instances), "RightExpander" (4 instances), "SearchLeftExpander" (3 instances), "SearchRightExpander" (3 instances), "PubDestsExpander", etc.

expander2

The screenshot above shows how various expanders appear on screen.

1.The small expander button < regards the left tray (not used), and the code that starts with <l:ToolBarTrayExpander Name="ExpDockLeft"

2.The zone with this expander < button in the circle and the vertical Navigator label, is the main navigator expander and it's defined in Expander.Header section.

3.This vertical expander button before refresh button expands/collapses the search criteria zone (for Articles navigator, <Expander Name="ArticlesExpander" within <l:ShellTabItem x:Name="Ted4Articles"...).

4.The small expander button, where available, expands the draft view (for Articles navigator, <l:ToolBarTrayExpander IsExpanded="False" Margin="6,0,0,0" Name="RightPanel"...).

The <Expander section within a navigator definition defines the vertical expander for the search criteria zone. The section contains:

•The header zone that always remains on screen (ie. not subject of collapsing/expanding)

•The collapsible/expandable zone (the code below </Expander.Header>)

Header

Within the header of the expander (ie. the zone that always remains on screen), are placed, inside a <StackPanel:

• refresh button that in the CommandParameter="Refresh" part calls the Refresh add-in script

•Saved search control (by the <l:SavedSearchControl... whose SearchCriteriaTarget attribute binds to the search field definitions through {Binding Path=(l:ShellData.ShellData).SearchCriteria[ArticleSearch])

Collapsible zone with search fields

In the collapsible zone are placed the search fields, by the <l:SearchConditionsControl that populates the zone with search fields, and whose SearchCriteriaTarget attribute binds to the search field definitions through {Binding Path=(l:ShellData.ShellData).SearchCriteria[ArticleSearch] (look for Name="ArticleSearch" in the ShellData, under <l:SearchCriteria lines, and then locate the value of the SearchName in the same line; look for that value the Ted4_Config.xml, under the BaseQuery name, specified as

<Expander.Header>

<l:RefreshButton IsDefault="True" HorizontalAlignment="Right" VerticalAlignment="Center" Margin="2,2,2,2"

Command="{x:Static l:Commands.Script}"

CommandParameter="Refresh"/>

<l:SavedSearchControl

MinWidth="200" MaxWidth="300"

Grid.Column="1" HorizontalAlignment="Left"

SearchCriteriaTarget="{Binding Path=(l:ShellData.ShellData).SearchCriteria[ArticleSearch], RelativeSource={RelativeSource Self}}"/>

</StackPanel>

</Expander.Header>

<l:SearchConditionsControl SearchCriteriaTarget="{Binding Path=(l:ShellData.ShellData).SearchCriteria[ArticleSearch], RelativeSource={RelativeSource Self}}"/>

</Expander>

Locating search fields from this position

To locate search fields that are displayed by <l:SearchConditionsControl SearchCriteriaTarget=", first identify the search criteria name (.SearchCriteria[ArticleSearch]) in the same line. Then, scroll up to the first ShellData.ShellData section, and look there in the <l:SearchCriteria lines to find Name="ArticleSearch". In the same line, locate the base query name (value of the BaseQueryName="...") and the search name (value of the Search="..."). With the first value, search the xxx_Config.xml to locate the base query section. With the second value, within the base query section, look for <searchObjectUI name="...".

About search fields placement

All placement of search fields is "black-boxed" in the <l:SearchConditionsControl and you cannot do much about it, except to play around with the labelPosition and orientation attributes under the <searchObjectUI name="...". related section in xxx_Config.xml. labelPosition can be "Above" or "Side", and orientation can be "Horizontal" or "Vertical".