设置输入焦点范例说明 版 本 号 :V1.0 作者:旷宗义 版本记录 【此部分要记录该文档形成过程中的历次版本变更过程及变更的内容】 版本 修改与参与人 修改时间 修改原因 修改概述 审批人1.0 旷宗义 2008/06/24 原始文档建立 一.问题域说明 概述:本文档描述如何设置页面焦点,如何让控件获取焦点; 应用场景:进入页面需要有默认输入焦点,方便用户使用;或者特定情况,需要手动设置用户输入焦点。 二.基本原理 Web 界面组件和 Window 界面组件索引设置均遵循容器组件优先的原则,先是设置最外层容器组件的索引顺序,然后是容器内可获取焦点组件的索引顺序。本文档介绍使用 UBF 进行页面索引设置、控件的 Focus 方法及容器控件 SetFocus 方法实现输入焦点设置,详细请参考文档 UBF2.1UI 开发手册.doc 三.关键代码及说明 1、设置页面默认焦点 页面默认焦点是在设计态的时候指定页面的 TabIndex 来设置的。 步骤如下: 1)、打开 UBF 中相应的 ubfform 文件,选中界面控件树中,选中最上层容器,右键重置所有下级 TabIndex;这样的话,进入界面的时候,平台会自动将焦点置第一个可用的控件。 注:这个是基于平台已经能够自动设置 TabControl 控件中 TabPage 的索引,如果平台不行,请手动按照次序设置 TabPage 的 TabIndex 顺序。 2、手动设置控件获取输入焦点 由于某些特殊原因,我们可能需要手动去设置控件获取焦点,可以通过下面的代码进行设置,通常设置控件状态的动作放在 WebPartBehindExtend 文件中的 AfterUIModelBinding 方法中定义。 public void AfterUIModelBinding() { //直接设置页面焦点 this.Page.SetFocus(this.DocumentType1); //或者 this.DocumentType1.Focus(); } 四.源代码使用说明 由于代码相对简单,不做具体说明。 五.组装发布说明(可选)