WECHAT
微信
mail
mxcad

简体中文

English

简体中文

English

Appearance

mxcad_2d API 文档 / 2d / MxCADUiPrBase

Class: MxCADUiPrBase ​

2d.MxCADUiPrBase

交互取点基类，封装用户交互输入的通用功能。

Description

MxCADUiPrBase 是所有 MxCADUiPr* 系列交互类的抽象基础，封装了与用户交互取点、关键字输入、 动态绘制、提示信息、捕捉设置等常用行为。子类通常通过传入不同的内部实现（如 MrxDbgUiPrPoint、 MrxDbgUiPrDist 等）来实现具体的交互语义，但共享如下能力：

  • 设置/获取提示消息（setMessage / message）
  • 管理关键字列表与检测用户选择（setKeyWords / keyWordPicked / isKeyWordPicked）
  • 设置动态绘制回调以在交互过程中绘制临时图形（setUserDraw）
  • 获取交互结果的详细退出原因与类型（getDetailedResult / getStatus / getResultPointType）
  • 控制动态输入、极轴/格网/捕捉等跟踪行为（setDisableDynInput / setDisablePolarAxisTrace 等）

使用方法:

  1. 直接使用已有子类（如 MxCADUiPrPoint、MxCADUiPrDist 等）完成具体取点/取距操作；
  2. 或通过继承 MxCADUiPrBase 并传入自定义内部实现（imp）来实现新的交互控件；
  3. 在交互前设置提示、关键字、动态绘制回调等，调用子类的 go() 方法获取用户输入。

Example

ts
import { MxCADUiPrPoint } from 'mxcad';

async function example() {
  const getPoint = new MxCADUiPrPoint();
  getPoint.setMessage('\n指定第一个点:');
  getPoint.setUserDraw((pt, worldDraw) => {
    // 在动态绘制回调中绘制临时标记
    worldDraw.drawCircle(pt.toVector3(), 10);
  });
  const pt = await getPoint.go();
  if (!pt) return;
}

Hierarchy ​

Table of contents ​

Constructors ​

Methods ​

Constructors ​

constructor ​

• new MxCADUiPrBase(imp)

构造函数

Parameters ​

NameTypeDescription
impany内部实现对象

Methods ​

abort ​

▸ abort(cause?): void

停止当前动态拖动

Parameters ​

NameTypeDefault value
causeDetailedResultDetailedResult.kCodeAbort

Returns ​

void

void

clearLastInputPoint ​

▸ clearLastInputPoint(): void

清除上一次的输入点数据。

Returns ​

void

disableAllTrace ​

▸ disableAllTrace(isDisable?): void

禁用所有跟踪

Parameters ​

NameTypeDefault valueDescription
isDisablebooleantrue是否禁用

Returns ​

void

drawReserve ​

▸ drawReserve(callAddEntity?): void

把动态绘制的对象，保留到图上。

Parameters ​

NameTypeDescription
callAddEntity?(ent: Object3D) => void回调参数ent 类型：THREE.THREE.Object3D

Returns ​

void

Example

ts
//以 MxCADUiPrPoint 类示例
 import { MxCADUiPrPoint } from 'mxcad';

 async function test(){
   const getPoint = new MxCADUiPrPoint();
   const basePt = new McGePoint3d(0, 0, 0);
   getPoint.setBasePt(basePt);
   getPoint.setUserDraw((pt,pw)=>{
   const line = new McDbLine(basePt, pt);
   pw.drawMcDbEntity(line)
   })
   const val = await getPoint.go();
   if (!val) return;
   getPoint.drawReserve()
 }

getCursorType ​

▸ getCursorType(): MxCursorType

返回光标类型

Returns ​

MxCursorType

getDetailedResult ​

▸ getDetailedResult(): DetailedResult

返回交互操作退出的详细原因

Returns ​

DetailedResult

当前交互操作返回值类型

Example

ts
//以 MxCADUiPrDist 类示例
  import { MxCADUiPrDist } from 'mxcad';
  import { DetailedResult } from "mxdraw";

  async function test(){
    const getDist = new MxCADUiPrDist();
    const val = await getDist.go();
    if (!val) return;
    if (getDist.getDetailedResult() === DetailedResult.kCoordIn) {
        console.log('提示输入', val)
    }
  }

getDynamicInputType ​

▸ getDynamicInputType(): DynamicInputType

返回动态输入类型

Returns ​

DynamicInputType

动态输入显示类型

getInputToucheType ​

▸ getInputToucheType(): number

