+ * A popover may be animated when it shows, closes, moves, or appears to transition to a detachable window. + * This property also controls whether the popover animates when the content view or content size changes. + * + * @param animates The default value is true. + */ + public abstract void setAnimates(boolean animates); + + /** + * A Boolean value that indicates whether the window created by a popover’s detachment is automatically created. + * + * @return When detached is true, the detached window is automatically created. This property does not apply when + * detaching a popover results in a window returned by detachableWindowForPopover:. + */ + public abstract boolean isDetached(); + + /** + * The display state of the popover. + * + * @return The value is true if the popover is being shown, false otherwise. + */ + public abstract boolean isShown(); + + /** + * You must set the content view controller of the popover before the popover is shown. Changes to the + * popover's content view controller while the popover is shown will cause the popover to animate if the animates property is YES. + * + * @param controller The view controller that manages the content of the popover. + */ + public abstract void setContentViewController(NSViewController controller); + + /** + * Shows the popover anchored to the specified view. + *
+ * This method raises NSInternalInconsistencyException if contentViewController or the view controller’s view is nil. + * If the popover is already being shown, this method updates the anchored view, rectangle, and preferred edge. If the + * positioning view is not visible, this method does nothing. + * + * @param positioningRect The rectangle within positioningView relative to which the popover should be positioned. Normally + * set to the bounds of positioningView. May be an empty rectangle, which will default to the bounds of positioningView. + * @param positioningView The view relative to which the popover should be positioned. Causes the method to raise NSInvalidArgumentException if nil. + * @param preferredEdge The edge of positioningView the popover should prefer to be anchored to. + */ + public abstract void showRelativeToRect_ofView_preferredEdge(NSRect positioningRect, NSView positioningView, int preferredEdge); + + /** + * Shows the popover anchored to the specified toolbar item. + *
+ * Use this method to display a popover relative to a toolbar item. When the item is in the overflow menu, + * the popover presents itself from another appropriate affordance in the window. ¨ + * See showRelativeToRect:ofView:preferredEdge: for popover behavior. + *
+ * This method raises an NSInvalidArgumentException if it can’t locate the toolbar item. This could + * occur if the item isn’t in a toolbar, or because the toolbar isn’t in the window. + *
+ * C + * + * @param toolbarItem The toolbar item anchoring the popover. + */ + public abstract void showRelativeToToolbarItem(NSToolbarItem toolbarItem); + + /** + * Attempts to close the popover. + *
+ * The popover will not be closed if it has a delegate and the delegate implements the returns popoverShouldClose: method + * returning NO, or if a subclass of the NSPopover class implements popoverShouldClose: and returns NO). + *
+ * The operation will fail if the popover is displaying a nested popover or if it has a child window. A window will + * attempt to close its popovers when it receives a performClose: message. + *
+ * The popover animates out when closed unless the animates property is set to NO. + * + * @param sender The sender of the action message. + */ + public abstract void performClose(ID sender); + + /** + * Forces the popover to close without consulting its delegate. + *
+ * Any popovers nested within the popovers will also receive a close message. When a window is closed in
+ * response to the close message being sent, all of its popovers are closed. The popover animates out
+ * when closed unless the animates property is set to false.
+ */
+ public abstract void close();
+
+ /**
+ * @param delegate The delegate of the popover.
+ */
+ public abstract void setDelegate(ID delegate);
+
+ /**
+ * A set of optional methods that a popover delegate can implement to provide additional or custom functionality.
+ */
+ public interface NSPopoverDelegate {
+ boolean popoverShouldClose(NSPopover popover);
+
+ boolean popoverShouldDetach(NSPopover popover);
+
+ void popoverDidDetach(NSPopover popover);
+
+ void popoverWillShow(NSNotification notification);
+
+ void popoverDidShow(NSNotification notification);
+
+ void popoverWillClose(NSNotification notification);
+
+ void popoverDidClose(NSNotification notification);
+ }
+}
diff --git a/binding/src/main/java/ch/cyberduck/binding/application/NSView.java b/binding/src/main/java/ch/cyberduck/binding/application/NSView.java
index 144b98e17da..dbe5bfe868b 100644
--- a/binding/src/main/java/ch/cyberduck/binding/application/NSView.java
+++ b/binding/src/main/java/ch/cyberduck/binding/application/NSView.java
@@ -313,11 +313,15 @@ public interface _Class extends ObjCClass {
public abstract void setFrame(NSRect frame);
/**
- * native declaration : :163
- * Conversion Error : NSRect
+ * @return The view’s frame rectangle, which defines its position and size in its superview’s coordinate system.
*/
public abstract NSRect frame();
+ /**
+ * @return The view’s bounds rectangle, which expresses its location and size in its own coordinate system.
+ */
+ public abstract NSRect bounds();
+
/**
* Original signature : void setFrameRotation(CGFloat)
* native declaration : :164
diff --git a/binding/src/main/java/ch/cyberduck/binding/application/NSViewController.java b/binding/src/main/java/ch/cyberduck/binding/application/NSViewController.java
new file mode 100644
index 00000000000..d100985d021
--- /dev/null
+++ b/binding/src/main/java/ch/cyberduck/binding/application/NSViewController.java
@@ -0,0 +1,58 @@
+package ch.cyberduck.binding.application;
+
+/*
+ * Copyright (c) 2002-2024 iterate GmbH. All rights reserved.
+ * https://cyberduck.io/
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ */
+
+import ch.cyberduck.binding.foundation.NSBundle;
+
+import org.rococoa.ObjCClass;
+
+public abstract class NSViewController extends NSResponder {
+ private static final NSViewController._Class CLASS = org.rococoa.Rococoa.createClass("NSViewController", NSViewController._Class.class);
+
+ public interface _Class extends ObjCClass {
+ NSViewController alloc();
+ }
+
+ public static NSViewController create() {
+ return CLASS.alloc();
+ }
+
+ public static NSViewController create(String nib, NSBundle bundle) {
+ return CLASS.alloc().initWithNibName_bundle(nib, bundle);
+ }
+
+ /**
+ * The NSViewController object looks for the nib file in the bundle's language-specific project directories first, followed by the Resources directory.
+ *
+ * The specified nib file should typically have the class of the file's owner set to NSViewController, or a custom subclass, with the view outlet connected to a view. + *
+ * If you pass in nil for nibNameOrNil, nibName returns nil and loadView throws an exception; in this case you must set view before view is invoked, or override loadView. + * + * @param nib The name of the nib file, without any leading path information. + * @param bundle The bundle in which to search for the nib file. If you specify nil, this method looks for the nib file in the main bundle. + * @return Returns a view controller object initialized to the nib file in the specified bundle. + */ + public abstract NSViewController initWithNibName_bundle(String nib, NSBundle bundle); + + /** + * If this property’s value is not already set when you access it, the view controller invokes the loadView method. That method, in turn, sets the view from the nib file identified by the view controller’s nibName and nibBundle properties. + *
+ * If you want to set a view controller’s view directly, set this property’s value immediately after creating the view controller. + * + * @param view The view controller’s primary view. + */ + public abstract void setView(NSView view); +}