在线文档教程

ic

ic - 访问Mac OS X Internet配置

此模块提供对通过系统偏好设置Finder设置的各种与互联网有关的偏好的访问。

注意

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

有一个低级协同模块icglue提供基本的Internet配置访问功能。这个低级模块没有记录,但是例程的文档字符串记录了参数和例程名称与Pascal或C API到Internet配置的相同,所以如果此模块是标准IC程序员的文档需要。

ic模块为Internet Config可以生成的所有错误代码定义错误例外和符号名称; 详情请参阅源文件。

exception ic.error

ic模块中的错误引发异常。

ic模块定义了以下类和功能:

class ic.IC([signature[, ic]])

创建一个Internet配置对象。签名是当前应用程序的4个字符的创建者代码(默认'Pyth'),可能会影响一些IC设置。可选ic参数是icglue.icinstance预先创建的低级别参数,如果您想从其他配置文件获取首选项,这可能会很有用。

ic.launchurl(url[, hint])ic.parseurl(data[, start[, end[, hint]]])ic.mapfile(file)ic.maptypecreator(type, creator[, filename])ic.settypecreator(file)

这些函数是下面描述的同名方法的“捷径”。

1. IC对象

IC对象有一个映射接口,因此可以获得你简单得到的邮件地址ic['MailAddress']。分配也可以工作,并更改配置文件中的选项。

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

如果模块不知道如何表示数据,则返回该ICOpaqueData类型的一个实例,并在其data属性中包含原始数据。这种类型的对象也是可以接受的赋值。

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

IC.launchurl(url[, hint])

解析给定的URL,启动正确的应用程序并将URL传递给它。可选的提示可以是一个方案名称,例如'mailto:',在这种情况下,不完整的URL将通过此方案完成。如果未提供提示,则不完整的URL无效。

IC.parseurl(data[, start[, end[, hint]]])

数据的 某处查找网址,并返回起始位置,结束位置和网址。可选的开始结束可用于限制搜索,例如,如果用户在长文本字段中单击,则可以在开始时传递整个文本字段和单击位置,并且此例程将返回整个URL,其中用户点击。如上所述,提示是用于完成不完整URL的可选方案。

IC.mapfile(file)

返回给定文件的映射条目,该条目可以作为文件名或FSSpec()结果传递,也可以不存在。

映射条目作为元组(version, type, creator, postcreator, flags, extension, appname, postappname, mimetype, entryname)返回,其中version是条目版本号,type是4个字符的文件类型,creator是4 - 字符创建者类型,postcreator是可选应用程序的4个字符的创建者代码,用于在下载后对文件进行后处理,标志是用于指定是以二进制还是ASCII格式传输的各种位,扩展名是此文件类型的文件扩展名 ,appname是此文件所属应用程序的可打印名称,postappname是后处理应用程序的名称,mimetype是此文件的MIME类型,entryname是此条目的名称。

IC.maptypecreator(type, creator[, filename])

返回给定4字符类型创建者代码的文件的映射条目。可以指定可选的文件名以进一步帮助找到正确的条目(例如,如果创建者代码是'????')。

映射条目以与mapfile相同的格式返回。

IC.settypecreator(file)

给定一个现有的文件,指定为文件名或FSSpec()结果,根据其扩展名设置其创建者和类型。查找器会被告知有关更改,因此查找器图标将会很快更新。