返回需要的Touche输入类型

Returns ​

number

Touche输入类型

getLastInputPoint ​

▸ getLastInputPoint(): undefined | McGePoint3d

返回上一次的输入点。

Returns ​

undefined | McGePoint3d

选择的关键字

getResultPointOsnapMode ​

▸ getResultPointOsnapMode(): AcquirePointOsnapMode

返回交互取点操作得到的点的捕捉类型

Returns ​

AcquirePointOsnapMode

getResultPointType ​

▸ getResultPointType(): AcquirePointType

返回交互取点操作得到的点类型

Returns ​

AcquirePointType

getStatus ​

▸ getStatus(): MrxDbgUiPrBaseReturn

获取操作状态

Returns ​

MrxDbgUiPrBaseReturn

操作状态值

Example

ts
//以 MxCADUiPrDist 类示例
 import { MxCADUiPrDist } from 'mxcad';
 import { MrxDbgUiPrBaseReturn } from "mxdraw";

 const getDist = new MxCADUiPrDist();
 const val = await getDist.go();
 if (!val) return;
 if(getPoint.getStatus() === MrxDbgUiPrBaseReturn.kNone) {
   // 空输入
 }

isDisableDynInput ​

▸ isDisableDynInput(): boolean

是否禁用动态输入框

Returns ​

boolean

isDisableDynamicTrace ​

▸ isDisableDynamicTrace(): boolean

是否禁用动态跟踪

Returns ​

boolean

isDisableGridTrace ​

▸ isDisableGridTrace(): boolean

是否禁用格网追踪

Returns ​

boolean

isDisableOrthoTrace ​

▸ isDisableOrthoTrace(): boolean

是否禁用正射追踪

Returns ​

boolean

isDisableOsnap ​

▸ isDisableOsnap(): boolean

是否禁用捕捉

Returns ​

boolean

isDisablePolarAxisTrace ​

▸ isDisablePolarAxisTrace(): boolean

是否禁用极轴跟踪

Returns ​

boolean

isKeyWordPicked ​

▸ isKeyWordPicked(matchKeyWord): boolean

测试某一个关键字是否被用户选择

Parameters ​

NameTypeDescription
matchKeyWordstring要检测的关键字

Returns ​

boolean

true为真

Example

ts
  //以 MxCADUiPrPoint 类示例
  import { MxCADUiPrPoint } from 'mxcad';

 async function test(){
   const getPoint = new MxCADUiPrPoint();
   getPoint.setKeyWords("[选项1(A)/选项2(B)]");
   const pt = await getPoint.go();
   if(getPoint.isKeyWordPicked('A')){
       console.log('选项1')
   }else if(getPoint.isKeyWordPicked('B')){
       console.log('选项2')
   }
 }

isOffsetInputPostion ​

▸ isOffsetInputPostion(): boolean

输入点是否偏移显示/处理

Returns ​

boolean

keyWordPicked ​

▸ keyWordPicked(): string

返回用户选择的关键字

Returns ​

string

选择的关键字

Example

ts
  //以 MxCADUiPrPoint 类示例
  import { MxCADUiPrPoint } from 'mxcad';

  async function test(){
   const getPoint = new MxCADUiPrPoint();
   getPoint.setKeyWords("[选项1(A)/选项2(B)]");
   const pt = await getPoint.go();
   const key = getPoint.keyWordPicked();
   console.log(key)
  }

keyWords ​

▸ keyWords(): string

返回关键字列表

Returns ​

string

关键词列表

Example

ts
//以 MxCADUiPrPoint 类示例，其他MxCADUiPr* 系列的类同理
  import { MxCADUiPrPoint } from 'mxcad'
  const getPoint = new MxCADUiPrPoint();
  getPoint.setKeyWords("[选项1(A)/选项2(B)]");
  const keyList = getPoint.keyWords();
  console.log("关键词列表", keyList)// 关键词列表 [选项1(A)/选项2(B)]

message ​

▸ message(): string

提示字符串

Returns ​

string

提示消息

setCursorType ​

▸ setCursorType(type): void

设置光标类型

Parameters ​

NameTypeDescription
typeMxCursorType鼠标样式类型

Returns ​

void

Example

ts
//以 MxCADUiPrPoint 类示例
  import { MxCADUiPrPoint } from 'mxcad';
  import { MxCursorType } from "mxdraw";

  async function test(){
   const getPoint = new MxCADUiPrPoint()
   getPoint.setMessage("指定文字起点:")
   getPoint.setCursorType(MxCursorType.kCross);
   const pt = await getPoint.go();
  }

