Intersoft ClientUI Documentation
BlockUIOnBusy Property
See Also  Example Send Feedback
Intersoft.Client.UI.Navigation Namespace > UXPage Class : BlockUIOnBusy Property






Gets or sets a value indicating whether the UI elements in the page should be disabled when IsBusy property is true.

Syntax

Visual Basic (Declaration) 
<CategoryAttribute("Common Properties")>
Public Property BlockUIOnBusy As Boolean
Visual Basic (Usage)Copy Code
Dim instance As UXPage
Dim value As Boolean
 
instance.BlockUIOnBusy = value
 
value = instance.BlockUIOnBusy
C# 
[CategoryAttribute("Common Properties")]
public bool BlockUIOnBusy {get; set;}
Delphi 
public read-write property BlockUIOnBusy: Boolean; 
JScript 
CategoryAttribute("Common Properties")
public function get,set BlockUIOnBusy : boolean
Managed Extensions for C++ 
[CategoryAttribute("Common Properties")]
public: __property bool get_BlockUIOnBusy();
public: __property void set_BlockUIOnBusy( 
   bool value
);
C++/CLI 
[CategoryAttribute("Common Properties")]
public:
property bool BlockUIOnBusy {
   bool get();
   void set (    bool value);
}

Example

The following example shows how to setup the page to block the user interaction when busy.
XAMLCopy Code
<Intersoft:UXPage
        ... 
        xmlns:Intersoft="http://intersoft.clientui.com/schemas"
        xmlns:ViewModels="clr-namespace:ClientUIBusinessApp1.ViewModels"
        x:Class="ClientUIBusinessApp1.RegisterForm" 
        IsBusy="{Binding Path=IsBusy}"
        BlockUIOnBusy="true">

    <Intersoft:UXPage.DataContext>
        <ViewModels:RegisterFormViewModel/>
    </Intersoft:UXPage.DataContext>

    <Grid x:Name="LayoutRoot">
    ...
    </Grid>
</Intersoft:UXPage>

Remarks

In most cases, you may want to block the user interface from being accessible by users when processing a longer operation such as data loading or updating. To do this, you simply set the BlockUIOnBusy property of the page to true.

With BlockUIOnBusy enabled, the user interface elements such as text boxes, buttons and other input controls will be automatically disabled when the IsBusy property of the page is set to true. In addition, the cursor will indicate a busy state for the page region which complies to usability standards.

For more information, see Advanced Features in ClientUI Navigation Framework.

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2012 All Rights Reserved.