////////////////////////////////////////////////////////////////////////////////////// // // Copyright (c) 2014-present, Egret Technology. // All rights reserved. // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are met: // // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above copyright // notice, this list of conditions and the following disclaimer in the // documentation and/or other materials provided with the distribution. // * Neither the name of the Egret nor the // names of its contributors may be used to endorse or promote products // derived from this software without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY EGRET AND CONTRIBUTORS "AS IS" AND ANY EXPRESS // OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES // OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. // IN NO EVENT SHALL EGRET AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, // INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;LOSS OF USE, DATA, // OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF // LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING // NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, // EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // ////////////////////////////////////////////////////////////////////////////////////// namespace eui { /** * The HScrollBar (horizontal scrollbar) control lets you control * the portion of data that is displayed when there is too much data * to fit horizontally in a display area. * *
Although you can use the HScrollBar control as a stand-alone control, * you usually combine it as part of another group of components to * provide scrolling functionality.
* * @includeExample extension/eui/components/HScrollBarExample.ts * @version Egret 2.4 * @version eui 1.0 * @platform Web,Native * @language en_US */ /** * HScrollBar(水平 ScrollBar)控件可以在因数据太多而不能在显示区域中以水平方向完全显示时控制显示的数据部分。 *虽然 HScrollBar 控件可以单独使用,但通常将它与其他组件一起使用来提供滚动功能。
* * @includeExample extension/eui/components/HScrollBarExample.ts * @version Egret 2.4 * @version eui 1.0 * @platform Web,Native * @language zh_CN */ export class HScrollBar extends ScrollBarBase { /** * @inheritDoc * * @version Egret 2.4 * @version eui 1.0 * @platform Web,Native */ protected updateDisplayList(unscaledWidth:number, unscaledHeight:number):void { super.updateDisplayList(unscaledWidth, unscaledHeight); let thumb = this.thumb; let viewport = this.$viewport; if (!thumb || !viewport) { return; } let bounds = egret.$TempRectangle; thumb.getPreferredBounds(bounds); let thumbWidth = bounds.width; let thumbY = bounds.y; let hsp = viewport.scrollH; let contentWidth = viewport.contentWidth; let width = viewport.width; if (hsp <= 0) { let scaleWidth = thumbWidth * (1-(-hsp) / (width * 0.5)); scaleWidth = Math.max(5,Math.round(scaleWidth)); thumb.setLayoutBoundsSize(scaleWidth, NaN); thumb.setLayoutBoundsPosition(0, thumbY); } else if (hsp >= contentWidth - width) { let scaleWidth = thumbWidth * (1-(hsp - contentWidth + width) / (width * 0.5)); scaleWidth = Math.max(5,Math.round(scaleWidth)); thumb.setLayoutBoundsSize(scaleWidth, NaN); thumb.setLayoutBoundsPosition(unscaledWidth - scaleWidth, thumbY); } else { let thumbX = (unscaledWidth-thumbWidth) * hsp / (contentWidth - width); thumb.setLayoutBoundsSize(NaN, NaN); thumb.setLayoutBoundsPosition(thumbX, thumbY); } } /** * @inheritDoc * * @version Egret 2.4 * @version eui 1.0 * @platform Web,Native */ protected onPropertyChanged(event:eui.PropertyEvent):void { switch (event.property) { case "scrollH": case "contentWidth": this.invalidateDisplayList(); break; } } } }