setDisableDynInput ​

▸ setDisableDynInput(isDisable): void

设置是否禁用动态输入框

Parameters ​

NameTypeDescription
isDisableboolean是否禁用

Returns ​

void

setDisableDynamicTrace ​

▸ setDisableDynamicTrace(isDisable): void

设置是否禁用动态跟踪

Parameters ​

NameTypeDescription
isDisableboolean是否禁用

Returns ​

void

setDisableGridTrace ​

▸ setDisableGridTrace(isDisable): void

设置是否禁用格网追踪

Parameters ​

NameTypeDescription
isDisableboolean是否禁用

Returns ​

void

setDisableOrthoTrace ​

▸ setDisableOrthoTrace(isDisable): void

设置是否禁用正射追踪

Parameters ​

NameTypeDescription
isDisableboolean是否禁用

Returns ​

void

setDisableOsnap ​

▸ setDisableOsnap(isDisable): void

设置是否禁用捕捉

Parameters ​

NameTypeDescription
isDisableboolean是否禁用

Returns ​

void

setDisablePolarAxisTrace ​

▸ setDisablePolarAxisTrace(isDisable): void

设置是否禁用极轴跟踪

Parameters ​

NameTypeDescription
isDisableboolean是否禁用

Returns ​

void

setDynamicInputType ​

▸ setDynamicInputType(type): void

设置动态输入类型

Parameters ​

NameTypeDescription
typeDynamicInputType动态输入显示类型

Returns ​

void

Example

ts
//以 MxCADUiPrPoint 类示例
  import { MxCADUiPrPoint } from 'mxcad';
  import { DynamicInputType } from "mxdraw";

  async function Mx_WindowZoom() {
    let getPoint = new MxCADUiPrPointTransform(MxInsidePublicFuns.getMxCADViewSpinMatrix(MxCpp.getCurrentMxCAD()));
    getPoint.disableAllTrace();
    getPoint.setMessage("\n点取缩放区域");
    getPoint.setDynamicInputType(DynamicInputType.kDynTip);
    let pt1 = await getPoint.go();
    if (pt1 == null) return;
    let mxcad = MxCpp.getCurrentMxCAD();
    getPoint.setUserDraw((p1, worldDraw) => {
        worldDraw.drawRect(MxCoordConvert.cad2doc1((pt1 as any)), MxCoordConvert.cad2doc1((p1 as any)));
    });

    let pt2 = await getPoint.go();
    if (pt2 == null) return;

    pt1.transformBy(getPoint.rmat);
    pt2.transformBy(getPoint.rmat);
    mxcad.zoomW(pt1, pt2);
 }

setInputToucheType ​

▸ setInputToucheType(toucheType): void

设置需要的Touche输入类型,默认值是 MxType.InputToucheType.kGetBegan

Parameters ​

NameTypeDescription
toucheTypenumbertoucheType类型

Returns ​

void

Example

ts
//以 MxCADUiPrPoint 类示例
  import { MxCADUiPrPoint, MxCpp } from "mxcad";
  import { MxType } from "mxdraw";

   // 手机触模屏画直线
   async function Mx_Test_Touch_DrawLine() {
       const getPoint = new MxCADUiPrPoint();
       getPoint.setOffsetInputPostion(true);
       getPoint.setMessage("\n指定第一点:");
       // 接收 kGetBegan,触摸屏手指按下.
       getPoint.setInputToucheType(MxType.InputToucheType.kGetEnd);
       let pt1 = await getPoint.go();
       if (!pt1) return;
       getPoint.setMessage("\n指定第二点:");
       getPoint.setBasePt(pt1);

       console.log(getPoint.getResultPointOsnapMode());
       console.log(getPoint.getResultPointType());

       // 接收kGetEnd,触摸屏手指放开.
       getPoint.setInputToucheType(MxType.InputToucheType.kGetEnd);
       let pt2 = await getPoint.go();
       if (!pt2) return;
       let mxcad = MxCpp.getCurrentMxCAD();
       let ent = mxcad.drawLine(pt1.x, pt1.y, pt2.x, pt2.y).getMcDbEntity();
       if (ent) {
           ent.lineweight = 20;
       }
   }

setKeyWords ​

▸ setKeyWords(keyWordList): void

设置关键字列表

Parameters ​

NameTypeDescription
keyWordListstring关键词列表

Returns ​

void

void

Example

