跳转到内容

X 窗口编程/XLib/库约定

来自维基教科书,开放的书籍,开放的世界

库约定

[编辑 | 编辑源代码]

Xlib 遵循一些约定,使其更易于使用和记忆。

主要的约定是

  • 为了区分 X 符号与其他符号,库对外部符号名使用混合大小写。它对变量使用小写字母,对用户宏使用全大写字母,遵循现有约定。
  • 所有 Xlib 函数、用户可见的数据结构以及用户可能取消引用的任何内容都以大写字母 X 开头。
  • 宏和其他符号不以大写字母 X 开头。为了将它们与所有用户符号区分开来,宏中的每个单词都大写。
  • 所有函数名和符号的开头都大写。
  • 数据结构的所有元素都使用小写字母。需要时,复合词使用下划线 (_) 构造。
  • 显示参数,如果使用,始终位于参数列表中的第一位。
  • 所有资源对象,如果使用,都出现在参数列表的开头,紧接在显示参数之后。
  • 当图形上下文与其他类型的资源(最常见的是可绘制对象)一起出现时,图形上下文出现在参数列表中的其他资源之后。可绘制对象优先于所有其他资源。
  • 源参数始终位于参数列表中的目标参数之前。
  • x 参数始终位于参数列表中的 y 参数之前,宽度参数始终位于参数列表中的高度参数之前。
  • 当 x、y、宽度和高度参数一起使用时,x 和 y 参数始终位于宽度和高度参数之前。
  • 当掩码与结构一起使用时,掩码始终位于参数列表中指向结构的指针之前。
华夏公益教科书