37.1. ic-访问 Mac OS X Internet 配置

该模块提供对pass System PreferencesFinder 设置的各种与 Internet 相关的偏好的访问。

Note

该模块已在 Python 3.x 中删除。

有一个低级配套模块icglue,它提供基本的 Internet Config 访问Function。该低级模块未记录,但是例程的文档字符串记录了参数,并且例程名称与用于 Internet 配置的 Pascal 或 C API 相同,因此如果此模块为标准模块,则可以使用标准 IC 程序员的文档。需要。

ic模块为 Internet Config 可以产生的所有错误代码定义error异常和符号名;有关详细信息,请参见源。

  • exception ic. error
    • ic模块中的错误引发异常。

ic模块定义以下类和函数:

    • class * ic. IC([* signature * [,* ic *]])
    • 创建一个 Internet 配置对象。签名是当前应用程序的 4 个字符的创建者代码(默认为'Pyth'),这可能会影响某些 IC 设置。可选的* ic *参数是预先创建的低级icglue.icinstance,如果要从其他配置文件等中获取首选项,这可能很有用。
  • ic. launchurl(* url * [,提示])

  • ic. parseurl(* data * [,* start * [,* end * [,* hint *]]])

  • ic. mapfile(* file *)

  • ic. maptypecreator(* type creator * [,* filename *])

  • ic. settypecreator(* file *)

    • 这些Function是同名方法的“快捷方式”,如下所述。

37.1.1. IC 对象

IC对象具有 Map 接口,因此要获取邮件地址,您只需获取ic['MailAddress']即可。分配也有效,并更改配置文件中的选项。

该模块了解各种数据类型,并将内部 IC 表示形式转换为“逻辑” Python 数据结构。独立运行ic模块将运行一个测试程序,该程序列出您的 IC 数据库中的所有键和值,这将作为文档。

如果模块不知道如何表示数据,它将返回ICOpaqueData类型的实例,并将原始数据保存在data属性中。此类型的对象也是分配的可接受值。

除了字典界面之外,IC对象还具有以下方法:

  • IC. launchurl(* url * [,提示])

    • 解析给定的 URL,启动正确的应用程序并将其传递给 URL。可选的* hint 可以是方案名称,例如'mailto:',在这种情况下,使用此方案完成不完整的 URL。如果未提供提示*,则不完整的 URL 无效。
  • IC. parseurl(* data * [,* start * [,* end * [,* hint *]]])

    • 在* data 中的某个地方找到一个 URL,然后返回开始位置,结束位置和 URL。可选的 start end 可用于限制搜索,例如,如果用户单击一个长文本字段,则可以传递整个文本字段和 start 中的 click-position,此例程将返回用户单击的整个 URL。如上所述, hint *是用于完成不完整 URL 的可选方案。
  • IC. mapfile(* file *)

    • 返回给定* file *的 Map 项,可以将其作为文件名或FSSpec()结果传递,并且不需要存在。

Map 条目以 Tuples(version, type, creator, postcreator, flags, extension, appname, postappname, mimetype, entryname)的形式返回,其中* version 是条目的版本号, type 是 4 个字符的文件类型, creator 是 4 个字符的创建者类型, postcreator 是 4 个字符的创建者下载后对文件进行后处理的可选应用程序的代码, flags 是用于指定是以二进制还是 ascii 进行传输的各种位, extension 是此文件类型的文件名 extensions, appname 是可打印的名称此文件所属应用程序的名称, postappname 是后处理应用程序的名称, mimetype 是此文件的 MIME 类型, entryname *是此条目的名称。

  • IC. maptypecreator(* type creator * [,* filename *])
    • 返回具有给定 4 个字符* type creator 代码的文件的 Map 条目。可以指定可选的 filename *以进一步帮助找到正确的条目(例如,如果创建者代码为'????')。

Map 条目以与* mapfile *相同的格式返回。

  • IC. settypecreator(* file *)
    • 给定一个现有的* file *,将其指定为文件名或FSSpec()结果,请设置其创建者并根据其 extensions 正确键入。取景器被告知有关更改,因此取景器图标将快速更新。