CUSTOM_TI_EVENT enumeration

Specifies what kind of event the function is associated to. INITIALIZE, HELPBUTTON_CLICK, and UPDATE_COMMAND_UI are three LinsUI defined events. All the others are winform defined events.

§    ACCEPTS_TAB_CHANGED:           

Equal to AcceptsTabChanged event for TextBox.

§    CHECKED_CHANGED:                  

            Equal to CheckedChanged event for Button and MenuItem.

§    CHECK_STATE_CHANGED:

Equal to CheckStateChanged event for Button and MenuItem.

§    CLICK:       

Equal to Click event for item.

§    BUTTON_CLICK:

Equal to ButtonClick event for SplitButton.

§    BUTTONDOUBLE_CLICK:               

Equal to ButtonDoubleClick event for SplitButton.

§    DROPDOWN:                                 

Equal to DropDown event for ComboBox.

§    DROPDOWN_CLOSED:                  

Equal to DropDownClosed event for MenuItem, DropDownButton, SplitButton, and ComboBox.

§    DROPDOWNITEM_CLICKED:          

Equal to DropDownItemClicked event for MenutItem, DropDownButton, SplitButton.

§    DROPDOWNITEM_OPENED:          

Equal to DropDownOpened event for MenutItem, DropDownButton, SplitButton.

§    DROPDOWNITEM_OPENING:         

Equal to DropDownOpening event for MenutItem, DropDownButton, SplitButton.

§    HELPBUTTON_CLICK:                    

Customized event. When click at the help button on Tooltip, this event will be fired.

§    HIDE_SELECTION_CHANGED:       

Equal to HideSelectionChanged event for TextBox.

§    INITIALIZE:                                     

Customized event. Initialize for all items.

§    KEY_DOWN:                                 

Equal to KeyDown event for ProgressBar, TextBox, and ComboBox.

§    KEY_PRESS:                                

Equal to KeyPress event for ProgressBar, TextBox, and ComboBox.

§    KEY_UP:                                       

Equal to KeyUp event for ProgressBar, TextBox, and ComboBox.

§    MODIFIED_CHANGED:                   

Equal to ModifiedChanged event for TextBox.

§    MOUSE_ENTER:                            

Equal to MouseEnter event for all items.

§    MOUSE_HOVER:                           

Equal to MouseHover event for all items.

§    MOUSE_LEAVE:                            

Equal to MouseLeave event for all items.

§    SELECTED_INDEX_CHANGED:      

Equal to SelectedIndexChanged event for ComboBox.

§    TEXT_CHANGED:                           

Equal to TextChanged event for all items.

§    TEXTBOX_TEXTALIGN_CHANGED:

Equal to TextAlignChanged event for TextBox.

§    TEXT_UPDATE:                              

Equal to TextUpdate event for ComboBox.

§    UPDATE_COMMAND_UI:                

Customized event. When the application is idle, it will raise the event for every tool/menu item to update their status.

The following example demonstrates how to specify and code the handler for the INITIALIZE event of a Dropdown control

Examples 1:

First define a unique ID for m_nColorsDropDownID in LinsResource class as following,

using LinsUI;

public static class LinsResource

{

 // The Category name

[CommandGroupNameAttribute("Colors"),              

 // Tell the application, it is a dropdown button

 CommandTypeAttribute(TSITEM_TYPEID.DROPDOWNBUTTON),  

 // Tooltip for the menu item  

 ToolTipAttribute("Select a color"),   

 // The detail description           

 DetailDescriptionAttribute("Select a color for the selected shapes.")]    

public const long m_nColorsDropDownID = FlexConstants.m_nUserDefinedControlStartID + 5;

}

Then assign the unique ID to the tag of the menu item, and define the handler function for the INITIALIZE event as following,

public partial class ColorsMenu : LinsUI.LinsMenuStrip

{

private ToolStripMenuItem m_Colors;

public ColorsMenu()

{

InitializeComponent();

m_Colors = new ToolStripMenuItem();

// Assign an unique ID to the m_Colors menu dropdown item

m_Colors.Tag = LinsResource.m_nColorsDropDownID;

}

// define the handler function for the INITIALIZE event

// when the Color dropdown is created, this event will be fired and only fired once.

// The user can use this event to do initialization

[CommandIDAttribute(LinsResource.m_nColorsDropDownID),

// The event type, here is an initialize event    

 CommandEventAttribute(CUSTOM_TI_EVENT.INITIALIZE)]

void ColorsInitialize(object sender, System.EventArgs e)

{

// Add all possible colors into the Color dropdown list

foreach (Color_Name pair in DemoManager.m_lsColorName)

{

this.m_Colors.DropDownItems.Add(pair.m_csName);

}

}

}

The following example demonstrates how to specify and code the handler for the UPDATE_COMMAND_UI event of a Dropdown control

Examples 2:

First define a unique ID for m_nColorsDropDownID in LinsResource class as following,

using LinsUI;

public static class LinsResource

{

 // The Category name

[CommandGroupNameAttribute("Colors"),              

 // Tell the application, it is a dropdown button

 CommandTypeAttribute(TSITEM_TYPEID.DROPDOWNBUTTON),  

 // Tooltip for the menu item  

 ToolTipAttribute("Select a color"),   

 // The detail description           

 DetailDescriptionAttribute("Select a color for the selected shapes.")]    

public const long m_nColorsDropDownID = FlexConstants.m_nUserDefinedControlStartID + 5;

}

Then assign the unique ID to the tag of the menu item, and define the handler function for the UPDATE_COMMAND_UI event as following,

public partial class ColorsMenu : LinsUI.LinsMenuStrip

{ 

private ToolStripMenuItem m_Colors;

public ColorsMenu()

{

InitializeComponent();

m_Colors = new ToolStripMenuItem();

// Assign an unique ID to the m_Colors menu dropdown item

m_Colors.Tag = LinsResource.m_nColorsDropDownID;

}

// define the handler function for the UPDATE_COMMAND_UI event 

// when system is on idle, this event will be fired, and

// user can use this to update the user interface for the Color dropdown

[CommandIDAttribute(LinsResource.m_nColorsDropDownID),

 CommandEventAttribute(CUSTOM_TI_EVENT.UPDATE_COMMAND_UI)]

public void OnUpdateUIColorDropDown(object sender, UpdateUIEventArgs ev)

{

ev.Enabled = true;

}

}

The following example demonstrates how to specify and code the handler for the HELPBUTTON_CLICK event of a Dropdown control

Examples 3: