CGGetDisplaysWithPoint(_:_:_:_:)

Declaration

func CGGetDisplaysWithPoint(_ point: CGPoint, _ maxDisplays: UInt32, _ displays: UnsafeMutablePointer<CGDirectDisplayID>?, _ matchingDisplayCount: UnsafeMutablePointer<UInt32>?) -> CGError

Parameters

• point:

  The coordinates of a point in the global display coordinate space. The origin is the upper-left corner of the main display.

• maxDisplays:

  The size of the displays array. This value determines the maximum number of displays the list includes.

• displays:

  A pointer to storage you provide for an array of display IDs. On return, the array contains a list of displays with bounds that include the point. If you pass NULL, on return the display count contains the total number of displays with bounds that include the point.

• matchingDisplayCount:

  A pointer to a display count variable you provide. On return, the display count contains the actual number of displays the list includes in the dspys array. This value is at most maxDisplays.

Return Value

A result code. To interpret the result code, see CGError.

Discussion

If the displays array is nil, this function ignores the maxDisplays parameter. If the maxDisplays parameter is 0, this function ignores the displays array. In any case, this function fills in the matchingDisplayCount pointer with the number of displays that contain the specified point.

See Also

Functions

• CGAcquireDisplayFadeReservation(_:_:)
• CGAssociateMouseAndMouseCursorPosition(_:)
• CGBeginDisplayConfiguration(_:)
• CGCancelDisplayConfiguration(_:)
• CGCaptureAllDisplays()
• CGCaptureAllDisplaysWithOptions(_:)
• CGCompleteDisplayConfiguration(_:_:)
• CGConfigureDisplayFadeEffect(_:_:_:_:_:_:)
• CGConfigureDisplayMirrorOfDisplay(_:_:_:)
• CGConfigureDisplayMode(_:_:_:)
• CGConfigureDisplayOrigin(_:_:_:_:)
• CGConfigureDisplayStereoOperation(_:_:_:_:)
• CGConfigureDisplayWithDisplayMode(_:_:_:_:)
• CGCursorIsDrawnInFramebuffer()
• CGCursorIsVisible()