Krypton Navigator Change List

salmonbrisketΛογισμικό & κατασκευή λογ/κού

2 Νοε 2013 (πριν από 4 χρόνια και 7 μέρες)

779 εμφανίσεις


Krypton
Navigator

Change List



Version 4.2

................................
.............................

2

Bug Fixes

................................
................................
................................
....................

2

Version 4.1.6

................................
..........................

3

Bug Fixes

................................
................................
................................
....................

3

Version 4.1.5

................................
..........................

4

Moved Classes

................................
................................
................................
............

4

New Events

................................
................................
................................
.................

4

New Flags

................................
................................
................................
...................

4

Bug Fixes

................................
................................
................................
....................

4

Version 4.1.1

................................
..........................

5

Bug Fixes

................................
................................
................................
....................

5

Version 4.1

................................
.............................

6

New Events

................................
................................
................................
.................

6

New Flags

................................
................................
................................
...................

6

Bug Fixes

................................
................................
................................
....................

6

Version 4.0

................................
.............................

7

New Modes

................................
................................
................................
.................

7

New Events

................................
................................
................................
.................

7

New Properties

................................
................................
................................
............

8

New Flags

................................
................................
................................
...................

8

New Methods

................................
................................
................................
..............

9

Bug Fixes

................................
................................
................................
....................

9

Version 3.5.
1

................................
........................

10

Changed Methods

................................
................................
................................
.....

10

Bug Fixes

................................
................................
................................
..................

10

Version 3.5.0

................................
........................

11

New Methods

................................
................................
................................
............

11

New Properties

................................
................................
................................
..........

11

New Events

................................
................................
................................
...............

11

Bug Fixes

................................
................................
................................
..................

11

Version 3.0.6

................................
........................

13

Bug Fixes

................................
................................
................................
..................

13


2

Version 4.2

Bug Fixes

Clicking stack buttons at design time not up
dating the properties

For the modes that displayed stack buttons in a vertical arrangement you find that
clicking a check button that then changes positions will not cause the page
properties to be shown in the properties window. This has been fixed.


Tool
Tip background colour incorrect for Office 2010 Black and Silver

Hovering over a tab header for the Office 2010 Black or Silver palettes would
show a tooltip with the Blue background instead of the correct colouring. This has
been fixed.





3

Version 4.1.6

Bug Fixes

Source code compilation could not be used in projects

Compiling the installed source code for the Krypton components would generate
a set of assemblies there could not be easily used in your own projects. Using
those assemblies would fail to find

the correct design time classes and so controls
would appear in the icon tray and be impossible to design. This has been solved
by adding a strong key to the source code and automatically installing them into
the GAC. Now you projects should reference the

GAC assemblies always even
when you have compiled the source code yourself.


4

Version 4.
1.5

Moved Classes

All the design time classes have been removed and placed into the new assembly
ComponentFactory.Krypton.Design
. This allows the
Navigator

assembly to
be
used inside
Client Profile

projects which are available in
Visual Studio 2010.
The
Client Profile

version of the .NET Framework is a subset of the full framework
and allows for smaller installations sizes for client based projects.


New Events

BeforePag
eReorder

This event is fired as a page is being drag reordered using the mouse. The event
can be cancelled and so used to prevent a page from being reordered to positions
you would prefer to prevent. For example, you could use this event to prevent any
tab

being move before the current first tab so that the first tab always remains
positioned at the start. Note that the event is fired multiple times because it is fired
each time the mouse moves over a new tab that might cause reordering to occur.


New Flags

KryptonPageFlags.AllowPageDrag

This page level flag is combined with the
Krypton Navigator

level flag of the
same name. Only if both the page level and navigator level flag are defined can a
page be dragged out of the control.


KryptonPageFlags.AllowPageR
eorder

This page level flag is combined with the
Krypton Navigator

level flag of the
same name. Only if both the page level and navigator level flag are defined can a
page be drag reordered into a new position within the control.


Bug Fixes

Hiding a page i
n response to TabDoubleClicked causes crash

If you hide a page inside the
TabDoubleClicked

event then it causes a crash
because it tries to select the page even though it is no longer visible. This has been
fixed.



5

Version 4.1.1

Bug Fixes

Saving and reloa
ding layouts fails when the Navigator is not visible

If the
Navigator

control is not visible at the time of saving it causes all the pages
to be saved marked as not visible. So on reloading those pages are now not
visible. In practice the visible state of
the navigator should not have an effect on
the visible requirement of the individual pages. This has been fixed.



6

Version 4.1

