GSDisplayServer fedor@gnu.org Abstract display server class. 2002 Free Software Foundation, Inc. GSDisplayServer

This is an abstract class which provides a framework for a device independant window server. A window server handles the very basic control of the computer display and input. This includes basic window creation and handling, event handling, cursors, and providing miscellaneous information about the display.

Typically a backend library will provide a concrete subclass which implements the device specific methods described below.

In almost all cases, you should not call these methods directly in an application. You should use the equivalent methods available elsewhere in the library (e.g. NSWindow, NSScreen, etc).

AppKit/GSDisplayServer.h addDragTypes: types toWindow: win Convienience method that calls -addDragTypes:toWindow: using the server that controls win. dragTypesForWindow: win Convienience method that calls -dragTypesForWindow: using the server that controls win. removeDragTypes: types fromWindow: win Convienience method that calls -removeDragTypes:fromWindow: using the server that controls win. serverWithAttributes: attributes

Create a window server with attributes, which contains key/value pairs which describe the specifics of how the window server is to be initialized. Typically these values are specific to the concrete implementation. Currently there are no standard set of attributes defined for GSDisplayServer.

In almost all applications one would only create a single instance of a window server. Although it is possible, it is unlikely that you would need more than one window server (and you would have to be very careful how you handled window creation and events in this case).

setCurrentServer: server Sets the current server that will be handling windows, events, etc. This method must be called after a window server is created in order to make it available to the rest of the GUI library setDefaultServerClass: aClass Set the concrete subclass that will provide the device dependant implementation. addDragTypes: types toWindow: win Add (increment count by 1) each drag type to those registered for the window. If this results in a change to the types registered in the counted set, return YES, otherwise return NO. Subclasses should override this method, call 'super' and take appropriate action if the method returns 'YES'. attributes Return information used to create the server availableDepthsForScreen: screen Returns a null terminated list of possible window depths for screen. boundsForScreen: screen Retuns the bounds, in pixels, for the indicated screen of the display. closeServer Causes the server to disconnect from the display. If the receiver is the current server, it removes itself and sets the current server to nil. Sending any more messages to the receiver after this is likely to cause severe problems and probably crash the application. dragInfo Returns an instance of a class which implements the NSDraggingInfo protocol. dragTypesForWindow: win Returns the drag types set for the window win. initWithAttributes: attributes Initializes the server. This typically causes the receiver to connect to the display (e.g. XOpenDisplay() on an X-Windows server). removeDragTypes: types fromWindow: win Remove (decrement count by 1) each drag type from those registered for the window. If this results in a change to the types registered in the counted set, return YES, otherwise return NO. If given 'nil' as the array of types, remove ALL. Subclasses should override this method, call 'super' and take appropriate action if the method returns 'YES'. resolutionForScreen: screen Retuns the resolution, in points, for the indicated screen of the display. screenList Returns an array of NSNumbers, where each number describes a screen that is available on this display. serverDevice Returns a display dependant pointer that describes the internal connection to the display. On X-Windows, for example, this is a pointer to the Display variable. slideImage: image from: from to: to Description forthcoming. windowDepthForScreen: screen Returns the default depth of windows that are created on screen. windowDevice: win Returns a display dependant pointer that describes the internal window representation for win. On X-Windows, for example, this is a pointer to the Window variable.
Software documentation for the GSDisplayServer(EventOps) category AppKit/GSDisplayServer.h Description forthcoming. discardEventsMatchingMask: mask beforeEvent: limit Description forthcoming. getEventMatchingMask: mask beforeDate: limit inMode: mode dequeue: flag Description forthcoming. postEvent: anEvent atStart: flag Description forthcoming. Software documentation for the GSDisplayServer(WindowOps) category AppKit/GSDisplayServer.h Description forthcoming. _setWindowOwnedByServer: win Tells the receiver that it owns the window described by win. Concrete subclasses must call this function when creating a window. Do not call this method in any other case, particularly for a window that has already been created appOwnsMiniwindow Returns YES if the application should create the miniwindow counterpart to the full size window and own it. Some display systems handle the miniwindow themselves. In this case the backend subclass should override this method to return NO. capturemouse: win Grabs the pointer device so that all future mouse events will be directed only to the window win. If successful, the return value is YES and this message must be balanced by a -releasemouse message. docedited: edited : win Sets the document edited flag for the window findwindow: loc : op : otherWin : floc : winFound Description forthcoming. flushwindowrect: rect : win Causes buffered graphics to be flushed to the screen hidecursor Hides the cursor imagecursor: hotp : w : h : colors : image : cid Create a cursor from an image. Returns a pointer to the internal device representation that can be used later to make this cursor the current one miniwindow: win Miniaturizes the window mouselocation Returns the current mouse location movewindow: loc : win Moves the bottom left cornder of the window to loc orderwindow: op : otherWin : win Causes the window to be ordered onto or off the screen depending on the value of op. The window is ordered relative to otherWin. placewindow: frame : win Moves and resizes the window on the screen as described by frame. releasemouse Release a previous captured mouse from -capturemouse: setcursorcolor: fg : bg : cid Set the cursor given by the cid representation as being the current cursor. The cursor has a foreground color fg and a background color bg. To keep the default color for the cursor, pass nil for fg and bg. setinputfocus: win Forces focus to the window so that all key events are sent to this window setinputstate: state : win Sets the input state for the window given by the GSWindowInputState constant. Instructs the window manager that the specified window is 'key', 'main', or just a normal window. setmaxsize: size : win Set the maximum size of the window setminsize: size : win Set the minimum size of the window setresizeincrements: size : win Set the resize incremenet of the window setwindowlevel: level : win Set the level of the window as in [NSWindow -setLevel] showcursor Show a previously hidden cursor standardcursor: style : cid Create a standard cursor (such as an arror or IBeam). Returns a pointer to the internal device representation that can be used later to make this cursor the current one styleoffsets: l : r : t : b : style Returns the dimensions of the window that are inside the window frame but are controlled by the window manager. For instance, t gives the height of the title bar for the window stylewindow: style : win Sets the style of the window. See [NSWindow -styleMask] for a description of the available styles termwindow: win Destroys the representation of the window and frees and memory associated with it. titlewindow: window_title : win Sets the window title window: frame : type : style Creates a window whose location and size is described by frame and whose backing store is described by type. This window is not mapped to the screen by this call windowbacking: type Changes window's the backing store to type windowbounds: win Retuns the frame of the window on the screen windowdepth: win Returns the depth of the window windowdevice: win Sets the window drawable for the current NSGraphicsContext, typically by calling [NSGraphicsContext -DPSsetgcdrawable::::], although depending on the concrete implmentation, more information than this may need to be exchanged. windowlevel: win Returns the window level as in [NSWindow -level] windowlist Returns the list of windows that the server controls