BlockUIOnBusy Property (UXPage)

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)
Visual Basic (Usage)
C#
C++/CLI

<CategoryAttribute("Common Properties")>
Public Property BlockUIOnBusy As Boolean

Dim instance As UXPage
Dim value As Boolean
 
instance.BlockUIOnBusy = value
 
value = instance.BlockUIOnBusy

[CategoryAttribute("Common Properties")]
public bool BlockUIOnBusy {get; set;}

[CategoryAttribute("Common Properties")]
public:
property bool BlockUIOnBusy {
   bool get();
   void set (    bool value);
}

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.

Example

The following example shows how to setup the page to block the user interaction when busy.

XAML

<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>

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

UXPage Class
UXPage Members
Navigation Overview