New Events

KryptonPage.Load

Fired when the page has been created and all the child controls have also been
created. So it operate
s just like the Load event of
Form

and
UserControl
. This is
useful if you need to perform actions once the page is correctly loaded.


TabMoved

This event is fired when a tab is moved to a new indexed position within the
pages collection in response to a us
er reordering the page with the mouse. It is
fired for each position change and so if the user moves a tab several positions to
the left it will be fired several times as it moves to each now location.


PageDrop

Fired when the user drops a page onto the na
vigator and this allows you to cancel
the drop before the page is added to the navigator. It also allows you to modify
the page reference that is added.



New Flags

KryptonPageFlags.DockingAllowDropDown

This flag is used by the docking system to decide if
the header for a docking
control should have a drop down button that allows a change of docking state. By
default the flag is set but you can clear this to remove the drop down button. Note
this flag does not prevent the same menu appearing on a right
-
clic
k of the header.


Bug Fixes

PageInOverflowBarForOutlookMode
flag set by default

The flag is set by default in version 4.0 and this is incorrect. The flag should be
cleared by default and this is now the case.




7

Version 4.0

New Modes

Header
Group
-

Tab

This

new modes shows a primary and secondary header and then inside the
remaining area it displays a
set of tabs
. This mode was added for use in the
docking functionality but might be useful in other scenarios.


New Events

TabCountChanged

TabVisibleCountChange
d

If you need to keep track of when the set of pages inside the navigator changes
you should hook into the new
Tab
CountChanged

event. If instead you want only
to track changes in visible cells then use the
TabV
isibleCountChanged

variation.
This last one is

useful if you wish to track when pages are made hidden and
visible again.


TabMouseHoverStart

TabMouseHoverEnd

When the mouse is over a tab header for a short period of time without moving
the
TabMouseHoverStart

is fired. This allows some custom action to

be
performed such as presenting tool tip style information or automatically selecting
the page.
In fact this event is used internally to show tool tips for tabs if you have
enabled that functionality for the navigator.
When the mouse moves outside of the
tab header the
TabMouseHoverEnd

event is fired so you can reverse the original
action.


TabDoubleClicked

When the user double clicks on a page tab header this event is generated so you
can perform custom actions in response.


PrimaryHeader
Left
Clicked

Prima
ryHeaderRightClicked

PrimaryHeaderDoubleClicked

The first
two
of these are fired when the header is clicked with the left
/right
mouse button and the

third

event fired if another click occurs

within the double
click timing for the left click.


AutoHiddenSli
deSizeChanged

This is fired
when the value of the
AutoHiddenSlideSize

property changes
.



8


New Properties

AllowPage
Reorder

Defined as
True

by default and specifies if the user can reorder the pages by using
the mouse to drag page tabs/buttons to new positio
ns.


AllowTabSelect

A Boolean property that determines is there is allowed to be a selected tab. This is
most useful for the tab strip like modes where clicking a page should not cause
the navigator or the clicked page to become selected.


AutoHiddenSlideS
ize

Use this property when the page is being used in the docking component. It
defines the size to use for the page when it is slide out to be displayed from an
auto hidden group.


Bar.BarLastItemInset

There already exists a property called
BarFirstItemIns
et

that specifies the number
of pixels to inset from the start of the bar to the first tab item. This new property
works at the opposite end and specifies the minimum gap to leave between the
end of the last tab header and the bar.



New Flags

KryptonPageF
lags.AllowConfigSave

When defined this flag indicates that the page details should be saved into the
configuration information. If cleared then this page will be ignored during the
save process.


KryptonPageFlags.DockingAllowClose

KryptonPageFlags.DockingA
llowAutoHidden

KryptonPageFlags.DockingAllowDocked

KryptonPageFlags.DockingAllowFloating

KryptonPageFlags.DockingAllowWorkspace

These flags are used by the docking component to decide which user actions are
allowed to be performed. Each flag relates to an
option that appears in the
docking context menu and that option is only enabled if the flag is defined.
During a drag and drop operation the flags are also used to determine allowable
locations for dropping.


9



New Methods

HideAllPages

ShowAllPages

When cha
nging the visible state of all the pages inside the navigator use these two
new methods. Not only will it reduce the amount of code you have to write
yourself but also performs the action atomically and so removes redrawing flicker
as the pages are progres
sively updated.


Bug Fixes

Design time selection not selecting the correct control when a Navigator is present

In some circumstances you click on a
Form

item to select it but find that it does
not become selected. This happens when the item is to the left
and above the
Navigator

