mirror of
https://github.com/rust-windowing/winit.git
synced 2026-06-27 07:03:15 -04:00
da7422c6e1
* On macOS, add `WindowBuilderExtMacOS::with_parent_window` * Replace Parent with Option<Id<NSWindow, Shared>> * Add addChildWindow method on NSWindow instead * Update with_parent_window to be unsafe fn * Add unified `with_parent_window` * Remove `WindowBuilderExtUnix::with_parent` * Remove `WindowBuilderExtWindows::with_parent_window` * Clean up CI warnings * Update CHANGELOG.md It's `WindowBuilderExtX11` rather than `WindowBuilderExtUnix` * Rename parent to owner * Make with_parent_window unsafe and update its doc * Add another way to get window on mac * Add more documentations * Add match arm and panic on invalid varients * Add Xcb arm * Update child_window example to make it safer and work in i686 * Remove duplicate entry in CHANGELOG.md * Propogate error instead of expect * Replace unreachable to panic * Add platform note to X11 Co-authored-by: Wu Yu Wei <wusyong9104@gmail.com>
100 lines
3.5 KiB
Rust
100 lines
3.5 KiB
Rust
use std::ffi::c_void;
|
|
use std::num::NonZeroIsize;
|
|
use std::ptr;
|
|
|
|
use objc2::foundation::{NSObject, NSPoint, NSRect};
|
|
use objc2::rc::{Id, Shared};
|
|
use objc2::runtime::Object;
|
|
use objc2::{extern_class, extern_methods, msg_send_id, ClassType};
|
|
|
|
use super::{NSCursor, NSResponder, NSTextInputContext, NSWindow};
|
|
|
|
extern_class!(
|
|
#[derive(Debug, PartialEq, Eq, Hash)]
|
|
pub(crate) struct NSView;
|
|
|
|
unsafe impl ClassType for NSView {
|
|
#[inherits(NSObject)]
|
|
type Super = NSResponder;
|
|
}
|
|
);
|
|
|
|
// Documented as "Main Thread Only".
|
|
// > generally thread safe, although operations on views such as creating,
|
|
// > resizing, and moving should happen on the main thread.
|
|
// <https://developer.apple.com/library/archive/documentation/Cocoa/Conceptual/CocoaFundamentals/AddingBehaviortoaCocoaProgram/AddingBehaviorCocoa.html#//apple_ref/doc/uid/TP40002974-CH5-SW47>
|
|
//
|
|
// > If you want to use a thread to draw to a view, bracket all drawing code
|
|
// > between the lockFocusIfCanDraw and unlockFocus methods of NSView.
|
|
// <https://developer.apple.com/library/archive/documentation/Cocoa/Conceptual/Multithreading/ThreadSafetySummary/ThreadSafetySummary.html#//apple_ref/doc/uid/10000057i-CH12-123351-BBCFIIEB>
|
|
|
|
extern_methods!(
|
|
/// Getter methods
|
|
unsafe impl NSView {
|
|
#[sel(frame)]
|
|
pub fn frame(&self) -> NSRect;
|
|
|
|
#[sel(bounds)]
|
|
pub fn bounds(&self) -> NSRect;
|
|
|
|
pub fn inputContext(
|
|
&self,
|
|
// _mtm: MainThreadMarker,
|
|
) -> Option<Id<NSTextInputContext, Shared>> {
|
|
unsafe { msg_send_id![self, inputContext] }
|
|
}
|
|
|
|
#[sel(visibleRect)]
|
|
pub fn visibleRect(&self) -> NSRect;
|
|
|
|
#[sel(hasMarkedText)]
|
|
pub fn hasMarkedText(&self) -> bool;
|
|
|
|
#[sel(convertPoint:fromView:)]
|
|
pub fn convertPoint_fromView(&self, point: NSPoint, view: Option<&NSView>) -> NSPoint;
|
|
|
|
pub fn window(&self) -> Option<Id<NSWindow, Shared>> {
|
|
unsafe { msg_send_id![self, window] }
|
|
}
|
|
}
|
|
|
|
unsafe impl NSView {
|
|
#[sel(setWantsBestResolutionOpenGLSurface:)]
|
|
pub fn setWantsBestResolutionOpenGLSurface(&self, value: bool);
|
|
|
|
#[sel(setWantsLayer:)]
|
|
pub fn setWantsLayer(&self, wants_layer: bool);
|
|
|
|
#[sel(setPostsFrameChangedNotifications:)]
|
|
pub fn setPostsFrameChangedNotifications(&mut self, value: bool);
|
|
|
|
#[sel(removeTrackingRect:)]
|
|
pub fn removeTrackingRect(&self, tag: NSTrackingRectTag);
|
|
|
|
#[sel(addTrackingRect:owner:userData:assumeInside:)]
|
|
unsafe fn inner_addTrackingRect(
|
|
&self,
|
|
rect: NSRect,
|
|
owner: &Object,
|
|
user_data: *mut c_void,
|
|
assume_inside: bool,
|
|
) -> Option<NSTrackingRectTag>;
|
|
|
|
pub fn add_tracking_rect(&self, rect: NSRect, assume_inside: bool) -> NSTrackingRectTag {
|
|
// SAFETY: The user data is NULL, so it is valid
|
|
unsafe { self.inner_addTrackingRect(rect, self, ptr::null_mut(), assume_inside) }
|
|
.expect("failed creating tracking rect")
|
|
}
|
|
|
|
#[sel(addCursorRect:cursor:)]
|
|
// NSCursor safe to take by shared reference since it is already immutable
|
|
pub fn addCursorRect(&self, rect: NSRect, cursor: &NSCursor);
|
|
|
|
#[sel(setHidden:)]
|
|
pub fn setHidden(&self, hidden: bool);
|
|
}
|
|
);
|
|
|
|
/// <https://developer.apple.com/documentation/appkit/nstrackingrecttag?language=objc>
|
|
pub type NSTrackingRectTag = NonZeroIsize; // NSInteger, but non-zero!
|