pyobjc-docs / pyobjc-framework-Cocoa / Doc / api-notes-AppKit.txt

==================================
API Notes for the AppKit framework
==================================

``NSColorSpace``
----------------

* ``-initWithColorSyncProfile:`` and ``colorSyncProfile``

  These methods are not supported.

``NSEvent``
-----------

* ``-initWithEventRef:`` and ``-eventRef``

  These methods are not supported

``NSGradient``
--------------

* ``-initWithColorsAndLocations:``

  This method is not supported, use ``-initWithColors:atLocations:colorSpace:`` instead.


``NSDrawBitmap``
----------------

This function is deprecated and is not supported by PyObjC. Use an ``NSBitmapImageRep`` instead.

``NSImage``
-----------

* ``initWithIconRef:``

  This method is not yet supported.

``NSMovie``
-----------

NOTE: This class is deprecated by Apple, use ``QTMovie`` instead.

* ``-QTMovie``, ``-initWithMovie:``

  These methods are not supported.

``NSMovieView``
---------------

* ``-movieController``

  This method is not supported.

``NSPrintInfo``
---------------

* ``-PMPrintSession``, ``-PMPageFormat``, ``-PMPrintSettings``

  These methods are not yet supported.

``NSQuickDrawView``
-------------------

* ``-qdPort``

  This method is not supported.

``NSGlyphInfoAtIndex``
----------------------

This function is not supported.

``NSTypesetterGlyphInfo``
-------------------------

This structure is not supported, and therefore the method ``-baseOfTypesetterGlyphInfo`` and 
``-typesetterLaidOneGlyph`` of ``NSSimpleHorizontalTypesetter`` are not supported as well.

``NSWindow``
------------

Methods ``-initWithWindowRef:`` and ``-windowRef`` are not supported.

``NSInputStream``
------------------

* ``getBuffer:length:``

   This method is not supported

``NSBitmapImageRep``
--------------------

* ``-initWithBitmapDataPlanes:pixelsWide:pixelsHigh:bitsPerSample:samplesPerPixel:hasAlpha:isPlanar:colorSpaceName:bitmapFormat:bytesPerRow:bitsPerPixel:``

  This method is not yet supported. Support for this method requires a manual wrapper, which 
  has not been written yet.

``NSDictionaryOfVariableBindings``
----------------------------------

This is a helper macro that cannot be implemented with the same interface in Python.

Instead of::

    NSDictionaryOfVariableBindings(button1, button2, nil)

use::

    { "button1": button1, "button2": button2 }

or::

    AppKit.NSDictionaryOfVariableBindings("button1", "button2")

The first alternative is preferable because it is cleaner Python code, and
the implementation of ``NSDictionaryOfVariableBindings`` has to use an
unstable API of CPython.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.