instance and only happens in a few obscure scenarios. This has been
fixed.


Not always generating KryptonPage.VisibleChanged event

If the visible state of the
KryptonPage

is changed to
False

but the parent control
chain is also
Fal
se

then it was not generating the expected
VisibleChanged

event.
This caused the
Navigator

to keep a hidden page as the selected page when it
should not and so when the parent chain becomes visible again you see a selected
page when there should not be one
. This has been fixed.


Incorrect drawing of RibbonTab text colour

When using the Office 2007 Black palette and using ribbon tabs the selected tab
has an incorrectly coloured text that makes it hard to read the tab name. This was
because the state of the d
rawing element was not being updated correctly and so it
always used the
Normal

state for drawing when it should have been
CheckedNormal
. This has been fixed.


Separator not hidden when hidden page added

If you add a new page that is
Visible=False

it will
incorrectly show a separator
line for the page that is not displayed. This visual defect is now fixed.


Tooltips not positioned correctly at bottom of a screen

When showing a tooltip for a page and that tooltip would extend beyond the
bottom of the screen
it would move the tooltip upwards so it did not extend out of
view. Unfortunately this would place the tooltip directly under the mouse and so
cause the tooltip to be removed from view, causing a flickering. This has been
fixed by placing the tooltip above

the page area and cursor.



10

Version 3.5.1

Changed Methods

PerformCloseAction

PerformNextAction

PerformPreviousAction

These methods now return an enumeration value indicating the action that was
performed by the method.


Bug Fixes

Moving a KryptonPage betw
een different Navigator instances crashes ButtonSpecs

If you move a
KryptonPage

from one
Navigator

instance to another then you can
obtain a crash the next time you try to add to the
KryptonPage.ButtonSpecs

collection. The collection was not correctly upda
ted when the page was moved
but this has now been fixed.


Overflow button for OutlookFull mode is incorrectly enabled

When clicking the overflow button in
OutlookFull

mode you have a small context
menu where the last item is called ‘Add / Remove’. This opt
ion is always enabled
even when it does not have any child items. It is now correctly disabled.


OneNote style for ButtonSpec definitions fails

Setting the OneNote style for the style of the ButtonSpec of Navigator fails with
an assertion and then
exceptio
n. This has been fixed.


ContextMenu with many items is too tall for monitor

If you have many pages then the context menu for selecting a new page can be
taller than the available screen height. To prevent this the menu is split into
columns containing 20
items each.




11

Version 3.5
.0

New Methods

PageFromPoint

Use this method to pass in a
Point

in client co
-
ordinates and get back the
KryptonPage

associated with that position. This works only for the header visual
elements that are tabs, ribbon tabs or check
buttons. So it works with stack, check
button and tab modes.


New Properties

KryptonPage.ButtonSpecs

Add button spec entries to this collection in order to show buttons within the
header of this individual page. Just like IE7 with close buttons per page.


Krypton
Navigator
.ToolTipManager

This property allows you access to the internal
ToolTipManager

instance that is
used for showing tool tips at runtime. This allows you to hook into events and
modify the behaviour of tooltip display.


New Events

TabClicked

This new navigator event is fired whenever the mouse is used to click a page
header. Page headers include tabs and check buttons that are seen in many of the
navigator modes.


Bug Fixes

Stack modes cannot be selected in Design mode

When using a stack mode
in the
Navigator

you could not press the stack button at
design time in order to select the page. This makes it difficult to setup the control
at design time because you need to manually change the selected page using the
SelectedPage

property. This has be
en fixed.


Crash with scroll bars showing for stack/outlook modes

At random intervals a crash can occur when you have vertical or horizontal scroll
bars showing in one of the stack/outlook modes. The scroll bars appear if the
minimum size of the selected p
age is bigger than the available display space. This
has been fixed.


Scrollbars move wrong way for stack
/

outlook modes


12

If the minimum size of a page requires adding a vertical scroll bar in one of the
stacking modes, including outlook modes, then the scr
oll bar would move the
opposite way to how you would expect.
This has been fixed.


Visible changes to KryptonPage not recognized

If you are setting the
Visible

property on a
KryptonPage

but accessing the page
via a base class reference such as
Control

then

it would not correctly handle that
change in visibility. This is fixed so even using
Control.Visible

will be noticed
and handled correctly.


13

Version 3.0.
6

Bug Fixes

Text disappear randomly

When using Visual Studio 2005 the text is often not drawn for cont
rols. Or it
would draw but then disappear again not long afterwards. This has been fixed.