递归火山软件开发平台

标题: 能不能在命令注释处注释与易语言的区别和使用方法 [打印本页]

作者: 朕的 时间: 2023-2-26 19:58
标题: 能不能在命令注释处注释与易语言的区别和使用方法
本帖最后由朕的于 2023-2-26 20:09 编辑

比如一个标签，用代码动态设置底图，在易语言里读入字节集赋值一下搞定，
在火山里要搞什么位图资源，根本不知道怎么用，也没有任何提示。

用了十几年易语言了，火山也玩了几年，火山很基本的地方还是很难入手。

难道位图资源必须固定开发时就设置？不能变？那岂不是不能动态更改？

开发的时候就应该想想这些用户怎么入手，你开发的时候你知道，被人知道个毛，这个简单个命令都要去查资料？也没找到怎么使用

作者: 创世魂 时间: 2023-2-26 20:09
本帖最后由创世魂于 2023-2-26 20:11 编辑

位图资源就是易语言里面的资源表只是在火山里面可以自由定义位置。
1、多写代码。
2、多看类的帮助页。
3、多看案例。

作者: 朕的 时间: 2023-2-26 20:10

创世魂发表于 2023-2-26 20:09
位图资源就是易语言里面的资源只是在火山里面可以自由定义位置。

那岂不是给固定了，怎么动态设置？比如我编译后选择一个图片怎么让图片赋值？

作者: 创世魂 时间: 2023-2-26 20:12

朕的发表于 2023-2-26 20:10
那岂不是给固定了，怎么动态设置？比如我编译后选择一个图片怎么让图片赋值？ ...

所以要多看帮助页。。也不让你背诵，瞄一眼就看到有哪些方法了。

然后就能看到其它设置的方法

置底图数据
置底图文件
等等。。

作者: 朕的 时间: 2023-2-26 20:13

创世魂发表于 2023-2-26 20:09
位图资源就是易语言里面的资源表只是在火山里面可以自由定义位置。
1、多写代码。
2、多看类的帮助页。 ...

看个鸡8M，这么常用的基本功能都搞得这么复杂，为啥在命令注释里不直接注释了，咋使用的也找不到答案

作者: 朕的 时间: 2023-2-26 20:19

创世魂发表于 2023-2-26 20:12
所以要多看帮助页。。也不让你背诵，瞄一眼就看到有哪些方法了。

然后就能看到其它设置的方法

像常规不同于易语言的写法，应该有特别注释。这种情况第一肯定是直接想着赋值，结果发现出来个什么鬼位图资源类，位图资源还不能动态更改。既然是这样就应该在类似之处有也别声明。比如：此命令为静态编译前预设值，若动态更改可使用：标签.置底图数据()，XX命令。要不然鬼知道有这个命令

作者: 山梦 时间: 2023-2-26 20:21
有些，帮助页与注释都是4个参数，到实际只3个。不知道是我太菜没看清楚

作者: Xelloss0618 时间: 2023-2-26 20:42
类的方便之处，就是你从类跳过去看代码或帮助，里面有些什么方法一目了然。
学习使用一个类之前，最好看一下它有什么方法。
而且火山是火山，为什么要在里面写跟易语言有什么不同？又不是谁都用过易语言。

作者: Xelloss0618 时间: 2023-2-26 20:44

山梦发表于 2023-2-26 20:21
有些，帮助页与注释都是4个参数，到实际只3个。不知道是我太菜没看清楚

主要看第一个参数的类型。
如果第一个参数的类型就是本类，那通过类变量调用这个方法的时候，要省略第一个参数。
字节集类的用法就是如此。

作者: Inverse 时间: 2023-2-26 20:55
反对

作者: 飞扬工作室 时间: 2023-2-26 20:58

朕的发表于 2023-2-26 20:13
看个鸡8M，这么常用的基本功能都搞得这么复杂，为啥在命令注释里不直接注释了，咋使用的也找不到答案 ...

骂人警告一次,再犯禁言.

作者: 朕的 时间: 2023-2-26 21:20

Xelloss0618 发表于 2023-2-26 20:42
类的方便之处，就是你从类跳过去看代码或帮助，里面有些什么方法一目了然。
学习使用一个类之前，最好看一 ...

画个标签弄个底图也要看帮助，我也是醉了

作者: 龙纹 时间: 2023-2-26 21:54

飞扬工作室发表于 2023-2-26 20:58
骂人警告一次,再犯禁言.

