在C/C++中访问GIRL对象

本节给出所有GIRL对象（除了构件之外）的访问函数：

• 访问整数：
  • gint girl_fetch_integer(ghandle identifier);

    该函数获取给定标识符表示的整数。如果给定的标识符不存在，或者表示的不是整数，则返回0。

• 访问浮点数：
  • gfloat girl_fetch_float(ghandle identifier);

    该函数获取指定标示符表示的浮点数。如果给定的标识符不存在，或者不表示浮点数，则返回0.0。

• 访问字符串对象：
  • girlString *girl_fetch_string(ghandle identifier);

    该函数获取给定标识符表示的字符串。如果给定标识符不存在，或者表示的不是字符串， 那么返回NULL。

  • void girl_string_get(const girlString *pstring,char *pbuf,gint buflen);

    字符串对象中的字符串复制到给出缓冲区中。

  • girlString *girl_string_create(char *pbuf);

    从给定字符串创建新的字符串对象。给定字符串将被复制。

• 访问颜色对象：
  • girlColor *girl_fetch_color(ghandle identifier);

    该函数用于获取给定标识符表示的颜色对象。如果给定标识符不存在、或者标识符表示的不是 颜色对象，则返回NULL。

  • girlColor *girl_create_color(const char *color_name);

    该函数用于创建预定义共享颜色。如果颜色名无效，则返回NULL。

  • girlColor *girl_create_rgbcolor(gint r,gint g,gint b);

    该函数用于创建RGB共享颜色。r、g、b的值应该在0~65535的范围内，超出这个范围时，如果 小于0则被看作0，如果大于65535则被看作65535。

• 访问光标对象：
  • girlCursor *girl_fetch_cursor(ghandle identifier);

    该函数用于获取给出的光标标识符表示的光标。如果给定标识符不存在，或者表示的不是光标， 则返回NULL。

  • girlCursor *girl_create_sys_cursor(const char *cursor_name);

    创建给定名称的预定义光标。如果名称无效，则返回NULL。关于预定义光标名称，参见附录。

  • girlCursor *girl_create_cursor(const char * cursor_fname);

    从给定的光标文件中创建光标。如果文件名无效或者文件格式不正确，则返回NULL。关于光标 文件格式，参见附录。

• 访问字体对象：
  • girlFont *girl_fetch_font(ghandle identifier);

    该函数用于获取给定标识符表示的字体。如果指定标识符不存在，或者标识符表示的不是字体， 或者在本系统中，指定的字体不存在，则返回NULL。

  • girlFont *girl_create_font(const char *font_name);

    该函数用于创建字体。如果给定字体不存在，返回NULL。

• 访问位图对象：
  • girlPixmap *girl_fetch_pixmap(ghandle identifier);

    该函数用于获取给定标识符表示的位图。如果指定标识符不存在，或者不表示位图，则返回NULL。

  • girlPixmap *girl_create_bmp_pixmap(const char *fname);

    本函数从给定的bmp文件中创建位图对象。如果文件名无效或者文件格式不正确，则返回NULL。

  • girlPixmap *girl_create_jpeg_pixmap(const char *fname);

    本函数从给定的jpeg文件中创建位图对象。如果文件名无效或者文件格式不正确，则返回NULL。

  • girlPixmap *girl_create_png_pixmap(const char *fname);

    本函数从给定的png文件中创建位图对象。如果文件名无效或者文件格式不正确，则返回NULL。

  • girlPixmap *girl_create_ppm_pixmap(const char *fname);

    本函数从给定的ppm文件中创建位图对象。如果文件名无效或者文件格式不正确，则返回NULL。

  • girlPixmap *girl_create_ps_pixmap(const char *fname);

    本函数从给定的ps文件中创建位图对象。如果文件名无效或者文件格式不正确，则返回NULL。

  • girlPixmap *girl_create_tiff_pixmap(const char *fname);

    本函数从给定的tiff文件中创建位图对象。如果文件名无效或者文件格式不正确，则返回NULL。

  • girlPixmap *girl_create_xmp_pixmap(const char *fname);

    本函数从给定的xpm文件中创建位图对象。如果文件名无效或者文件格式不正确，则返回NULL。