@compass-framework/core 1.2.58 → 1.2.60

package/@types/ApplicationWindow.d.ts

@@ -1,10 +1,9 @@
 import { ArrayList, Implements, XML } from "@compass-framework/library";
 import { Resources } from "./Resources";
 import { View } from "./View";
-import { WindowContext } from "./WindowContext";
+import { Context } from "./Context";
 import { WindowManager } from "./WindowManager";
 import { ViewGroup } from "./ViewGroup";
-import { Context } from "./Context";
 import { Window } from "./Window";
 import { Configuration } from "./Configuration";
 
@@ -14,7 +13,7 @@ import { Configuration } from "./Configuration";
 @Implements(Window)
 export declare class ApplicationWindow implements Window {
   public constructor();
-  public constructor(context: WindowContext);
+  public constructor(context: Context);
 
   public findViewById(id: number): View;
   public findViewById(id: string): View;

package/@types/Color.d.ts

@@ -30,11 +30,11 @@ export declare namespace Color {
 
   export function blue(color: number): number;
 
-  export function argb(alpha: number, red: number, green: number, blue: number);
+  export function argb(alpha: number, red: number, green: number, blue: number): number;
 
   export function hue(color: number): number;
 
-  export function rgb(red: number, green: number, blue: number);
+  export function rgb(red: number, green: number, blue: number): number;
 
   export function pin(value: number): number;
 

package/@types/Drawable.d.ts

@@ -11,42 +11,107 @@ import { DisplayMetrics } from "./DisplayMetrics";
  * 可绘制对象的基类，封装边界、透明度与绘制回调。
  */
 export declare abstract class Drawable {
+  /**
+   * 使用运行时上下文构造 Drawable。
+   */
   protected constructor(context: Context);
 
+  /**
+   * 将当前内容绘制到指定画布。
+   */
   public abstract draw(canvas: Canvas): void;
 
+  /**
+   * 设置整体透明度，取值范围为 0–255。
+   */
   public abstract setAlpha(alpha: number): void;
 
+  /**
+   * 返回当前不透明度。
+   */
   public abstract getOpacity(): number;
 
+  /**
+   * 设备或主题等配置变化时回调。
+   */
   public onConfigurationChanged(newConfig: Configuration): void;
 
+  /**
+   * 边界矩形变化时回调。
+   */
   public onBoundsChange(bounds: Rect): void;
 
+  /**
+   * 屏幕密度变化时回调。
+   */
   public onDensityChanged(newConfig: Configuration): void;
 
+  /**
+   * 复制并返回当前边界矩形。
+   */
   public copyBounds() : Rect;
+  /**
+   * 将当前边界复制到指定矩形。
+   */
   public copyBounds(bounds: Rect): void;
 
+  /**
+   * 返回建议的最小宽度。
+   */
   public getMinimumWidth(): number;
 
+  /**
+   * 返回建议的最小高度。
+   */
   public getMinimumHeight(): number;
 
+  /**
+   * 返回当前绘制边界矩形。
+   */
   public getBounds(): Rect;
 
+  /**
+   * 返回关联的运行时上下文。
+   */
+  public getContext(): Context;
+
+  /**
+   * 将外形轮廓写入指定 Outline。
+   */
   public getOutline(outline:Outline):void;
 
+  /**
+   * 返回当前失效与调度回调。
+   */
   public getCallback() :Drawable.Callback;
 
+  /**
+   * 返回固有宽度；未知时为 -1。
+   */
   public getIntrinsicWidth(): number;
 
+  /**
+   * 返回固有高度；未知时为 -1。
+   */
   public getIntrinsicHeight():number;
 
+  /**
+   * 返回当前显示度量。
+   */
   public getDisplayMetrics(): DisplayMetrics;
 
+  /**
+   * 使用矩形设置绘制边界。
+   */
   public setBounds(bounds: Rect): void;
+  /**
+   * 使用左、上、右、下坐标设置绘制边界。
+   */
   public setBounds(left: number, top: number, right: number, bottom: number): void;
 
+  /**
+   * 设置失效与调度回调。
+   */
   public setCallback(callback: Drawable.Callback): void;
 }
 
@@ -58,10 +123,19 @@ export declare namespace Drawable {
    * Drawable 的不可变常量状态，用于创建新实例。
    */
   export abstract class ConstantState {
+    /**
+     * 基于常量状态创建新的 Drawable。
+     */
     public abstract newDrawable(): Drawable;
 
+    /**
+     * 使用指定资源创建新的 Drawable。
+     */
     public newResourcesDrawable(res: Resources): Drawable;
 
+    /**
+     * 返回会影响该状态的配置变更掩码。
+     */
     public abstract getChangingConfigurations(): number;
   }
 
@@ -69,12 +143,24 @@ export declare namespace Drawable {
    * Drawable 失效与调度回调接口。
    */
   export interface Callback {
+    /**
+     * 通知宿主指定 Drawable 需要重绘。
+     */
     invalidateDrawable(who:Drawable): void
 
+    /**
+     * 在指定时间调度 Drawable 的回调。
+     */
     scheduleDrawable(who: Drawable, what: Runnable, when: number): void
 
+    /**
+     * 取消已调度的 Drawable 回调。
+     */
     unScheduleDrawable(who: Drawable, what: Runnable): void
 
+    /**
+     * 返回宿主关联的资源管理器。
+     */
     getResources(): Resources;
   }
 

package/@types/Gravity.d.ts

@@ -4,29 +4,29 @@ import { Rect } from "./Rect";
  * 重力对齐常量与布局定位工具。
  */
 export declare class Gravity {
-  public static NO_GRAVITY;
-  public static AXIS_PULL_BEFORE;
-  public static AXIS_SPECIFIED;
-  public static AXIS_PULL_AFTER;
-  public static AXIS_CLIP;
-  public static AXIS_X_SHIFT;
-  public static AXIS_Y_SHIFT;
-  public static TOP;
-  public static BOTTOM;
-  public static LEFT;
-  public static RIGHT;
-  public static CENTER_VERTICAL;
-  public static FILL_VERTICAL;
-  public static CENTER_HORIZONTAL;
-  public static FILL_HORIZONTAL;
-  public static CENTER;
-  public static FILL;
-  public static CLIP_VERTICAL;
-  public static CLIP_HORIZONTAL;
-  public static HORIZONTAL_GRAVITY_MASK;
-  public static VERTICAL_GRAVITY_MASK;
-  public static DISPLAY_CLIP_VERTICAL;
-  public static DISPLAY_CLIP_HORIZONTAL;
+  public static NO_GRAVITY: number;
+  public static AXIS_PULL_BEFORE: number;
+  public static AXIS_SPECIFIED: number;
+  public static AXIS_PULL_AFTER: number;
+  public static AXIS_CLIP: number;
+  public static AXIS_X_SHIFT: number;
+  public static AXIS_Y_SHIFT: number;
+  public static TOP: number;
+  public static BOTTOM: number;
+  public static LEFT: number;
+  public static RIGHT: number;
+  public static CENTER_VERTICAL: number;
+  public static FILL_VERTICAL: number;
+  public static CENTER_HORIZONTAL: number;
+  public static FILL_HORIZONTAL: number;
+  public static CENTER: number;
+  public static FILL: number;
+  public static CLIP_VERTICAL: number;
+  public static CLIP_HORIZONTAL: number;
+  public static HORIZONTAL_GRAVITY_MASK: number;
+  public static VERTICAL_GRAVITY_MASK: number;
+  public static DISPLAY_CLIP_VERTICAL: number;
+  public static DISPLAY_CLIP_HORIZONTAL: number;
 
   public static convert(type: string, defaultValue?: number): number;
 

package/@types/Paint.d.ts

@@ -13,122 +13,314 @@ import { ImageFilter } from "./ImageFilter";
  * 画笔，描述颜色、样式、字体等绘制属性。
  */
 export interface Paint {
+  /**
+   * 测量整段文本的绘制宽度。
+   */
   measureText(text: CharSequence): number;
+
+  /**
+   * 测量指定区间文本的绘制宽度。
+   */
   measureText(text: CharSequence, start: number, end: number): number;
 
+  /**
+   * 从另一支画笔复制全部属性，并返回自身。
+   */
   set(paint: Paint): Paint
 
+  /**
+   * 按像素对齐调整描边位置，使线条绘制更锐利。
+   */
   adjustForPixelPerfectLine(pixel: number): void;
 
+  /**
+   * 返回是否启用抗锯齿。
+   */
   isAntiAlias(): boolean;
 
+  /**
+   * 返回文本是否应用了水平倾斜。
+   */
   isTextSkewX(): boolean;
 
+  /**
+   * 返回像素对齐描边的调整值。
+   */
   getPixelPerfectLine(): number
 
+  /**
+   * 返回字体度量信息。
+   */
   getFontMetrics(): Paint.FontMetrics
+
+  /**
+   * 将字体度量写入指定对象，并返回行距。
+   */
   getFontMetrics(fontMetrics: Paint.FontMetrics): number
 
+  /**
+   * 获取整段文本中每个字符的宽度，返回测量的字符数。
+   */
   getTextWidths(text: CharSequence, widths: number[]): number
+
+  /**
+   * 获取指定区间文本中每个字符的宽度，返回测量的字符数。
+   */
   getTextWidths(text: CharSequence, start: number, end: number, widths: number[]): number
+
+  /**
+   * 从字符串数组指定位置起测量字符宽度，返回测量的字符数。
+   */
   getTextWidths(text: string[], index:number, count:number, widths: number[]): number
 
+  /**
+   * 将整段文本的包围盒写入指定矩形。
+   */
   getTextBounds(text: CharSequence, bounds: Rect): void
+
+  /**
+   * 将指定区间文本的包围盒写入指定矩形。
+   */
   getTextBounds(text: CharSequence, start: number, end: number, bounds: Rect): void
 
+  /**
+   * 在最大宽度内截断文本，返回实际测量的字符数。
+   */
   breakText(text: CharSequence, measureForwards: boolean, maxWidth: number, measuredWidth: number[]): number
+
+  /**
+   * 在最大宽度内截断指定区间文本，返回实际测量的字符数。
+   */
   breakText(text: CharSequence, start: number, end: number, measureForwards: boolean, maxWidth: number, measuredWidth: number[]): number
 
+  /**
+   * 返回填充/描边绘制样式。
+   */
   getStyle(): Paint.Style;
 
+  /**
+   * 复制当前画笔并返回新实例。
+   */
   copy(): Paint;
 
+  /**
+   * 返回图像滤镜。
+   */
   getImageFilter(): ImageFilter;
 
+  /**
+   * 返回画笔标志位。
+   */
   getFlags(): number
 
+  /**
+   * 返回透明度，取值范围为 0–255。
+   */
   getAlpha(): number
 
+  /**
+   * 返回当前颜色（ARGB 数值）。
+   */
   getColor(): number
 
+  /**
+   * 返回当前颜色的字符串表示。
+   */
   getColorString(): string
 
+  /**
+   * 返回描边转角连接样式。
+   */
   getStrokeJoin(): Paint.Join
 
+  /**
+   * 返回描边端点样式。
+   */
   getStrokeCap(): Paint.Cap
 
+  /**
+   * 返回阴影效果。
+   */
   getShadow(): Shadow
 
+  /**
+   * 返回文本字号。
+   */
   getTextSize(): number
 
+  /**
+   * 返回颜色滤镜。
+   */
   getColorFilter(): ColorFilter;
 
+  /**
+   * 返回文本水平对齐方式。
+   */
   getTextAlign(): Paint.Align
 
+  /**
+   * 返回着色器。
+   */
   getShader(): Shader;
 
+  /**
+   * 返回描边宽度。
+   */
   getStrokeWidth(): number
 
+  /**
+   * 返回文本水平倾斜值。
+   */
   getTextSkewX(): number;
 
+  /**
+   * 返回是否启用伪粗体。
+   */
   getFakeBoldText(): boolean;
 
+  /**
+   * 返回混合模式。
+   */
   getBlendMode(): BlendMode;
 
+  /**
+   * 返回当前字体。
+   */
   getTypeface(): Typeface;
 
+  /**
+   * 返回路径效果。
+   */
   getPathEffect(): PathEffect
 
+  /**
+   * 返回文本水平缩放比例。
+   */
   getTextScaleX(): number;
 
+  /**
+   * 设置描边宽度。
+   */
   setStrokeWidth(width: number): void
 
+  /**
+   * 设置路径效果。
+   */
   setPathEffect(pathEffect: PathEffect): void
 
+  /**
+   * 设置是否启用抗锯齿。
+   */
   setAntiAlias(aa: boolean): void;
 
+  /**
+   * 设置颜色（ARGB 数值）。
+   */
   setColor(color: number): void
 
+  /**
+   * 设置描边转角连接样式。
+   */
   setStrokeJoin(join: Paint.Join): void
 
+  /**
+   * 设置文本字号。
+   */
   setTextSize(textSize: number): void
 
+  /**
+   * 设置描边端点样式。
+   */
   setStrokeCap(cap: Paint.Cap): void
 
+  /**
+   * 返回推荐行距。
+   */
   getFontSpacing(): number;
 
+  /**
+   * 设置文本水平对齐方式。
+   */
   setTextAlign(textAlign: Paint.Align): void
 
+  /**
+   * 设置画笔标志位。
+   */
   setFlags(flags: number): void
 
+  /**
+   * 设置图像滤镜。
+   */
   setImageFilter(imageFilter: ImageFilter): void;
 
+  /**
+   * 设置填充/描边绘制样式。
+   */
   setStyle(style: Paint.Style): void
 
+  /**
+   * 设置透明度，取值范围为 0–255。
+   */
   setAlpha(a: number): void
 
+  /**
+   * 设置阴影效果。
+   */
   setShadow(shadow: Shadow): void
 
+  /**
+   * 设置着色器。
+   */
   setShader(shader: Shader): void
 
+  /**
+   * 设置颜色滤镜。
+   */
   setColorFilter(filter: ColorFilter): void;
 
+  /**
+   * 按 Alpha、红、绿、蓝分量设置颜色。
+   */
   setARGB(a: number, r: number, g: number, b: number): void
 
+  /**
+   * 设置字体。
+   */
   setTypeface(typeface: Typeface): void;
 
+  /**
+   * 设置文本水平缩放比例。
+   */
   setTextScaleX(scaleX: number): void;
 
+  /**
+   * 设置文本水平倾斜值。
+   */
   setTextSkewX(value: number): void;
 
+  /**
+   * 设置是否启用伪粗体。
+   */
   setFakeBoldText(value: boolean): void;
 
+  /**
+   * 设置混合模式。
+   */
   setBlendMode(mode: BlendMode): void;
 
+  /**
+   * 设置是否绘制删除线。
+   */
   setStrikeThruText(value: boolean): void;
 
+  /**
+   * 释放画笔占用的资源。
+   */
   dispose(): void;
 
+  /**
+   * 返回画笔属性的字符串描述。
+   */
   toString(): CharSequence;
 }
 
@@ -141,21 +333,58 @@ export abstract class Paint extends InterfaceTemplate {}
  * Paint 相关类型与工厂方法。
  */
 export namespace Paint {
+  /**
+   * 下划线文本标志位。
+   */
   export const UNDERLINE_TEXT_FLAG: number;
+
+  /**
+   * 删除线文本标志位。
+   */
   export const STRIKE_THRU_TEXT_FLAG: number;
 
   /**
    * 字体度量信息。
    */
   export class FontMetrics {
+    /**
+     * 基线以上的推荐上升距离（通常为负）。
+     */
     public ascent: number;
+
+    /**
+     * 基线以下的推荐下降距离（通常为正）。
+     */
     public descent: number;
+
+    /**
+     * 基线以上的最大上升距离（通常为负）。
+     */
     public top: number;
+
+    /**
+     * 基线以下的最大下降距离（通常为正）。
+     */
     public bottom: number;
+
+    /**
+     * 额外行距。
+     */
     public leading: number;
+
+    /**
+     * 字形相对绘制原点的最左边界。
+     */
     public left: number;
+
+    /**
+     * 字形相对绘制原点的最右边界。
+     */
     public right: number;
 
+    /**
+     * 从另一组度量复制全部字段，并返回自身。
+     */
     public set(metrics: FontMetrics): FontMetrics;
   }
 
@@ -163,8 +392,19 @@ export namespace Paint {
    * 描边转角连接样式。
    */
   export enum Join {
+    /**
+     * 斜角连接。
+     */
     BEVEL = "bevel",
+
+    /**
+     * 尖角连接。
+     */
     MITER = "miter",
+
+    /**
+     * 圆角连接。
+     */
     ROUND = "round",
   }
 
@@ -172,8 +412,19 @@ export namespace Paint {
    * 描边端点样式。
    */
   export enum Cap {
+    /**
+     * 平端，精确停在路径端点。
+     */
     BUTT = "butt",
+
+    /**
+     * 圆端，以端点为圆心向外延伸半个线宽。
+     */
     ROUND = "round",
+
+    /**
+     * 方端，向外延伸半个线宽的矩形。
+     */
     SQUARE = "square",
   }
 
@@ -181,8 +432,19 @@ export namespace Paint {
    * 填充与描边绘制样式。
    */
   export enum Style {
+    /**
+     * 仅填充内部。
+     */
     FILL,
+
+    /**
+     * 仅描边轮廓。
+     */
     STROKE,
+
+    /**
+     * 同时填充内部并描边轮廓。
+     */
     FILL_AND_STROKE,
   }
 
@@ -190,8 +452,19 @@ export namespace Paint {
    * 文本水平对齐方式。
    */
   export enum Align {
+    /**
+     * 左对齐。
+     */
     LEFT = 'left',
+
+    /**
+     * 居中对齐。
+     */
     CENTER = 'center',
+
+    /**
+     * 右对齐。
+     */
     RIGHT = 'right',
   }