我虽然有些编程经验，但不得不承认的是有时我也会犯马虎。对于一个从没接触过的类库，即使碰到基础问题也难以立刻解决，此时对于他的吐槽我是感同身受的。
我觉得问题在于怎么让一个不熟悉命令的人知道他是怎样正确使用的，即上下文，现在的方式是选择方法时只有方法名，那么可供参考的信息只有也仅有方法名，这样十分考验方法的命名，很多时候是不能见名知意的。
比如下面这个命令
(, 下载次数: 15)
如果我马虎了，这样运行，但为什么没效果呢？查找问题时我就会去看注释，可惜的是我马虎的时候不会只犯一次错，我“忽略”了关键信息。
(, 下载次数: 15)
关键信息肯定是等待执行这几个字，但我并没有联想到其中的含义(事实上我认为这个注释不合格)，等到我认真去查看整个Redis数据库类的时候才发现这个命令下有个命令叫"取连续执行结果"，至此，问题解决，这是我个人使用火山时遇到的真实实例。
用户使用陌生命令时期望也需要第一时间能看到有用的信息，我认为可以在选择方法时提供更多的帮助信息，大概是下面这样：
(, 下载次数: 16)
红框中是我设想的"命令帮助窗口"，在选择方法时就尽可能地提供更多的信息，这对熟悉的命令，如分割文本自然是不需要的，但如果是第一次使用分割文本的用户，其实他期望的是分割子文本的效果，那么他在选择命令时就可以通过"命令帮助窗口"知道这不是自己期望的命令。

作者: 飞扬工作室 时间: 2023-2-26 22:12

龙纹发表于 2023-2-26 21:54
我虽然有些编程经验，但不得不承认的是有时我也会犯马虎。对于一个从没接触过的类库，即使碰到基础问题也 ...

是的,类库命名和注释确实需要加强.

作者: 创世魂 时间: 2023-2-26 22:21

山梦发表于 2023-2-26 20:21
有些，帮助页与注释都是4个参数，到实际只3个。不知道是我太菜没看清楚

https://doc.voldp.com/vol/lib.html#动态调用

所以看教程。看了就理解了。只是一种语法而已。。多数语法都可以通过帮助页识别调用。学会看帮助页，火山能掌握百分之五十。剩下就是多练了。

作者: 创世魂 时间: 2023-2-26 22:26

Xelloss0618 发表于 2023-2-26 20:42
类的方便之处，就是你从类跳过去看代码或帮助，里面有些什么方法一目了然。
学习使用一个类之前，最好看一 ...

确实啊，一个新的东西肯定是要有学习成本的。。
如果这点耐心都没有，那就趁早放弃吧。

虽然有句话说的好，学会c语言，其它语言无师自通。但是这就是在扯犊子。
c语言的很多语法在其它语言上都不支持，转换学其它语言的时候都得学基本语法命令相关知识，才能换过去。

作者: 龙纹 时间: 2023-2-26 22:36

飞扬工作室发表于 2023-2-26 22:12
是的,类库命名和注释确实需要加强.

增强IDE也可以帮助"新手"尽快掌握命令，可以考虑选择命令时提供相关的信息，这样用户只要输入 "类实例." 就可以浏览当前类的各个方法了。比如选择命令时就提示如下信息，这样更人性化一点，不必在.v文件中跳来跳去就可以看到信息。
(, 下载次数: 18)

作者: 龙纹 时间: 2023-2-26 22:41

创世魂发表于 2023-2-26 22:26
确实啊，一个新的东西肯定是要有学习成本的。。
如果这点耐心都没有，那就趁早放弃吧。

反对你这个说法，学习一个东西有成本这件事是所有人都知道的事实，但我们正在讨论的不就是能不能、如何降低学习成本吗？不管三七二十一，只是告诉别人要适应，难道他发这个帖不值得你反思火山是否存在问题，有没有能改进的地方吗？

作者: 福寿 时间: 2023-2-27 03:22
火山是火山，易语言是易语言，本来就是两种不同的语言，既然觉得易语言有多方便，直接用易语言不就行了，又不是用了火山就限制使用易语言了

作者: 朕的 时间: 2023-2-27 03:58

福寿发表于 2023-2-27 03:22
火山是火山，易语言是易语言，本来就是两种不同的语言，既然觉得易语言有多方便，直接用易语言不就行了，又 ...

用火山的有几个不是易语言来的。既然是易语言衍变来的，却别之处有提示是合情合理。

作者: 朕的 时间: 2023-2-27 04:07

创世魂发表于 2023-2-26 22:26
确实啊，一个新的东西肯定是要有学习成本的。。
如果这点耐心都没有，那就趁早放弃吧。

跟易语言相同的命令完全不同的使用方法，饶了这么多弯，难道火山不应该有相关提示？用火山的用户哪个不是易语言用户

作者: 朕的 时间: 2023-2-27 04:12

飞扬工作室发表于 2023-2-26 22:12
是的,类库命名和注释确实需要加强.

像那个命令组件更换底图图片，估计有绝大多数人都碰到过，就研究位图资源和解决怎么用，估计没有10分钟都搞不懂。明明注释一句话可以搞定的事情，说明不同之处可以用什么方法

欢迎光临递归火山软件开发平台 (https://bbs.voldp.com/)