ts
  //以 MxCADUiPrPoint 类示例, 其他MxCADUiPr* 系列的类同理
  import { MxCADUiPrPoint } from 'mxcad'
  const getPoint = new MxCADUiPrPoint();
  getPoint.setKeyWords("[选项1(A)/选项2(B)]")

setLastInputPoint ​

▸ setLastInputPoint(pt): void

设置上一次的输入点。

Parameters ​

NameTypeDescription
ptundefined | McGePoint3d点对象

Returns ​

void

setMessage ​

▸ setMessage(message): void

设置提示字符串

Parameters ​

NameTypeDescription
messagestring提示消息

Returns ​

void

提示消息

setOffsetInputPostion ​

▸ setOffsetInputPostion(isOffset): void

设置输入点遍移，常用于移动端取点

Parameters ​

NameType
isOffsetboolean

Returns ​

void

Example

ts
import { MxCADUiPrPoint } from "mxcad";
import { MxFun } from "mxdraw";

// 移动端 绘制临时标注圆
async function test(){
   const getPoint = new MxCADUiPrPoint();
   getPoint.setMessage("\n指定一点:");
   getPoint.setOffsetInputPostion(true);
   getPoint.clearLastInputPoint();
   let pt1 = (await getPoint.go());
   if (!pt1) return;

   let mxdraw = MxFun.getCurrentDraw();

   mxdraw.getTempMarkDraw().drawCircleMark(pt1.toVector3(), mxdraw.viewCoordLong2Cad(50), 0xFF0000);
   mxdraw.updateDisplay();
}

setOsModeExParam ​

▸ setOsModeExParam(lVal): void

设置捕捉时的扩展捕捉参数。

Parameters ​

NameTypeDescription
lValOsModeExParam扩展对象捕捉参数

Returns ​

void

Example

ts
import { MxCADUiPrPoint } from "mxcad";
import { OsModeExParam } from "mxdraw";

    async function Mx_Test_Rect2() {
        const getPoint = new MxCADUiPrPoint();
        getPoint.clearLastInputPoint();
        getPoint.setMessage("请选择第一个点");
        const pt1 = await getPoint.go();
        if (!pt1) return;

        const getNextPt = new MxCADUiPrPoint();
        getNextPt.setMessage("请选择第二个角点");
        getNextPt.setOsModeExParam(OsModeExParam.kCircleTangentOsmode);
        getNextPt.setUserDraw((pt2, pWorldDraw) => {
            let pl = new McDbPolyline();
            pl.addVertexAt(pt1);
            pl.addVertexAt(new McGePoint3d(pt1.x, pt2.y, pt1.z));
            pl.addVertexAt(pt2);
            pl.addVertexAt(new McGePoint3d(pt2.x, pt1.y, pt1.z));
            pl.isClosed = true;
            pWorldDraw.drawMcDbEntity(pl);
        });

        if (!await getNextPt.go()) return;

        getNextPt.drawReserve();
    }

setUserDraw ​

▸ setUserDraw(pDraw): void

设置交互过程的动态绘制调用对象

Parameters ​

NameTypeDescription
pDraw(currentPoint: McGePoint3d, pWorldDraw: McEdGetPointWorldDrawObject) => voidMcEdGetPointWorldDrawObject | 动态绘制调用对象

Returns ​

void

void

Example

ts
//以 MxCADUiPrPoint 类示例
  import { MxCADUiPrPoint } from 'mxcad';

  async function test(){
   const getPoint = new MxCADUiPrPoint();
   getPoint.setUserDraw((pt,pw)=>{
       pw.setColor(0xff00ff);
       pw.drawCircle(new HTREE.Vector3(pt.x,pt.y,pt.z), 10)
   })
   const pt = await getPoint.go();
   console.log("point", pt)
  }

setUserInputControls ​

▸ setUserInputControls(contros): void

设置输入控制设置

Parameters ​

NameType
controsnumber

Returns ​

void

Example

ts
// 以 MxCADUiPrInt 类示例
  import { MxCADUiPrInt } from 'mxcad';
  import { UserInputControls } from "mxdraw"

  let getInt = new MxCADUiPrInt();
  getInt.setMessage("输入整数:");
  getInt.setUserInputControls(UserInputControls.kNoZeroResponseAccepted);
  let iRowNum = await getInt.go();
  if (iRowNum == null) return;

userInputControls ​

▸ userInputControls(): number

返回输入控制设置

Returns ​

number

Copyright @ 2023 成都梦想凯德科技有限公司 Rights Reserved