| 1 | n/a | |
|---|
| 2 | n/a | /* ========================== Module _Help ========================== */ |
|---|
| 3 | n/a | |
|---|
| 4 | n/a | #include "Python.h" |
|---|
| 5 | n/a | |
|---|
| 6 | n/a | #ifndef __LP64__ |
|---|
| 7 | n/a | |
|---|
| 8 | n/a | |
|---|
| 9 | n/a | #include "pymactoolbox.h" |
|---|
| 10 | n/a | |
|---|
| 11 | n/a | /* Macro to test whether a weak-loaded CFM function exists */ |
|---|
| 12 | n/a | #define PyMac_PRECHECK(rtn) do { if ( &rtn == NULL ) {\ |
|---|
| 13 | n/a | PyErr_SetString(PyExc_NotImplementedError, \ |
|---|
| 14 | n/a | "Not available in this shared library/OS version"); \ |
|---|
| 15 | n/a | return NULL; \ |
|---|
| 16 | n/a | }} while(0) |
|---|
| 17 | n/a | |
|---|
| 18 | n/a | |
|---|
| 19 | n/a | #include <Carbon/Carbon.h> |
|---|
| 20 | n/a | |
|---|
| 21 | n/a | static PyObject *Help_Error; |
|---|
| 22 | n/a | |
|---|
| 23 | n/a | static PyObject *Help_HMGetHelpMenu(PyObject *_self, PyObject *_args) |
|---|
| 24 | n/a | { |
|---|
| 25 | n/a | PyObject *_res = NULL; |
|---|
| 26 | n/a | OSStatus _err; |
|---|
| 27 | n/a | MenuRef outHelpMenu; |
|---|
| 28 | n/a | MenuItemIndex outFirstCustomItemIndex; |
|---|
| 29 | n/a | if (!PyArg_ParseTuple(_args, "")) |
|---|
| 30 | n/a | return NULL; |
|---|
| 31 | n/a | _err = HMGetHelpMenu(&outHelpMenu, |
|---|
| 32 | n/a | &outFirstCustomItemIndex); |
|---|
| 33 | n/a | if (_err != noErr) return PyMac_Error(_err); |
|---|
| 34 | n/a | _res = Py_BuildValue("O&H", |
|---|
| 35 | n/a | MenuObj_New, outHelpMenu, |
|---|
| 36 | n/a | outFirstCustomItemIndex); |
|---|
| 37 | n/a | return _res; |
|---|
| 38 | n/a | } |
|---|
| 39 | n/a | |
|---|
| 40 | n/a | static PyObject *Help_HMAreHelpTagsDisplayed(PyObject *_self, PyObject *_args) |
|---|
| 41 | n/a | { |
|---|
| 42 | n/a | PyObject *_res = NULL; |
|---|
| 43 | n/a | Boolean _rv; |
|---|
| 44 | n/a | if (!PyArg_ParseTuple(_args, "")) |
|---|
| 45 | n/a | return NULL; |
|---|
| 46 | n/a | _rv = HMAreHelpTagsDisplayed(); |
|---|
| 47 | n/a | _res = Py_BuildValue("b", |
|---|
| 48 | n/a | _rv); |
|---|
| 49 | n/a | return _res; |
|---|
| 50 | n/a | } |
|---|
| 51 | n/a | |
|---|
| 52 | n/a | static PyObject *Help_HMSetHelpTagsDisplayed(PyObject *_self, PyObject *_args) |
|---|
| 53 | n/a | { |
|---|
| 54 | n/a | PyObject *_res = NULL; |
|---|
| 55 | n/a | OSStatus _err; |
|---|
| 56 | n/a | Boolean inDisplayTags; |
|---|
| 57 | n/a | if (!PyArg_ParseTuple(_args, "b", |
|---|
| 58 | n/a | &inDisplayTags)) |
|---|
| 59 | n/a | return NULL; |
|---|
| 60 | n/a | _err = HMSetHelpTagsDisplayed(inDisplayTags); |
|---|
| 61 | n/a | if (_err != noErr) return PyMac_Error(_err); |
|---|
| 62 | n/a | Py_INCREF(Py_None); |
|---|
| 63 | n/a | _res = Py_None; |
|---|
| 64 | n/a | return _res; |
|---|
| 65 | n/a | } |
|---|
| 66 | n/a | |
|---|
| 67 | n/a | static PyObject *Help_HMSetTagDelay(PyObject *_self, PyObject *_args) |
|---|
| 68 | n/a | { |
|---|
| 69 | n/a | PyObject *_res = NULL; |
|---|
| 70 | n/a | OSStatus _err; |
|---|
| 71 | n/a | Duration inDelay; |
|---|
| 72 | n/a | if (!PyArg_ParseTuple(_args, "l", |
|---|
| 73 | n/a | &inDelay)) |
|---|
| 74 | n/a | return NULL; |
|---|
| 75 | n/a | _err = HMSetTagDelay(inDelay); |
|---|
| 76 | n/a | if (_err != noErr) return PyMac_Error(_err); |
|---|
| 77 | n/a | Py_INCREF(Py_None); |
|---|
| 78 | n/a | _res = Py_None; |
|---|
| 79 | n/a | return _res; |
|---|
| 80 | n/a | } |
|---|
| 81 | n/a | |
|---|
| 82 | n/a | static PyObject *Help_HMGetTagDelay(PyObject *_self, PyObject *_args) |
|---|
| 83 | n/a | { |
|---|
| 84 | n/a | PyObject *_res = NULL; |
|---|
| 85 | n/a | OSStatus _err; |
|---|
| 86 | n/a | Duration outDelay; |
|---|
| 87 | n/a | if (!PyArg_ParseTuple(_args, "")) |
|---|
| 88 | n/a | return NULL; |
|---|
| 89 | n/a | _err = HMGetTagDelay(&outDelay); |
|---|
| 90 | n/a | if (_err != noErr) return PyMac_Error(_err); |
|---|
| 91 | n/a | _res = Py_BuildValue("l", |
|---|
| 92 | n/a | outDelay); |
|---|
| 93 | n/a | return _res; |
|---|
| 94 | n/a | } |
|---|
| 95 | n/a | |
|---|
| 96 | n/a | static PyObject *Help_HMSetMenuHelpFromBalloonRsrc(PyObject *_self, PyObject *_args) |
|---|
| 97 | n/a | { |
|---|
| 98 | n/a | PyObject *_res = NULL; |
|---|
| 99 | n/a | OSStatus _err; |
|---|
| 100 | n/a | MenuRef inMenu; |
|---|
| 101 | n/a | SInt16 inHmnuRsrcID; |
|---|
| 102 | n/a | if (!PyArg_ParseTuple(_args, "O&h", |
|---|
| 103 | n/a | MenuObj_Convert, &inMenu, |
|---|
| 104 | n/a | &inHmnuRsrcID)) |
|---|
| 105 | n/a | return NULL; |
|---|
| 106 | n/a | _err = HMSetMenuHelpFromBalloonRsrc(inMenu, |
|---|
| 107 | n/a | inHmnuRsrcID); |
|---|
| 108 | n/a | if (_err != noErr) return PyMac_Error(_err); |
|---|
| 109 | n/a | Py_INCREF(Py_None); |
|---|
| 110 | n/a | _res = Py_None; |
|---|
| 111 | n/a | return _res; |
|---|
| 112 | n/a | } |
|---|
| 113 | n/a | |
|---|
| 114 | n/a | static PyObject *Help_HMSetDialogHelpFromBalloonRsrc(PyObject *_self, PyObject *_args) |
|---|
| 115 | n/a | { |
|---|
| 116 | n/a | PyObject *_res = NULL; |
|---|
| 117 | n/a | OSStatus _err; |
|---|
| 118 | n/a | DialogPtr inDialog; |
|---|
| 119 | n/a | SInt16 inHdlgRsrcID; |
|---|
| 120 | n/a | SInt16 inItemStart; |
|---|
| 121 | n/a | if (!PyArg_ParseTuple(_args, "O&hh", |
|---|
| 122 | n/a | DlgObj_Convert, &inDialog, |
|---|
| 123 | n/a | &inHdlgRsrcID, |
|---|
| 124 | n/a | &inItemStart)) |
|---|
| 125 | n/a | return NULL; |
|---|
| 126 | n/a | _err = HMSetDialogHelpFromBalloonRsrc(inDialog, |
|---|
| 127 | n/a | inHdlgRsrcID, |
|---|
| 128 | n/a | inItemStart); |
|---|
| 129 | n/a | if (_err != noErr) return PyMac_Error(_err); |
|---|
| 130 | n/a | Py_INCREF(Py_None); |
|---|
| 131 | n/a | _res = Py_None; |
|---|
| 132 | n/a | return _res; |
|---|
| 133 | n/a | } |
|---|
| 134 | n/a | |
|---|
| 135 | n/a | static PyObject *Help_HMHideTag(PyObject *_self, PyObject *_args) |
|---|
| 136 | n/a | { |
|---|
| 137 | n/a | PyObject *_res = NULL; |
|---|
| 138 | n/a | OSStatus _err; |
|---|
| 139 | n/a | if (!PyArg_ParseTuple(_args, "")) |
|---|
| 140 | n/a | return NULL; |
|---|
| 141 | n/a | _err = HMHideTag(); |
|---|
| 142 | n/a | if (_err != noErr) return PyMac_Error(_err); |
|---|
| 143 | n/a | Py_INCREF(Py_None); |
|---|
| 144 | n/a | _res = Py_None; |
|---|
| 145 | n/a | return _res; |
|---|
| 146 | n/a | } |
|---|
| 147 | n/a | |
|---|
| 148 | n/a | #endif /* __LP64__ */ |
|---|
| 149 | n/a | |
|---|
| 150 | n/a | static PyMethodDef Help_methods[] = { |
|---|
| 151 | n/a | #ifndef __LP64__ |
|---|
| 152 | n/a | {"HMGetHelpMenu", (PyCFunction)Help_HMGetHelpMenu, 1, |
|---|
| 153 | n/a | PyDoc_STR("() -> (MenuRef outHelpMenu, MenuItemIndex outFirstCustomItemIndex)")}, |
|---|
| 154 | n/a | {"HMAreHelpTagsDisplayed", (PyCFunction)Help_HMAreHelpTagsDisplayed, 1, |
|---|
| 155 | n/a | PyDoc_STR("() -> (Boolean _rv)")}, |
|---|
| 156 | n/a | {"HMSetHelpTagsDisplayed", (PyCFunction)Help_HMSetHelpTagsDisplayed, 1, |
|---|
| 157 | n/a | PyDoc_STR("(Boolean inDisplayTags) -> None")}, |
|---|
| 158 | n/a | {"HMSetTagDelay", (PyCFunction)Help_HMSetTagDelay, 1, |
|---|
| 159 | n/a | PyDoc_STR("(Duration inDelay) -> None")}, |
|---|
| 160 | n/a | {"HMGetTagDelay", (PyCFunction)Help_HMGetTagDelay, 1, |
|---|
| 161 | n/a | PyDoc_STR("() -> (Duration outDelay)")}, |
|---|
| 162 | n/a | {"HMSetMenuHelpFromBalloonRsrc", (PyCFunction)Help_HMSetMenuHelpFromBalloonRsrc, 1, |
|---|
| 163 | n/a | PyDoc_STR("(MenuRef inMenu, SInt16 inHmnuRsrcID) -> None")}, |
|---|
| 164 | n/a | {"HMSetDialogHelpFromBalloonRsrc", (PyCFunction)Help_HMSetDialogHelpFromBalloonRsrc, 1, |
|---|
| 165 | n/a | PyDoc_STR("(DialogPtr inDialog, SInt16 inHdlgRsrcID, SInt16 inItemStart) -> None")}, |
|---|
| 166 | n/a | {"HMHideTag", (PyCFunction)Help_HMHideTag, 1, |
|---|
| 167 | n/a | PyDoc_STR("() -> None")}, |
|---|
| 168 | n/a | #endif /* __LP64__ */ |
|---|
| 169 | n/a | {NULL, NULL, 0} |
|---|
| 170 | n/a | }; |
|---|
| 171 | n/a | |
|---|
| 172 | n/a | |
|---|
| 173 | n/a | |
|---|
| 174 | n/a | |
|---|
| 175 | n/a | void init_Help(void) |
|---|
| 176 | n/a | { |
|---|
| 177 | n/a | PyObject *m; |
|---|
| 178 | n/a | #ifndef __LP64__ |
|---|
| 179 | n/a | PyObject *d; |
|---|
| 180 | n/a | #endif /* __LP64__ */ |
|---|
| 181 | n/a | |
|---|
| 182 | n/a | |
|---|
| 183 | n/a | |
|---|
| 184 | n/a | |
|---|
| 185 | n/a | m = Py_InitModule("_Help", Help_methods); |
|---|
| 186 | n/a | #ifndef __LP64__ |
|---|
| 187 | n/a | d = PyModule_GetDict(m); |
|---|
| 188 | n/a | Help_Error = PyMac_GetOSErrException(); |
|---|
| 189 | n/a | if (Help_Error == NULL || |
|---|
| 190 | n/a | PyDict_SetItemString(d, "Error", Help_Error) != 0) |
|---|
| 191 | n/a | return; |
|---|
| 192 | n/a | #endif /* __LP64__ */ |
|---|
| 193 | n/a | } |
|---|
| 194 | n/a | |
|---|
| 195 | n/a | /* ======================== End module _Help ======================== */ |
|---|
| 196 | n/a | |
|---|