From 05122d6320aed985c8faff52b4fb672ec2b88398 Mon Sep 17 00:00:00 2001 From: Swift/Win32 Date: Sat, 25 Jun 2022 22:36:09 +0000 Subject: [PATCH] compnerd/swift-win32@4923435640415284285c2a3eb58ac47e895def7c --- .gitattributes | 4 + .gitignore | 5 + 404.html | 25 + CoreAnimation/index.md | 43 + CoreGraphics/AffineTransform.md | 141 ++ CoreGraphics/Point.md | 85 ++ CoreGraphics/Rect.md | 282 ++++ CoreGraphics/Rect_Edge.md | 55 + CoreGraphics/Size.md | 72 + CoreGraphics/Vector.md | 82 ++ CoreGraphics/_Footer.md | 1 + CoreGraphics/_Sidebar.md | 11 + CoreGraphics/index.md | 19 + Gemfile | 17 + SwiftWin32/AccessibilityContrast.md | 42 + SwiftWin32/Action.md | 99 ++ SwiftWin32/Action_Identifier.md | 46 + .../AdaptivePresentationControllerDelegate.md | 235 ++++ SwiftWin32/AffineTransform.md | 141 ++ SwiftWin32/AlertAction.md | 49 + SwiftWin32/AlertAction_Style.md | 43 + SwiftWin32/AlertController.md | 89 ++ SwiftWin32/AlertController_Style.md | 35 + SwiftWin32/Appearance.md | 53 + SwiftWin32/AppearanceContainer.md | 13 + SwiftWin32/Application.md | 97 ++ SwiftWin32/ApplicationDelegate.md | 312 +++++ SwiftWin32/ApplicationMain(________).md | 14 + SwiftWin32/Application_LaunchOptionsKey.md | 131 ++ SwiftWin32/Application_State.md | 43 + SwiftWin32/Axis.md | 58 + SwiftWin32/BackgroundConfiguration.md | 250 ++++ SwiftWin32/BarButtonItem.md | 432 ++++++ SwiftWin32/BarButtonItemGroup.md | 77 ++ SwiftWin32/BarButtonItem_Style.md | 44 + SwiftWin32/BarButtonItem_SystemItem.md | 222 ++++ SwiftWin32/BarItem.md | 156 +++ SwiftWin32/BarMetrics.md | 74 ++ SwiftWin32/BezierPath.md | 10 + SwiftWin32/Button.md | 46 + SwiftWin32/Button_ButtonType.md | 83 ++ SwiftWin32/CellConfigurationState.md | 69 + SwiftWin32/Color.md | 562 ++++++++ SwiftWin32/Command.md | 91 ++ SwiftWin32/CommandAlternate.md | 52 + SwiftWin32/ConfigurationColorTransformer.md | 67 + SwiftWin32/ConfigurationState.md | 39 + SwiftWin32/ConfigurationStateCustomKey.md | 46 + SwiftWin32/ContentConfiguration.md | 33 + SwiftWin32/ContentContainer.md | 68 + SwiftWin32/ContentSizeCategory.md | 171 +++ SwiftWin32/ContentSizeCategoryAdjusting.md | 25 + .../ContentSizeCategoryImageAdjusting.md | 25 + SwiftWin32/ContentView.md | 22 + SwiftWin32/ContextMenuConfiguration.md | 54 + SwiftWin32/ContextMenuInteraction.md | 92 ++ SwiftWin32/ContextMenuInteractionAnimating.md | 41 + .../ContextMenuInteractionCommitAnimating.md | 27 + .../ContextMenuInteractionCommitStyle.md | 34 + SwiftWin32/ContextMenuInteractionDelegate.md | 123 ++ .../ContextMenuInteraction_Appearance.md | 42 + SwiftWin32/ContextualAction.md | 76 ++ SwiftWin32/ContextualAction_Style.md | 35 + SwiftWin32/Control.md | 59 + SwiftWin32/Control_Event.md | 215 +++ SwiftWin32/Control_State.md | 89 ++ SwiftWin32/CoordinateSpace.md | 62 + SwiftWin32/CubicTimingParameters.md | 65 + SwiftWin32/DatePicker.md | 55 + SwiftWin32/DatePickerStyle.md | 40 + SwiftWin32/Device.md | 174 +++ SwiftWin32/Device_BatteryState.md | 40 + SwiftWin32/Device_Orientation.md | 58 + SwiftWin32/DirectionalEdgeInsets.md | 86 ++ SwiftWin32/DirectionalRectEdge.md | 81 ++ SwiftWin32/DisplayGamut.md | 42 + SwiftWin32/EdgeInsets.md | 68 + SwiftWin32/Event.md | 104 ++ SwiftWin32/Event_ButtonMask.md | 63 + SwiftWin32/Event_EventSubtype.md | 42 + SwiftWin32/Event_EventType.md | 50 + SwiftWin32/FocusAnimationContext.md | 22 + SwiftWin32/FocusAnimationCoordinator.md | 43 + SwiftWin32/FocusEnvironment.md | 119 ++ SwiftWin32/FocusHeading.md | 88 ++ SwiftWin32/FocusItem.md | 62 + SwiftWin32/FocusItemContainer.md | 33 + SwiftWin32/FocusMovementHint.md | 57 + SwiftWin32/FocusSoundIdentifier.md | 62 + SwiftWin32/FocusUpdateContext.md | 87 ++ SwiftWin32/Font.md | 216 +++ SwiftWin32/FontDescriptor.md | 202 +++ SwiftWin32/FontDescriptor_AttributeName.md | 144 ++ SwiftWin32/FontDescriptor_FeatureKey.md | 63 + SwiftWin32/FontDescriptor_SymbolicTraits.md | 208 +++ SwiftWin32/FontDescriptor_SystemDesign.md | 72 + SwiftWin32/FontDescriptor_TraitKey.md | 70 + SwiftWin32/FontMetrics.md | 74 ++ SwiftWin32/Font_TextStyle.md | 120 ++ SwiftWin32/Font_Weight.md | 104 ++ SwiftWin32/ForceTouchCapability.md | 45 + SwiftWin32/GestureRecognizer.md | 176 +++ SwiftWin32/GestureRecognizerDelegate.md | 157 +++ SwiftWin32/GestureRecognizer_State.md | 92 ++ SwiftWin32/Image.md | 41 + SwiftWin32/ImageView.md | 60 + SwiftWin32/Image_Configuration.md | 43 + SwiftWin32/Image_SymbolConfiguration.md | 157 +++ SwiftWin32/Image_SymbolScale.md | 56 + SwiftWin32/Image_SymbolWeight.md | 108 ++ SwiftWin32/IndexPath.md | 52 + SwiftWin32/InputViewController.md | 14 + SwiftWin32/Interaction.md | 44 + SwiftWin32/InterfaceOrientation.md | 72 + SwiftWin32/InterfaceOrientationMask.md | 100 ++ SwiftWin32/KeyModifierFlags.md | 89 ++ SwiftWin32/Label.md | 62 + SwiftWin32/LayoutAnchor.md | 74 ++ SwiftWin32/LayoutConstraint.md | 144 ++ SwiftWin32/LayoutConstraint_Attribute.md | 200 +++ SwiftWin32/LayoutConstraint_Relation.md | 46 + SwiftWin32/LayoutDimension.md | 112 ++ SwiftWin32/LayoutGuide.md | 119 ++ SwiftWin32/LayoutPriority.md | 106 ++ SwiftWin32/LayoutSupport.md | 47 + SwiftWin32/LayoutXAxisAnchor.md | 57 + SwiftWin32/LayoutYAxisAnchor.md | 57 + SwiftWin32/LegibilityWeight.md | 44 + SwiftWin32/LineBreakMode.md | 71 + SwiftWin32/ListContentConfiguration.md | 286 ++++ ...istContentConfiguration_ImageProperties.md | 130 ++ ...ListContentConfiguration_TextProperties.md | 118 ++ ...figuration_TextProperties_TextAlignment.md | 22 + ...figuration_TextProperties_TextTransform.md | 22 + SwiftWin32/Menu.md | 81 ++ SwiftWin32/MenuBuilder.md | 110 ++ SwiftWin32/MenuElement.md | 41 + SwiftWin32/MenuElement_Attributes.md | 64 + SwiftWin32/MenuElement_State.md | 43 + SwiftWin32/MenuSystem.md | 48 + SwiftWin32/Menu_Identifier.md | 376 ++++++ SwiftWin32/Menu_Options.md | 58 + SwiftWin32/ModalPresentationStyle.md | 110 ++ SwiftWin32/ModalTransitionStyle.md | 67 + SwiftWin32/Offset.md | 81 ++ SwiftWin32/PickerView.md | 109 ++ SwiftWin32/PickerViewDataSource.md | 37 + SwiftWin32/PickerViewDelegate.md | 125 ++ SwiftWin32/Point.md | 85 ++ SwiftWin32/PointerEffect.md | 63 + SwiftWin32/PointerEffect_TintMode.md | 43 + SwiftWin32/PointerInteraction.md | 73 + SwiftWin32/PointerInteractionAnimating.md | 31 + SwiftWin32/PointerInteractionDelegate.md | 94 ++ SwiftWin32/PointerRegion.md | 34 + SwiftWin32/PointerRegionRequest.md | 31 + SwiftWin32/PointerShape.md | 57 + SwiftWin32/PointerStyle.md | 42 + SwiftWin32/PresentationController.md | 368 ++++++ SwiftWin32/Press.md | 104 ++ SwiftWin32/Press_Phase.md | 58 + SwiftWin32/Press_PressType.md | 90 ++ SwiftWin32/PressesEvent.md | 39 + SwiftWin32/PreviewParameters.md | 57 + SwiftWin32/PreviewTarget.md | 61 + SwiftWin32/ProgressView.md | 30 + SwiftWin32/Rect.md | 282 ++++ SwiftWin32/RectEdge.md | 80 ++ SwiftWin32/Rect_Edge.md | 55 + SwiftWin32/Responder.md | 347 +++++ SwiftWin32/Scene.md | 115 ++ SwiftWin32/SceneConfiguration.md | 79 ++ SwiftWin32/SceneDelegate.md | 108 ++ SwiftWin32/SceneSession.md | 64 + SwiftWin32/SceneSession_Role.md | 57 + SwiftWin32/SceneSizeRestrictions.md | 29 + SwiftWin32/Scene_ConnectionOptions.md | 10 + SwiftWin32/Screen.md | 84 ++ SwiftWin32/Size.md | 72 + SwiftWin32/Slider.md | 50 + SwiftWin32/SpringLoadedInteractionContext.md | 41 + .../SpringLoadedInteractionEffectState.md | 51 + SwiftWin32/SpringTimingParameters.md | 68 + SwiftWin32/Stepper.md | 85 ++ SwiftWin32/String.md | 14 + SwiftWin32/SwipeActionsConfiguration.md | 42 + SwiftWin32/Switch.md | 72 + SwiftWin32/Switch_Style.md | 43 + SwiftWin32/TableView.md | 63 + SwiftWin32/TableViewCell.md | 95 ++ SwiftWin32/TableViewCell_CellStyle.md | 54 + SwiftWin32/TableViewCell_EditingStyle.md | 44 + SwiftWin32/TableViewDataSource.md | 86 ++ SwiftWin32/TableViewDelegate.md | 813 ++++++++++++ SwiftWin32/TableViewFocusUpdateContext.md | 37 + SwiftWin32/TableViewHeaderFooterView.md | 129 ++ SwiftWin32/TableView_Style.md | 40 + SwiftWin32/TapGestureRecognizer.md | 42 + SwiftWin32/TargetedPreview.md | 87 ++ SwiftWin32/TextAlignment.md | 46 + SwiftWin32/TextField.md | 77 ++ SwiftWin32/TextFieldDelegate.md | 14 + SwiftWin32/TextInputTraits.md | 28 + SwiftWin32/TextView.md | 63 + SwiftWin32/TimingCurveProvider.md | 39 + SwiftWin32/TimingCurveType.md | 56 + SwiftWin32/Touch.md | 53 + SwiftWin32/Touch_Phase.md | 85 ++ SwiftWin32/Touch_TouchType.md | 42 + SwiftWin32/TraitCollection.md | 383 ++++++ SwiftWin32/TraitEnvironment.md | 32 + SwiftWin32/TraitEnvironmentLayoutDirection.md | 43 + SwiftWin32/Transform3D.md | 43 + .../TransitionContextViewControllerKey.md | 58 + SwiftWin32/TransitionContextViewKey.md | 57 + SwiftWin32/UserInterfaceActiveAppearance.md | 42 + SwiftWin32/UserInterfaceIdiom.md | 96 ++ SwiftWin32/UserInterfaceLevel.md | 44 + SwiftWin32/UserInterfaceSizeClass.md | 42 + SwiftWin32/UserInterfaceStyle.md | 42 + SwiftWin32/Vector.md | 82 ++ SwiftWin32/View.md | 659 ++++++++++ SwiftWin32/ViewAnimating.md | 87 ++ SwiftWin32/ViewAnimatingPosition.md | 47 + SwiftWin32/ViewAnimatingState.md | 49 + SwiftWin32/ViewConfigurationState.md | 102 ++ SwiftWin32/ViewController.md | 1170 +++++++++++++++++ .../ViewControllerAnimatedTransitioning.md | 58 + .../ViewControllerContextTransitioning.md | 142 ++ .../ViewControllerInteractiveTransitioning.md | 78 ++ .../ViewControllerTransitionCoordinator.md | 41 + ...wControllerTransitionCoordinatorContext.md | 132 ++ .../ViewControllerTransitioningDelegate.md | 112 ++ SwiftWin32/ViewImplicitlyAnimating.md | 79 ++ SwiftWin32/View_AnimationCurve.md | 55 + SwiftWin32/View_AnimationOptions.md | 254 ++++ SwiftWin32/View_AutoresizingMask.md | 90 ++ SwiftWin32/View_ContentMode.md | 118 ++ SwiftWin32/View_TintAdjustmentMode.md | 46 + SwiftWin32/VisualEffect.md | 12 + SwiftWin32/Window.md | 175 +++ SwiftWin32/WindowScene.md | 51 + SwiftWin32/WindowSceneDelegate.md | 55 + SwiftWin32/Window_Level.md | 64 + SwiftWin32/_Footer.md | 1 + SwiftWin32/_Sidebar.md | 257 ++++ SwiftWin32/_TriviallyConstructible.md | 18 + SwiftWin32/_Win32WindowText.md | 27 + SwiftWin32/index.md | 503 +++++++ SwiftWin32UI/AnyView.md | 46 + SwiftWin32UI/App.md | 55 + SwiftWin32UI/EmptyView.md | 32 + SwiftWin32UI/EquatableView.md | 43 + SwiftWin32UI/Group.md | 33 + SwiftWin32UI/Label.md | 30 + SwiftWin32UI/Never.md | 14 + SwiftWin32UI/Scene.md | 31 + SwiftWin32UI/SceneBuilder.md | 19 + SwiftWin32UI/SwiftWin32_Label.md | 14 + SwiftWin32UI/UIApplicationDelegateAdaptor.md | 34 + SwiftWin32UI/View.md | 40 + SwiftWin32UI/ViewBuilder.md | 25 + SwiftWin32UI/WindowGroup.md | 34 + SwiftWin32UI/_Footer.md | 1 + SwiftWin32UI/_Sidebar.md | 31 + SwiftWin32UI/index.md | 38 + _config.yml | 67 + index.md | 12 + media/images/screenshot.png | Bin 0 -> 132237 bytes 269 files changed, 24388 insertions(+) create mode 100644 .gitattributes create mode 100644 .gitignore create mode 100644 404.html create mode 100644 CoreAnimation/index.md create mode 100644 CoreGraphics/AffineTransform.md create mode 100644 CoreGraphics/Point.md create mode 100644 CoreGraphics/Rect.md create mode 100644 CoreGraphics/Rect_Edge.md create mode 100644 CoreGraphics/Size.md create mode 100644 CoreGraphics/Vector.md create mode 100644 CoreGraphics/_Footer.md create mode 100644 CoreGraphics/_Sidebar.md create mode 100644 CoreGraphics/index.md create mode 100644 Gemfile create mode 100644 SwiftWin32/AccessibilityContrast.md create mode 100644 SwiftWin32/Action.md create mode 100644 SwiftWin32/Action_Identifier.md create mode 100644 SwiftWin32/AdaptivePresentationControllerDelegate.md create mode 100644 SwiftWin32/AffineTransform.md create mode 100644 SwiftWin32/AlertAction.md create mode 100644 SwiftWin32/AlertAction_Style.md create mode 100644 SwiftWin32/AlertController.md create mode 100644 SwiftWin32/AlertController_Style.md create mode 100644 SwiftWin32/Appearance.md create mode 100644 SwiftWin32/AppearanceContainer.md create mode 100644 SwiftWin32/Application.md create mode 100644 SwiftWin32/ApplicationDelegate.md create mode 100644 SwiftWin32/ApplicationMain(________).md create mode 100644 SwiftWin32/Application_LaunchOptionsKey.md create mode 100644 SwiftWin32/Application_State.md create mode 100644 SwiftWin32/Axis.md create mode 100644 SwiftWin32/BackgroundConfiguration.md create mode 100644 SwiftWin32/BarButtonItem.md create mode 100644 SwiftWin32/BarButtonItemGroup.md create mode 100644 SwiftWin32/BarButtonItem_Style.md create mode 100644 SwiftWin32/BarButtonItem_SystemItem.md create mode 100644 SwiftWin32/BarItem.md create mode 100644 SwiftWin32/BarMetrics.md create mode 100644 SwiftWin32/BezierPath.md create mode 100644 SwiftWin32/Button.md create mode 100644 SwiftWin32/Button_ButtonType.md create mode 100644 SwiftWin32/CellConfigurationState.md create mode 100644 SwiftWin32/Color.md create mode 100644 SwiftWin32/Command.md create mode 100644 SwiftWin32/CommandAlternate.md create mode 100644 SwiftWin32/ConfigurationColorTransformer.md create mode 100644 SwiftWin32/ConfigurationState.md create mode 100644 SwiftWin32/ConfigurationStateCustomKey.md create mode 100644 SwiftWin32/ContentConfiguration.md create mode 100644 SwiftWin32/ContentContainer.md create mode 100644 SwiftWin32/ContentSizeCategory.md create mode 100644 SwiftWin32/ContentSizeCategoryAdjusting.md create mode 100644 SwiftWin32/ContentSizeCategoryImageAdjusting.md create mode 100644 SwiftWin32/ContentView.md create mode 100644 SwiftWin32/ContextMenuConfiguration.md create mode 100644 SwiftWin32/ContextMenuInteraction.md create mode 100644 SwiftWin32/ContextMenuInteractionAnimating.md create mode 100644 SwiftWin32/ContextMenuInteractionCommitAnimating.md create mode 100644 SwiftWin32/ContextMenuInteractionCommitStyle.md create mode 100644 SwiftWin32/ContextMenuInteractionDelegate.md create mode 100644 SwiftWin32/ContextMenuInteraction_Appearance.md create mode 100644 SwiftWin32/ContextualAction.md create mode 100644 SwiftWin32/ContextualAction_Style.md create mode 100644 SwiftWin32/Control.md create mode 100644 SwiftWin32/Control_Event.md create mode 100644 SwiftWin32/Control_State.md create mode 100644 SwiftWin32/CoordinateSpace.md create mode 100644 SwiftWin32/CubicTimingParameters.md create mode 100644 SwiftWin32/DatePicker.md create mode 100644 SwiftWin32/DatePickerStyle.md create mode 100644 SwiftWin32/Device.md create mode 100644 SwiftWin32/Device_BatteryState.md create mode 100644 SwiftWin32/Device_Orientation.md create mode 100644 SwiftWin32/DirectionalEdgeInsets.md create mode 100644 SwiftWin32/DirectionalRectEdge.md create mode 100644 SwiftWin32/DisplayGamut.md create mode 100644 SwiftWin32/EdgeInsets.md create mode 100644 SwiftWin32/Event.md create mode 100644 SwiftWin32/Event_ButtonMask.md create mode 100644 SwiftWin32/Event_EventSubtype.md create mode 100644 SwiftWin32/Event_EventType.md create mode 100644 SwiftWin32/FocusAnimationContext.md create mode 100644 SwiftWin32/FocusAnimationCoordinator.md create mode 100644 SwiftWin32/FocusEnvironment.md create mode 100644 SwiftWin32/FocusHeading.md create mode 100644 SwiftWin32/FocusItem.md create mode 100644 SwiftWin32/FocusItemContainer.md create mode 100644 SwiftWin32/FocusMovementHint.md create mode 100644 SwiftWin32/FocusSoundIdentifier.md create mode 100644 SwiftWin32/FocusUpdateContext.md create mode 100644 SwiftWin32/Font.md create mode 100644 SwiftWin32/FontDescriptor.md create mode 100644 SwiftWin32/FontDescriptor_AttributeName.md create mode 100644 SwiftWin32/FontDescriptor_FeatureKey.md create mode 100644 SwiftWin32/FontDescriptor_SymbolicTraits.md create mode 100644 SwiftWin32/FontDescriptor_SystemDesign.md create mode 100644 SwiftWin32/FontDescriptor_TraitKey.md create mode 100644 SwiftWin32/FontMetrics.md create mode 100644 SwiftWin32/Font_TextStyle.md create mode 100644 SwiftWin32/Font_Weight.md create mode 100644 SwiftWin32/ForceTouchCapability.md create mode 100644 SwiftWin32/GestureRecognizer.md create mode 100644 SwiftWin32/GestureRecognizerDelegate.md create mode 100644 SwiftWin32/GestureRecognizer_State.md create mode 100644 SwiftWin32/Image.md create mode 100644 SwiftWin32/ImageView.md create mode 100644 SwiftWin32/Image_Configuration.md create mode 100644 SwiftWin32/Image_SymbolConfiguration.md create mode 100644 SwiftWin32/Image_SymbolScale.md create mode 100644 SwiftWin32/Image_SymbolWeight.md create mode 100644 SwiftWin32/IndexPath.md create mode 100644 SwiftWin32/InputViewController.md create mode 100644 SwiftWin32/Interaction.md create mode 100644 SwiftWin32/InterfaceOrientation.md create mode 100644 SwiftWin32/InterfaceOrientationMask.md create mode 100644 SwiftWin32/KeyModifierFlags.md create mode 100644 SwiftWin32/Label.md create mode 100644 SwiftWin32/LayoutAnchor.md create mode 100644 SwiftWin32/LayoutConstraint.md create mode 100644 SwiftWin32/LayoutConstraint_Attribute.md create mode 100644 SwiftWin32/LayoutConstraint_Relation.md create mode 100644 SwiftWin32/LayoutDimension.md create mode 100644 SwiftWin32/LayoutGuide.md create mode 100644 SwiftWin32/LayoutPriority.md create mode 100644 SwiftWin32/LayoutSupport.md create mode 100644 SwiftWin32/LayoutXAxisAnchor.md create mode 100644 SwiftWin32/LayoutYAxisAnchor.md create mode 100644 SwiftWin32/LegibilityWeight.md create mode 100644 SwiftWin32/LineBreakMode.md create mode 100644 SwiftWin32/ListContentConfiguration.md create mode 100644 SwiftWin32/ListContentConfiguration_ImageProperties.md create mode 100644 SwiftWin32/ListContentConfiguration_TextProperties.md create mode 100644 SwiftWin32/ListContentConfiguration_TextProperties_TextAlignment.md create mode 100644 SwiftWin32/ListContentConfiguration_TextProperties_TextTransform.md create mode 100644 SwiftWin32/Menu.md create mode 100644 SwiftWin32/MenuBuilder.md create mode 100644 SwiftWin32/MenuElement.md create mode 100644 SwiftWin32/MenuElement_Attributes.md create mode 100644 SwiftWin32/MenuElement_State.md create mode 100644 SwiftWin32/MenuSystem.md create mode 100644 SwiftWin32/Menu_Identifier.md create mode 100644 SwiftWin32/Menu_Options.md create mode 100644 SwiftWin32/ModalPresentationStyle.md create mode 100644 SwiftWin32/ModalTransitionStyle.md create mode 100644 SwiftWin32/Offset.md create mode 100644 SwiftWin32/PickerView.md create mode 100644 SwiftWin32/PickerViewDataSource.md create mode 100644 SwiftWin32/PickerViewDelegate.md create mode 100644 SwiftWin32/Point.md create mode 100644 SwiftWin32/PointerEffect.md create mode 100644 SwiftWin32/PointerEffect_TintMode.md create mode 100644 SwiftWin32/PointerInteraction.md create mode 100644 SwiftWin32/PointerInteractionAnimating.md create mode 100644 SwiftWin32/PointerInteractionDelegate.md create mode 100644 SwiftWin32/PointerRegion.md create mode 100644 SwiftWin32/PointerRegionRequest.md create mode 100644 SwiftWin32/PointerShape.md create mode 100644 SwiftWin32/PointerStyle.md create mode 100644 SwiftWin32/PresentationController.md create mode 100644 SwiftWin32/Press.md create mode 100644 SwiftWin32/Press_Phase.md create mode 100644 SwiftWin32/Press_PressType.md create mode 100644 SwiftWin32/PressesEvent.md create mode 100644 SwiftWin32/PreviewParameters.md create mode 100644 SwiftWin32/PreviewTarget.md create mode 100644 SwiftWin32/ProgressView.md create mode 100644 SwiftWin32/Rect.md create mode 100644 SwiftWin32/RectEdge.md create mode 100644 SwiftWin32/Rect_Edge.md create mode 100644 SwiftWin32/Responder.md create mode 100644 SwiftWin32/Scene.md create mode 100644 SwiftWin32/SceneConfiguration.md create mode 100644 SwiftWin32/SceneDelegate.md create mode 100644 SwiftWin32/SceneSession.md create mode 100644 SwiftWin32/SceneSession_Role.md create mode 100644 SwiftWin32/SceneSizeRestrictions.md create mode 100644 SwiftWin32/Scene_ConnectionOptions.md create mode 100644 SwiftWin32/Screen.md create mode 100644 SwiftWin32/Size.md create mode 100644 SwiftWin32/Slider.md create mode 100644 SwiftWin32/SpringLoadedInteractionContext.md create mode 100644 SwiftWin32/SpringLoadedInteractionEffectState.md create mode 100644 SwiftWin32/SpringTimingParameters.md create mode 100644 SwiftWin32/Stepper.md create mode 100644 SwiftWin32/String.md create mode 100644 SwiftWin32/SwipeActionsConfiguration.md create mode 100644 SwiftWin32/Switch.md create mode 100644 SwiftWin32/Switch_Style.md create mode 100644 SwiftWin32/TableView.md create mode 100644 SwiftWin32/TableViewCell.md create mode 100644 SwiftWin32/TableViewCell_CellStyle.md create mode 100644 SwiftWin32/TableViewCell_EditingStyle.md create mode 100644 SwiftWin32/TableViewDataSource.md create mode 100644 SwiftWin32/TableViewDelegate.md create mode 100644 SwiftWin32/TableViewFocusUpdateContext.md create mode 100644 SwiftWin32/TableViewHeaderFooterView.md create mode 100644 SwiftWin32/TableView_Style.md create mode 100644 SwiftWin32/TapGestureRecognizer.md create mode 100644 SwiftWin32/TargetedPreview.md create mode 100644 SwiftWin32/TextAlignment.md create mode 100644 SwiftWin32/TextField.md create mode 100644 SwiftWin32/TextFieldDelegate.md create mode 100644 SwiftWin32/TextInputTraits.md create mode 100644 SwiftWin32/TextView.md create mode 100644 SwiftWin32/TimingCurveProvider.md create mode 100644 SwiftWin32/TimingCurveType.md create mode 100644 SwiftWin32/Touch.md create mode 100644 SwiftWin32/Touch_Phase.md create mode 100644 SwiftWin32/Touch_TouchType.md create mode 100644 SwiftWin32/TraitCollection.md create mode 100644 SwiftWin32/TraitEnvironment.md create mode 100644 SwiftWin32/TraitEnvironmentLayoutDirection.md create mode 100644 SwiftWin32/Transform3D.md create mode 100644 SwiftWin32/TransitionContextViewControllerKey.md create mode 100644 SwiftWin32/TransitionContextViewKey.md create mode 100644 SwiftWin32/UserInterfaceActiveAppearance.md create mode 100644 SwiftWin32/UserInterfaceIdiom.md create mode 100644 SwiftWin32/UserInterfaceLevel.md create mode 100644 SwiftWin32/UserInterfaceSizeClass.md create mode 100644 SwiftWin32/UserInterfaceStyle.md create mode 100644 SwiftWin32/Vector.md create mode 100644 SwiftWin32/View.md create mode 100644 SwiftWin32/ViewAnimating.md create mode 100644 SwiftWin32/ViewAnimatingPosition.md create mode 100644 SwiftWin32/ViewAnimatingState.md create mode 100644 SwiftWin32/ViewConfigurationState.md create mode 100644 SwiftWin32/ViewController.md create mode 100644 SwiftWin32/ViewControllerAnimatedTransitioning.md create mode 100644 SwiftWin32/ViewControllerContextTransitioning.md create mode 100644 SwiftWin32/ViewControllerInteractiveTransitioning.md create mode 100644 SwiftWin32/ViewControllerTransitionCoordinator.md create mode 100644 SwiftWin32/ViewControllerTransitionCoordinatorContext.md create mode 100644 SwiftWin32/ViewControllerTransitioningDelegate.md create mode 100644 SwiftWin32/ViewImplicitlyAnimating.md create mode 100644 SwiftWin32/View_AnimationCurve.md create mode 100644 SwiftWin32/View_AnimationOptions.md create mode 100644 SwiftWin32/View_AutoresizingMask.md create mode 100644 SwiftWin32/View_ContentMode.md create mode 100644 SwiftWin32/View_TintAdjustmentMode.md create mode 100644 SwiftWin32/VisualEffect.md create mode 100644 SwiftWin32/Window.md create mode 100644 SwiftWin32/WindowScene.md create mode 100644 SwiftWin32/WindowSceneDelegate.md create mode 100644 SwiftWin32/Window_Level.md create mode 100644 SwiftWin32/_Footer.md create mode 100644 SwiftWin32/_Sidebar.md create mode 100644 SwiftWin32/_TriviallyConstructible.md create mode 100644 SwiftWin32/_Win32WindowText.md create mode 100644 SwiftWin32/index.md create mode 100644 SwiftWin32UI/AnyView.md create mode 100644 SwiftWin32UI/App.md create mode 100644 SwiftWin32UI/EmptyView.md create mode 100644 SwiftWin32UI/EquatableView.md create mode 100644 SwiftWin32UI/Group.md create mode 100644 SwiftWin32UI/Label.md create mode 100644 SwiftWin32UI/Never.md create mode 100644 SwiftWin32UI/Scene.md create mode 100644 SwiftWin32UI/SceneBuilder.md create mode 100644 SwiftWin32UI/SwiftWin32_Label.md create mode 100644 SwiftWin32UI/UIApplicationDelegateAdaptor.md create mode 100644 SwiftWin32UI/View.md create mode 100644 SwiftWin32UI/ViewBuilder.md create mode 100644 SwiftWin32UI/WindowGroup.md create mode 100644 SwiftWin32UI/_Footer.md create mode 100644 SwiftWin32UI/_Sidebar.md create mode 100644 SwiftWin32UI/index.md create mode 100644 _config.yml create mode 100644 index.md create mode 100644 media/images/screenshot.png diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 00000000..433e97d6 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,4 @@ +*.html text eol=lf +*.md text eol=lf +*.yml text eol=lf +Gemfile text eol=lf diff --git a/.gitignore b/.gitignore new file mode 100644 index 00000000..ba584468 --- /dev/null +++ b/.gitignore @@ -0,0 +1,5 @@ +_site +.sass-cache +.jekyll-cache +.jeykll-metadata +vendor diff --git a/404.html b/404.html new file mode 100644 index 00000000..086a5c9e --- /dev/null +++ b/404.html @@ -0,0 +1,25 @@ +--- +permalink: /404.html +layout: default +--- + + + +
+

404

+ +

Page not found :(

+

The requested page could not be found.

+
diff --git a/CoreAnimation/index.md b/CoreAnimation/index.md new file mode 100644 index 00000000..dbd8b87d --- /dev/null +++ b/CoreAnimation/index.md @@ -0,0 +1,43 @@ +--- +layout: default +title: CoreAnimation +has_children: true +--- +# Transform3D + +The standard transform matrix. + +``` swift +public struct Transform3D +``` + +## Initializers + +### `init()` + +``` swift +public init() +``` + +### `init(m11:m12:m13:m14:m21:m22:m23:m24:m31:m32:m33:m34:m41:m42:m43:m44:)` + +``` swift +public init(m11: Double, m12: Double, m13: Double, m14: Double, + m21: Double, m22: Double, m23: Double, m24: Double, + m31: Double, m32: Double, m33: Double, m34: Double, + m41: Double, m42: Double, m43: Double, m44: Double) +``` + +## Properties + +### `identity` + +The identity transform. +\[1, 0, 0, 0\] +\[0, 1, 0, 0\] +\[0, 0, 1, 0\] +\[0, 0, 0, 1\] + +``` swift +public static var identity: Transform3D +``` diff --git a/CoreGraphics/AffineTransform.md b/CoreGraphics/AffineTransform.md new file mode 100644 index 00000000..18ff0a6e --- /dev/null +++ b/CoreGraphics/AffineTransform.md @@ -0,0 +1,141 @@ +--- +layout: default +title: AffineTransform +parent: CoreGraphics +--- +# AffineTransform + +An affine transformation matrix for use in drawing 2D graphics. + +``` swift +public struct AffineTransform +``` + +## Initializers + +### `init()` + +``` swift +public init() +``` + +### `init(a:b:c:d:tx:ty:)` + +``` swift +public init( a: Double, b: Double, + c: Double, d: Double, + tx: Double, ty: Double) +``` + +### `init(rotationAngle:)` + +Returns an affine transformation matrix constructed from a rotation value +you provide. + +``` swift +public init(rotationAngle radians: Double) +``` + +### `init(scaleX:y:)` + +Returns an affine transformation matrix constructed from scaling values +you provide. + +``` swift +public init(scaleX sx: Double, y sy: Double) +``` + +### `init(translationX:y:)` + +Returns an affine transformation matrix constructed from translation +values you provide. + +``` swift +public init(translationX tx: Double, y ty: Double) +``` + +## Properties + +### `identity` + +The identity transform. + +``` swift +public static var identity: AffineTransform +``` + +### `a` + +The entry at position \[1,1\] in the matrix. + +``` swift +public var a: Double +``` + +### `b` + +The entry at position \[1,2\] in the matrix. + +``` swift +public var b: Double +``` + +### `c` + +The entry at position \[2,1\] in the matrix. + +``` swift +public var c: Double +``` + +### `d` + +The entry at position \[2,2\] in the matrix. + +``` swift +public var d: Double +``` + +### `tx` + +The entry at position \[3,1\] in the matrix. + +``` swift +public var tx: Double +``` + +### `ty` + +The entry at position \[3,2\] in the matrix. + +``` swift +public var ty: Double +``` + +### `isIdentity` + +Checks whether an affine transform is the identity transform. + +``` swift +public var isIdentity: Bool +``` + +## Methods + +### `concatenating(_:)` + +Returns an affine transformation matrix constructed by combining two +existing affine transforms. + +``` swift +public func concatenating(_ transform: AffineTransform) -> AffineTransform +``` + +### `inverted()` + +Returns an affine transformation matrix constructed by inverting an +existing affine transform. + +``` swift +public func inverted() -> AffineTransform +``` diff --git a/CoreGraphics/Point.md b/CoreGraphics/Point.md new file mode 100644 index 00000000..9863c62f --- /dev/null +++ b/CoreGraphics/Point.md @@ -0,0 +1,85 @@ +--- +layout: default +title: Point +parent: CoreGraphics +--- +# Point + +A structure that contains a point in a two-dimensional coordinate system. + +``` swift +public struct Point +``` + +## Inheritance + +`CustomDebugStringConvertible` + +## Initializers + +### `init(x:y:)` + +Creates a point with coordinates specified as floating-point values. + +``` swift +public init(x: Double, y: Double) +``` + +### `init(x:y:)` + +Creates a point with coordinates specified as integer values. + +``` swift +public init(x: Int, y: Int) +``` + +### `init()` + +Creates a point with location (0,0). + +``` swift +public init() +``` + +## Properties + +### `zero` + +The point with location (0,0). + +``` swift +public static var zero: Point +``` + +### `x` + +The x-coordinate of the point. + +``` swift +public var x: Double +``` + +### `y` + +The y-coordinate of the point. + +``` swift +public var y: Double +``` + +### `debugDescription` + +``` swift +public var debugDescription: String +``` + +## Methods + +### `applying(_:)` + +Returns the point resulting from an affine transformation of an existing +point. + +``` swift +public func applying(_ transform: AffineTransform) -> Point +``` diff --git a/CoreGraphics/Rect.md b/CoreGraphics/Rect.md new file mode 100644 index 00000000..0d55a921 --- /dev/null +++ b/CoreGraphics/Rect.md @@ -0,0 +1,282 @@ +--- +layout: default +title: Rect +parent: CoreGraphics +--- +# Rect + +A structure that contains the location and dimensions of a rectangle. + +``` swift +public struct Rect +``` + +## Inheritance + +`CustomDebugStringConvertible`, `Equatable` + +## Initializers + +### `init(origin:size:)` + +Creates a rectangle with the specified origin and size. + +``` swift +public init(origin: Point, size: Size) +``` + +### `init(x:y:width:height:)` + +Creates a rectangle with coordinates and dimensions specified as +floating-point values. + +``` swift +public init(x: Double, y: Double, width: Double, height: Double) +``` + +### `init(x:y:width:height:)` + +Creates a rectangle with coordinates and dimensions specified as integer +values. + +``` swift +public init(x: Int, y: Int, width: Int, height: Int) +``` + +### `init()` + +Creates a rectangle with origin (0,0) and size (0,0). + +``` swift +public init() +``` + +## Properties + +### `infinite` + +A rectangle that has infinite extent. + +``` swift +public static var infinite: Rect +``` + +### `null` + +The null rectangle, representing an invalid value. + +``` swift +public static var null: Rect +``` + +### `zero` + +The rectangle whose origin and size are both zero. + +``` swift +public static var zero: Rect +``` + +### `origin` + +A point that specifies the coordinates of the rectangle’s origin. + +``` swift +public var origin: Point +``` + +### `size` + +A size that specifies the height and width of the rectangle. + +``` swift +public var size: Size +``` + +### `height` + +Returns the height of a rectangle. + +``` swift +public var height: Double +``` + +### `width` + +Returns the width of a rectangle. + +``` swift +public var width: Double +``` + +### `minX` + +Returns the smallest value for the x-coordinate of the rectangle. + +``` swift +public var minX: Double +``` + +### `midX` + +Returns the x-coordinate that establishes the center of a rectangle. + +``` swift +public var midX: Double +``` + +### `maxX` + +Returns the largest value of the x-coordinate for the rectangle. + +``` swift +public var maxX: Double +``` + +### `minY` + +Returns the smallest value for the y-coordinate of the rectangle. + +``` swift +public var minY: Double +``` + +### `midY` + +Returns the y-coordinate that establishes the center of the rectangle. + +``` swift +public var midY: Double +``` + +### `maxY` + +Returns the largest value for the y-coordinate of the rectangle. + +``` swift +public var maxY: Double +``` + +### `standardized` + +Returns a rectangle with a positive width and height. + +``` swift +public var standardized: Rect +``` + +### `integral` + +Returns the smallest rectangle that results from converting the source +rectangle values to integers. + +``` swift +public var integral: Rect +``` + +### `isEmpty` + +Returns whether a rectangle has zero width or height, or is a null +rectangle. + +``` swift +public var isEmpty: Bool +``` + +### `isInfinite` + +Returns whether a rectangle is infinite. + +``` swift +public var isInfinite: Bool +``` + +### `isNull` + +Returns whether the rectangle is equal to the null rectangle. + +``` swift +public var isNull: Bool +``` + +### `debugDescription` + +``` swift +public var debugDescription: String +``` + +## Methods + +### `applying(_:)` + +Applies an affine transform to a rectangle. + +``` swift +public func applying(_ transform: AffineTransform) -> Rect +``` + +### `insetBy(dx:dy:)` + +Returns a rectangle that is smaller or larger than the source rectangle, +with the same center point. + +``` swift +public func insetBy(dx: Double, dy: Double) -> Rect +``` + +### `offsetBy(dx:dy:)` + +Returns a rectangle with an origin that is offset from that of the source +rectangle. + +``` swift +public func offsetBy(dx: Double, dy: Double) -> Rect +``` + +### `union(_:)` + +Returns the smallest rectangle that contains the two source rectangles. + +``` swift +public func union(_ rect: Rect) -> Rect +``` + +### `intersection(_:)` + +Returns the intersection of two rectangles. + +``` swift +public func intersection(_ rect: Rect) -> Rect +``` + +### `intersects(_:)` + +Returns whether two rectangles intersect. + +``` swift +public func intersects(_ rect: Rect) -> Bool +``` + +### `contains(_:)` + +Returns whether a rectangle contains a specified point. + +``` swift +public func contains(_ point: Point) -> Bool +``` + +### `contains(_:)` + +Returns whether the first rectangle contains the second rectangle. + +``` swift +public func contains(_ rect2: Rect) -> Bool +``` + +## Operators + +### `==` + +``` swift +public static func == (lhs: Rect, rhs: Rect) -> Bool +``` diff --git a/CoreGraphics/Rect_Edge.md b/CoreGraphics/Rect_Edge.md new file mode 100644 index 00000000..f1c264e7 --- /dev/null +++ b/CoreGraphics/Rect_Edge.md @@ -0,0 +1,55 @@ +--- +layout: default +title: Rect.Edge +parent: CoreGraphics +--- +# Rect.Edge + +Coordinates that establish the edges of a rectangle. + +``` swift +@frozen + public enum Edge: UInt32 +``` + +## Inheritance + +`UInt32` + +## Enumeration Cases + +### `minXEdge` + +The minimum value for the x-coordinate of the rectangle. In the default +coordinate space, this is the left edge of the rectangle. + +``` swift +case minXEdge +``` + +### `minYEdge` + +The minimum value for the y-coordinate of the rectangle. In the default +coordinate space, this is the top edge of the rectangle. + +``` swift +case minYEdge +``` + +### `maxXEdge` + +The maximum value for the x-coordinate of the rectangle. In the default +coordinate space, this is the right edge of the rectangle. + +``` swift +case maxXEdge +``` + +### `maxYEdge` + +The maximum value for the y-coordinate of the rectangle. In the default +coordinate space, this is the bottom edge of the rectangle. + +``` swift +case maxYEdge +``` diff --git a/CoreGraphics/Size.md b/CoreGraphics/Size.md new file mode 100644 index 00000000..5f7c5f9d --- /dev/null +++ b/CoreGraphics/Size.md @@ -0,0 +1,72 @@ +--- +layout: default +title: Size +parent: CoreGraphics +--- +# Size + +A structure that contains width and height values. + +``` swift +public struct Size +``` + +## Inheritance + +`CustomDebugStringConvertible` + +## Initializers + +### `init()` + +Creates a size with zero width and height. + +``` swift +public init() +``` + +### `init(width:height:)` + +Creates a size with dimensions specified as floating-point values. + +``` swift +public init(width: Double, height: Double) +``` + +### `init(width:height:)` + +``` swift +public init(width: Int, height: Int) +``` + +## Properties + +### `width` + +A width value. + +``` swift +public var width: Double +``` + +### `height` + +A height value. + +``` swift +public var height: Double +``` + +### `zero` + +The size whose width and height are both zero. + +``` swift +public static var zero: Size +``` + +### `debugDescription` + +``` swift +public var debugDescription: String +``` diff --git a/CoreGraphics/Vector.md b/CoreGraphics/Vector.md new file mode 100644 index 00000000..b47cc934 --- /dev/null +++ b/CoreGraphics/Vector.md @@ -0,0 +1,82 @@ +--- +layout: default +title: Vector +parent: CoreGraphics +--- +# Vector + +A structure that contains a two-dimensional vector. + +``` swift +public struct Vector +``` + +## Inheritance + +`CustomDebugStringConvertible` + +## Initializers + +### `init()` + +Creates a vector whose components are both zero. + +``` swift +public init() +``` + +### `init(dx:dy:)` + +Creates a vector with components specified as floating-point values. + +``` swift +public init(dx: Double, dy: Double) +``` + +### `init(dx:dy:)` + +Creates a vector with components specified as floating-point values. + +``` swift +public init(dx: Float, dy: Float) +``` + +### `init(dx:dy:)` + +Creates a vector with components specified as integer values. + +``` swift +public init(dx: Int, dy: Int) +``` + +## Properties + +### `zero` + +The vector whose components are both zero. + +``` swift +public static var zero: Vector +``` + +### `dx` + +The x component of the vector. + +``` swift +public var dx: Double +``` + +### `dy` + +The y component of the vector. + +``` swift +public var dy: Double +``` + +### `debugDescription` + +``` swift +public var debugDescription: String +``` diff --git a/CoreGraphics/_Footer.md b/CoreGraphics/_Footer.md new file mode 100644 index 00000000..aaacc1f1 --- /dev/null +++ b/CoreGraphics/_Footer.md @@ -0,0 +1 @@ +Generated at 2022-06-25T22:36:04+0000 using [swift-doc](https://github.com/SwiftDocOrg/swift-doc) 1.0.0-beta.6. diff --git a/CoreGraphics/_Sidebar.md b/CoreGraphics/_Sidebar.md new file mode 100644 index 00000000..25775635 --- /dev/null +++ b/CoreGraphics/_Sidebar.md @@ -0,0 +1,11 @@ +
+Types + + - [AffineTransform](https://compnerd.github.io/swift-win32/CoreGraphics/AffineTransform) + - [Point](https://compnerd.github.io/swift-win32/CoreGraphics/Point) + - [Rect](https://compnerd.github.io/swift-win32/CoreGraphics/Rect) + - [Rect.Edge](https://compnerd.github.io/swift-win32/CoreGraphics/Rect.Edge) + - [Size](https://compnerd.github.io/swift-win32/CoreGraphics/Size) + - [Vector](https://compnerd.github.io/swift-win32/CoreGraphics/Vector) + +
diff --git a/CoreGraphics/index.md b/CoreGraphics/index.md new file mode 100644 index 00000000..a090259d --- /dev/null +++ b/CoreGraphics/index.md @@ -0,0 +1,19 @@ +--- +layout: default +title: CoreGraphics +has_children: true +--- +# Types + + - [Rect.Edge](https://compnerd.github.io/swift-win32/CoreGraphics/Rect_Edge): + Coordinates that establish the edges of a rectangle. + - [AffineTransform](https://compnerd.github.io/swift-win32/CoreGraphics/AffineTransform): + An affine transformation matrix for use in drawing 2D graphics. + - [Point](https://compnerd.github.io/swift-win32/CoreGraphics/Point): + A structure that contains a point in a two-dimensional coordinate system. + - [Rect](https://compnerd.github.io/swift-win32/CoreGraphics/Rect): + A structure that contains the location and dimensions of a rectangle. + - [Size](https://compnerd.github.io/swift-win32/CoreGraphics/Size): + A structure that contains width and height values. + - [Vector](https://compnerd.github.io/swift-win32/CoreGraphics/Vector): + A structure that contains a two-dimensional vector. diff --git a/Gemfile b/Gemfile new file mode 100644 index 00000000..20b1b828 --- /dev/null +++ b/Gemfile @@ -0,0 +1,17 @@ +source "https://rubygems.org" + +gem "github-pages", group: :jekyll_plugins +gem "just-the-docs" +group :jekyll_plugins do + gem "jekyll-feed", "~> 0.12" +end + +# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem +# and associated library. +platforms :mingw, :x64_mingw, :mswin, :jruby do + gem "tzinfo", "~> 1.2" + gem "tzinfo-data" +end + +# Performance-booster for watching directories on Windows +gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin] diff --git a/SwiftWin32/AccessibilityContrast.md b/SwiftWin32/AccessibilityContrast.md new file mode 100644 index 00000000..2c8a481c --- /dev/null +++ b/SwiftWin32/AccessibilityContrast.md @@ -0,0 +1,42 @@ +--- +layout: default +title: AccessibilityContrast +parent: SwiftWin32 +--- +# AccessibilityContrast + +Constants that indicate the accessibility contrast setting. + +``` swift +public enum AccessibilityContrast: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `unspecified` + +An unspecified contrast. + +``` swift +case unspecified = -1 +``` + +### `normal` + +A normal contrast level. + +``` swift +case normal +``` + +### `high` + +A high contrast level. + +``` swift +case high +``` diff --git a/SwiftWin32/Action.md b/SwiftWin32/Action.md new file mode 100644 index 00000000..bb322f9c --- /dev/null +++ b/SwiftWin32/Action.md @@ -0,0 +1,99 @@ +--- +layout: default +title: Action +parent: SwiftWin32 +--- +# Action + +A menu element that performs its action in a closure. + +``` swift +open class Action: MenuElement +``` + +## Inheritance + +[`MenuElement`](https://compnerd.github.io/swift-win32/SwiftWin32/MenuElement) + +## Nested Type Aliases + +### `ActionHandler` + +A type that defines the closure for an action handler. + +``` swift +public typealias ActionHandler = (Action) -> Void +``` + +## Initializers + +### `init(title:image:identifier:discoverabilityTitle:attributes:state:handler:)` + +Creates an action. + +``` swift +public /*convenience*/ init(title: String = "", image: Image? = nil, + identifier: Action.Identifier? = nil, + discoverabilityTitle: String? = nil, + attributes: MenuElement.Attributes = [], + state: MenuElement.State = .off, + handler: @escaping ActionHandler) +``` + +## Properties + +### `title` + +The action's title. + +``` swift +open override var title: String +``` + +### `image` + +The action's image. + +``` swift +open override var image: Image? +``` + +### `identifier` + +The unique identifier for the action. + +``` swift +open private(set) var identifier: Action.Identifier +``` + +### `discoverabilityTitle` + +An elaborated title that explains the purpose of the action. + +``` swift +open var discoverabilityTitle: String? +``` + +### `attributes` + +The attributes indicating the style of the action. + +``` swift +open var attributes: MenuElement.Attributes +``` + +### `state` + +The state of the action. + +``` swift +open var state: MenuElement.State +``` + +### `sender` + +The object responsible for the action handler. + +``` swift +open internal(set) var sender: Any? +``` diff --git a/SwiftWin32/Action_Identifier.md b/SwiftWin32/Action_Identifier.md new file mode 100644 index 00000000..c3ed6047 --- /dev/null +++ b/SwiftWin32/Action_Identifier.md @@ -0,0 +1,46 @@ +--- +layout: default +title: Action.Identifier +parent: SwiftWin32 +--- +# Action.Identifier + +A type that represents an action identifier. + +``` swift +public struct Identifier: Equatable, Hashable, RawRepresentable +``` + +## Inheritance + +`Equatable`, `Hashable`, `RawRepresentable` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = String +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +### `init(_:)` + +``` swift +public init(_ rawValue: String) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` diff --git a/SwiftWin32/AdaptivePresentationControllerDelegate.md b/SwiftWin32/AdaptivePresentationControllerDelegate.md new file mode 100644 index 00000000..13618ae0 --- /dev/null +++ b/SwiftWin32/AdaptivePresentationControllerDelegate.md @@ -0,0 +1,235 @@ +--- +layout: default +title: AdaptivePresentationControllerDelegate +parent: SwiftWin32 +--- +# AdaptivePresentationControllerDelegate + +A set of methods that, in conjunction with a presentation controller, +determine how to respond to trait changes in your application. + +``` swift +public protocol AdaptivePresentationControllerDelegate: AnyObject +``` + +## Inheritance + +`AnyObject` + +## Default Implementations + +### `adaptivePresentationStyle(for:traitCollection:)` + +``` swift +public func adaptivePresentationStyle(for controller: PresentationController, + traitCollection: TraitCollection) + -> ModalPresentationStyle +``` + +### `adaptivePresentationStyle(for:)` + +``` swift +public func adaptivePresentationStyle(for controller: PresentationController) + -> ModalPresentationStyle +``` + +### `presentationController(controller:viewControllerForAdaptivePresentationStyle:)` + +``` swift +public func presentationController(controller: PresentationController, + viewControllerForAdaptivePresentationStyle style: ModalPresentationStyle) + -> ViewController? +``` + +### `presentationController(_:willPresentWithAdaptiveStyle:transitionCoordinator:)` + +``` swift +public func presentationController(_ controller: PresentationController, + willPresentWithAdaptiveStyle style: ModalPresentationStyle, + transitionCoordinator: ViewControllerTransitionCoordinator?) +``` + +### `presentationControllerDidAttemptToDismiss(_:)` + +``` swift +public func presentationControllerDidAttemptToDismiss(_ presentationController: PresentationController) +``` + +### `presentationControllerShouldDismiss(_:)` + +``` swift +public func presentationControllerShouldDismiss(_ presentationController: PresentationController) -> Bool +``` + +### `presentationControllerDidDismiss(_:)` + +``` swift +public func presentationControllerDidDismiss(_ presentationController: PresentationController) +``` + +### `presentationControllerWillDismiss(_:)` + +``` swift +public func presentationControllerWillDismiss(_ presentationController: PresentationController) +``` + +### `presentationController(_:prepare:)` + +``` swift +public func presentationController(_ presentationController: PresentationController, + prepare adaptivePresentationController: PresentationController) +``` + +## Requirements + +### adaptivePresentationStyle(for:​traitCollection:​) + +Asks the delegate for the presentation style to use when the specified set +of traits are active. + +``` swift +func adaptivePresentationStyle(for controller: PresentationController, + traitCollection: TraitCollection) + -> ModalPresentationStyle +``` + +The presentation controller calls this method when the traits of the +current environment are about to change. Your implementation of this +method can return the preferred presentation style to use for the +specified traits. If you do not return one of the allowed styles, the +presentation controller uses its preferred default style. + +If you do not implement this method in your delegate, the framework calls +the `adaptivePresentationStyle(for:)` method instead. + +### adaptivePresentationStyle(for:​) + +Asks the delegate for the new presentation style to use. + +``` swift +func adaptivePresentationStyle(for controller: PresentationController) + -> ModalPresentationStyle +``` + +Use the `adaptivePresentationStyle(for:traitCollection:)` method to handle +all trait changes instead of this method. If you do not implement that +method, you can use this method to change the presentation style when +transitioning to a horizontally compact environment. + +If you do not implement this method or if you return an invalid style, the +current presentation controller returns its preferred default style. + +### presentationController(\_:​viewControllerForAdaptivePresentationStyle:​) + +Asks the delegate for the view controller to display when adapting to the +specified presentation style. + +``` swift +func presentationController(_ controller: PresentationController, + viewControllerForAdaptivePresentationStyle style: ModalPresentationStyle) + -> ViewController? +``` + +When a size class change causes a change to the underlying presentation +style, the presentation controller calls this method to ask for the view +controller to display in that new style. This method is your opportunity +to replace the current view controller with one that is better suited for +the new presentation style. For example, you might use this method to +insert a navigation controller into your view hierarchy to facilitate +pushing new view controllers more easily in the compact environment. In +that instance, you would return a navigation controller whose root view +controller is the currently presented view controller. You could also +return an entirely different view controller if you prefer. + +If you do not implement this method or your implementation returns `nil`, +the presentation controller uses its existing presented view controller. + +### presentationController(\_:​willPresentWithAdaptiveStyle:​transitionCoordinator:​) + +Notifies the delegate that an adaptivity-related transition is about to +occur. + +``` swift +func presentationController(_ presentationController: PresentationController, + willPresentWithAdaptiveStyle style: ModalPresentationStyle, + transitionCoordinator: ViewControllerTransitionCoordinator?) +``` + +When a size class change occurs, the framework calls this method to let +you know how the presentation controller will adapt. Use this method to +make any additional changes. For example, you might use the transition +coordinator object to create additional animations for the transition. + +### presentationControllerDidAttemptToDismiss(\_:​) + +Notifies the delegate that a user-initiated attempt to dismiss a view was +prevented. + +``` swift +func presentationControllerDidAttemptToDismiss(_ presentationController: PresentationController) +``` + +The framework supports refusing to dismiss a presentation when the +`presentationController.isModalInPresentation` returns `true` or +`presentationControllerShouldDismiss(_:)` returns `false`. + +Use this method to inform the user why the presentation can't be +dismissed, for example, by presenting an instance of `AlertController`. + +### presentationControllerShouldDismiss(\_:​) + +Asks the delegate for permission to dismiss the presentation. + +``` swift +func presentationControllerShouldDismiss(_ presentationController: PresentationController) + -> Bool +``` + +The system may call this method at any time. This method isn't guaranteed +to be followed by a call to `presentationControllerWillDismiss(_:)` or +`presentationControllerDidDismiss(_:)`. Make sure that your implementation +of this method returns quickly. + +### presentationControllerDidDismiss(\_:​) + +Notifies the delegate after a presentation is dismissed. + +``` swift +func presentationControllerDidDismiss(_ presentationController: PresentationController) +``` + +This method is not called if the presentation is dismissed +programmatically. + +### presentationControllerWillDismiss(\_:​) + +Notifies the delegate before a presentation is dismissed. + +``` swift +func presentationControllerWillDismiss(_ presentationController: PresentationController) +``` + +You can use this method to set up animations or interaction notifications +with the `presentationController`'s `transitionCoordinator`. + +This method is not called if the presentation is dismissed +programmatically. + +### presentationController(\_:​prepare:​) + +Provides an opportunity to configure the adaptive presentation controller +after an adaptivity change. + +``` swift +func presentationController(_ presentationController: PresentationController, + prepare adaptivePresentationController: PresentationController) +``` + +The system calls this method during adaptation so the delegate can +configure properties of the adaptive presentation controller before it +presents. + +For example, the system automatically adapts a view controller that +presents as a popover in standard size classes to a sheet in compact size +classes. You can implement this method to customize the sheet's +properties before it presents. diff --git a/SwiftWin32/AffineTransform.md b/SwiftWin32/AffineTransform.md new file mode 100644 index 00000000..204953b3 --- /dev/null +++ b/SwiftWin32/AffineTransform.md @@ -0,0 +1,141 @@ +--- +layout: default +title: AffineTransform +parent: SwiftWin32 +--- +# AffineTransform + +An affine transformation matrix for use in drawing 2D graphics. + +``` swift +public struct AffineTransform +``` + +## Initializers + +### `init()` + +``` swift +public init() +``` + +### `init(a:b:c:d:tx:ty:)` + +``` swift +public init( a: Double, b: Double, + c: Double, d: Double, + tx: Double, ty: Double) +``` + +### `init(rotationAngle:)` + +Returns an affine transformation matrix constructed from a rotation value +you provide. + +``` swift +public init(rotationAngle radians: Double) +``` + +### `init(scaleX:y:)` + +Returns an affine transformation matrix constructed from scaling values +you provide. + +``` swift +public init(scaleX sx: Double, y sy: Double) +``` + +### `init(translationX:y:)` + +Returns an affine transformation matrix constructed from translation +values you provide. + +``` swift +public init(translationX tx: Double, y ty: Double) +``` + +## Properties + +### `identity` + +The identity transform. + +``` swift +public static var identity: AffineTransform +``` + +### `a` + +The entry at position \[1,1\] in the matrix. + +``` swift +public var a: Double +``` + +### `b` + +The entry at position \[1,2\] in the matrix. + +``` swift +public var b: Double +``` + +### `c` + +The entry at position \[2,1\] in the matrix. + +``` swift +public var c: Double +``` + +### `d` + +The entry at position \[2,2\] in the matrix. + +``` swift +public var d: Double +``` + +### `tx` + +The entry at position \[3,1\] in the matrix. + +``` swift +public var tx: Double +``` + +### `ty` + +The entry at position \[3,2\] in the matrix. + +``` swift +public var ty: Double +``` + +### `isIdentity` + +Checks whether an affine transform is the identity transform. + +``` swift +public var isIdentity: Bool +``` + +## Methods + +### `concatenating(_:)` + +Returns an affine transformation matrix constructed by combining two +existing affine transforms. + +``` swift +public func concatenating(_ transform: AffineTransform) -> AffineTransform +``` + +### `inverted()` + +Returns an affine transformation matrix constructed by inverting an +existing affine transform. + +``` swift +public func inverted() -> AffineTransform +``` diff --git a/SwiftWin32/AlertAction.md b/SwiftWin32/AlertAction.md new file mode 100644 index 00000000..4b65666d --- /dev/null +++ b/SwiftWin32/AlertAction.md @@ -0,0 +1,49 @@ +--- +layout: default +title: AlertAction +parent: SwiftWin32 +--- +# AlertAction + +An action that can be taken when the user taps a button in an alert. + +``` swift +public class AlertAction +``` + +## Initializers + +### `init(title:style:handler:)` + +Create and return an action with the specified title and behavior. + +``` swift +public init(title: String?, style: AlertAction.Style, + handler: ((AlertAction) -> Void)? = nil) +``` + +## Properties + +### `title` + +The title of the action’s button. + +``` swift +public let title: String? +``` + +### `style` + +The style that is applied to the action’s button. + +``` swift +public let style: AlertAction.Style +``` + +### `isEnabled` + +A Boolean value indicating whether the action is currently enabled. + +``` swift +public var isEnabled: Bool +``` diff --git a/SwiftWin32/AlertAction_Style.md b/SwiftWin32/AlertAction_Style.md new file mode 100644 index 00000000..d9d1dc7e --- /dev/null +++ b/SwiftWin32/AlertAction_Style.md @@ -0,0 +1,43 @@ +--- +layout: default +title: AlertAction.Style +parent: SwiftWin32 +--- +# AlertAction.Style + +Styles to apply to action buttons in an alert. + +``` swift +public enum Style: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `` `default` `` + +Apply the default style to the action’s button. + +``` swift +case `default` +``` + +### `cancel` + +Apply a style that indicates the action cancels the operation and leaves +things unchanged. + +``` swift +case cancel +``` + +### `destructive` + +Apply a style that indicates the action might change or delete data. + +``` swift +case destructive +``` diff --git a/SwiftWin32/AlertController.md b/SwiftWin32/AlertController.md new file mode 100644 index 00000000..fd49ead1 --- /dev/null +++ b/SwiftWin32/AlertController.md @@ -0,0 +1,89 @@ +--- +layout: default +title: AlertController +parent: SwiftWin32 +--- +# AlertController + +An object that displays an alert message to the user. + +``` swift +public class AlertController: ViewController +``` + +## Inheritance + +[`ViewController`](https://compnerd.github.io/swift-win32/SwiftWin32/ViewController) + +## Initializers + +### `init(title:message:preferredStyle:)` + +Creates and returns a view controller for displaying an alert to the user. + +``` swift +public init(title: String?, message: String?, + preferredStyle: AlertController.Style) +``` + +## Properties + +### `message` + +Descriptive text that provides more details about the reason for the +alert. + +``` swift +public var message: String? +``` + +### `preferredStyle` + +The style of the alert controller. + +``` swift +public let preferredStyle: AlertController.Style +``` + +### `actions` + +The actions that the user can take in response to the alert or action +sheet. + +``` swift +public private(set) var actions: [AlertAction] = [] +``` + +### `preferredAction` + +The preferred action for the user to take from an alert. + +``` swift +public var preferredAction: AlertAction? +``` + +### `textFields` + +The array of text fields displayed by the alert. + +``` swift +public private(set) var textFields: [TextField]? +``` + +## Methods + +### `addAction(_:)` + +Attaches an action object to the alert or action sheet. + +``` swift +public func addAction(_ action: AlertAction) +``` + +### `addTextField(configurationHandler:)` + +Adds a text field to an alert. + +``` swift +public func addTextField(configurationHandler: ((TextField) -> Void)? = nil) +``` diff --git a/SwiftWin32/AlertController_Style.md b/SwiftWin32/AlertController_Style.md new file mode 100644 index 00000000..95f02210 --- /dev/null +++ b/SwiftWin32/AlertController_Style.md @@ -0,0 +1,35 @@ +--- +layout: default +title: AlertController.Style +parent: SwiftWin32 +--- +# AlertController.Style + +Constants indicating the type of alert to display. + +``` swift +public enum Style: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `actionSheet` + +An action sheet displayed in the context of the view controller that +presented it. + +``` swift +case actionSheet +``` + +### `alert` + +An alert displayed modally for the app. + +``` swift +case alert +``` diff --git a/SwiftWin32/Appearance.md b/SwiftWin32/Appearance.md new file mode 100644 index 00000000..1fae37cf --- /dev/null +++ b/SwiftWin32/Appearance.md @@ -0,0 +1,53 @@ +--- +layout: default +title: Appearance +parent: SwiftWin32 +--- +# Appearance + +A collection of methods that gives you access to the appearance proxy for a +class. + +``` swift +public protocol Appearance +``` + +## Requirements + +### appearance() + +Returns the appearance proxy for the receiver. + +``` swift +static func appearance() -> Self +``` + +### appearance(for:​) + +Returns the appearance proxy for the receiver that has the passed trait +collection. + +``` swift +static func appearance(for trait: TraitCollection) -> Self +``` + +### appearance(whenContainedInInstancesOf:​) + +Returns the appearance proxy for the object when it is contained in the +hierarchy the specified classes describe. + +``` swift +static func appearance(whenContainedInInstancesOf containerTypes: [AppearanceContainer.Type]) + -> Self +``` + +### appearance(for:​whenContainedInInstancesOf:​) + +Returns the appearance proxy for the object when it is contained in the +hierarchy the specified classes describe and has the specified trait +collection. + +``` swift +static func appearance(for trait: TraitCollection, + whenContainedInInstancesOf containerTypes: [AppearanceContainer.Type]) -> Self +``` diff --git a/SwiftWin32/AppearanceContainer.md b/SwiftWin32/AppearanceContainer.md new file mode 100644 index 00000000..65de5380 --- /dev/null +++ b/SwiftWin32/AppearanceContainer.md @@ -0,0 +1,13 @@ +--- +layout: default +title: AppearanceContainer +parent: SwiftWin32 +--- +# AppearanceContainer + +A protocol that a class must adopt to allow appearance customization using +the `Appearance` API. + +``` swift +public protocol AppearanceContainer +``` diff --git a/SwiftWin32/Application.md b/SwiftWin32/Application.md new file mode 100644 index 00000000..24a8e7c0 --- /dev/null +++ b/SwiftWin32/Application.md @@ -0,0 +1,97 @@ +--- +layout: default +title: Application +parent: SwiftWin32 +--- +# Application + +The centralised point of control and coordination for running applications. + +``` swift +open class Application: Responder +``` + +## Inheritance + +[`Responder`](https://compnerd.github.io/swift-win32/SwiftWin32/Responder) + +## Initializers + +### `init()` + +``` swift +override public required init() +``` + +## Properties + +### `shared` + +Returns the singleton application instance. + +``` swift +public static var shared: Application +``` + +### `delegate` + +The delegate of the application object. + +``` swift +public var delegate: ApplicationDelegate? +``` + +### `state` + +The applications current state or that of its most active scene. + +``` swift +public internal(set) var state: Application.State +``` + +### `supportsMultipleScenes` + +A boolean indicating whether the application may display multiple scenes. + +``` swift +public var supportsMultipleScenes: Bool +``` + +### `connectedScenes` + +The application's currently connected scenes. + +``` swift +public internal(set) var connectedScenes: Set = [] +``` + +### `openSessions` + +The sessions whose scenes are either currently active or archived by the +system. + +``` swift +public internal(set) var openSessions: Set = [] +``` + +### `windows` + +The application’s visible and hidden windows. + +``` swift +public internal(set) var windows: [Window] +``` + +### `keyWindow` + +The application's key window. + +``` swift +public internal(set) var keyWindow: Window? +``` + +### `next` + +``` swift +override public var next: Responder? +``` diff --git a/SwiftWin32/ApplicationDelegate.md b/SwiftWin32/ApplicationDelegate.md new file mode 100644 index 00000000..964d6feb --- /dev/null +++ b/SwiftWin32/ApplicationDelegate.md @@ -0,0 +1,312 @@ +--- +layout: default +title: ApplicationDelegate +parent: SwiftWin32 +--- +# ApplicationDelegate + +A set of methods used to manage shared behaviours for the application. + +``` swift +public protocol ApplicationDelegate: AnyObject, _TriviallyConstructible +``` + +## Inheritance + +`AnyObject`, [`_TriviallyConstructible`](https://compnerd.github.io/swift-win32/SwiftWin32/_TriviallyConstructible) + +## Default Implementations + +### `application(_:willFinishLaunchingWithOptions:)` + +``` swift +public func application(_ application: Application, + willFinishLaunchingWithOptions options: [Application.LaunchOptionsKey:Any]?) + -> Bool +``` + +### `application(_:didFinishLaunchingWithOptions:)` + +``` swift +public func application(_ application: Application, + didFinishLaunchingWithOptions options: [Application.LaunchOptionsKey:Any]?) + -> Bool +``` + +### `didFinishLaunchingNotification` + +A notification that posts immediately after the app finishes launching. + +``` swift +public static var didFinishLaunchingNotification: NSNotification.Name +``` + +### `applicationDidBecomeActive(_:)` + +``` swift +public func applicationDidBecomeActive(_: Application) +``` + +### `applicationWillResignActive(_:)` + +``` swift +public func applicationWillResignActive(_: Application) +``` + +### `applicationDidEnterBackground(_:)` + +``` swift +public func applicationDidEnterBackground(_: Application) +``` + +### `applicationWillEnterForeground(_:)` + +``` swift +public func applicationWillEnterForeground(_: Application) +``` + +### `applicationWillTerminate(_:)` + +``` swift +public func applicationWillTerminate(_: Application) +``` + +### `didBecomeActiveNotification` + +A notification that posts when the app becomes active. + +``` swift +public static var didBecomeActiveNotification: NSNotification.Name +``` + +### `willResignActiveNotification` + +A notification that posts when the app is no longer active and loses +focus. + +``` swift +public static var willResignActiveNotification: NSNotification.Name +``` + +### `didEnterBackgroundNotification` + +A notification that posts when the app enters the background. + +``` swift +public static var didEnterBackgroundNotification: NSNotification.Name +``` + +### `willEnterForegroundNotification` + +A notification that posts shortly before an app leaves the background +state on its way to becoming the active app. + +``` swift +public static var willEnterForegroundNotification: NSNotification.Name +``` + +### `willTerminateNotification` + +A notification that posts when the app is about to terminate. + +``` swift +public static var willTerminateNotification: NSNotification.Name +``` + +### `applicationProtectedDataDidBecomeAvailable(_:)` + +``` swift +public func applicationProtectedDataDidBecomeAvailable(_ application: Application) +``` + +### `applicationProtectedDataWillBecomeUnavailable(_:)` + +``` swift +public func applicationProtectedDataWillBecomeUnavailable(_ application: Application) +``` + +### `applicationDidReceiveMemoryWarning(_:)` + +``` swift +public func applicationDidReceiveMemoryWarning(_ application: Application) +``` + +### `applicationSignificantTimeChange(_:)` + +``` swift +public func applicationSignificantTimeChange(_ application: Application) +``` + +### `protectedDataDidBecomeAvailableNotification` + +A notification that posts when the protected files become available for +your code to access. + +``` swift +public static var protectedDataDidBecomeAvailableNotification: NSNotification.Name +``` + +### `protectedDataWillBecomeUnavailableNotification` + +A notification that posts shortly before protected files are locked down +and become inaccessible. + +``` swift +public static var protectedDataWillBecomeUnavailableNotification: NSNotification.Name +``` + +### `didReceiveMemoryWarningNotification` + +A notification that posts when the app receives a warning from the +operating system about low memory availability. + +``` swift +public static var didReceiveMemoryWarningNotification: NSNotification.Name +``` + +### `significantTimeChangeNotification` + +A notification that posts when there is a significant change in time, for +example, change to a new day (midnight), carrier time update, and change +to or from daylight savings time. + +``` swift +public static var significantTimeChangeNotification: NSNotification.Name +``` + +### `application(_:configurationForConnecting:options:)` + +``` swift +public func application(_ application: Application, + configurationForConnecting connectingSceneSession: SceneSession, + options: Scene.ConnectionOptions) -> SceneConfiguration +``` + +### `application(_:didDiscardSceneSessions:)` + +``` swift +public func application(_ application: Application, + didDiscardSceneSessions sceneSessions: Set) +``` + +### `main()` + +``` swift +public static func main() +``` + +## Requirements + +### application(\_:​willFinishLaunchingWithOptions:​) + +Informs the delegate that the application launch process has begun. + +``` swift +func application(_ application: Application, + willFinishLaunchingWithOptions options: [Application.LaunchOptionsKey:Any]?) + -> Bool +``` + +### application(\_:​didFinishLaunchingWithOptions:​) + +Informs the delegate that the application launch process has ended and +the application is almost ready to run. + +``` swift +func application(_ application: Application, + didFinishLaunchingWithOptions options: [Application.LaunchOptionsKey:Any]?) + -> Bool +``` + +### applicationDidBecomeActive(\_:​) + +Informs the delegate that the application has become active. + +``` swift +func applicationDidBecomeActive(_ application: Application) +``` + +### applicationWillResignActive(\_:​) + +Informs the delegate that the application is about to become inactive. + +``` swift +func applicationWillResignActive(_ application: Application) +``` + +### applicationDidEnterBackground(\_:​) + +Informs the delegate that the application is now in the background. + +``` swift +func applicationDidEnterBackground(_ application: Application) +``` + +### applicationWillEnterForeground(\_:​) + +Informs the delegate that the application is about to enter the foreground. + +``` swift +func applicationWillEnterForeground(_ application: Application) +``` + +### applicationWillTerminate(\_:​) + +Informs the delegate that the application is about to terminate. + +``` swift +func applicationWillTerminate(_ application: Application) +``` + +### applicationProtectedDataDidBecomeAvailable(\_:​) + +Tells the delegate that protected files are available now. + +``` swift +func applicationProtectedDataDidBecomeAvailable(_ application: Application) +``` + +### applicationProtectedDataWillBecomeUnavailable(\_:​) + +Tells the delegate that the protected files are about to become +unavailable. + +``` swift +func applicationProtectedDataWillBecomeUnavailable(_ application: Application) +``` + +### applicationDidReceiveMemoryWarning(\_:​) + +Tells the delegate when the app receives a memory warning from the system. + +``` swift +func applicationDidReceiveMemoryWarning(_ application: Application) +``` + +### applicationSignificantTimeChange(\_:​) + +Tells the delegate when there is a significant change in the time. + +``` swift +func applicationSignificantTimeChange(_ application: Application) +``` + +### application(\_:​configurationForConnecting:​options:​) + +Returns the configuration data to use when creating a new scene. + +``` swift +func application(_ application: Application, + configurationForConnecting connectingSceneSession: SceneSession, + options: Scene.ConnectionOptions) -> SceneConfiguration +``` + +### application(\_:​didDiscardSceneSessions:​) + +Informs the delegate that the user closed one or more of the application's +scenes. + +``` swift +func application(_ application: Application, + didDiscardSceneSessions sceneSessions: Set) +``` diff --git a/SwiftWin32/ApplicationMain(________).md b/SwiftWin32/ApplicationMain(________).md new file mode 100644 index 00000000..111cc41c --- /dev/null +++ b/SwiftWin32/ApplicationMain(________).md @@ -0,0 +1,14 @@ +--- +layout: default +title: ApplicationMain(_.......) +parent: SwiftWin32 +--- +# ApplicationMain(\_:\_:\_:\_:) + +``` swift +@discardableResult +public func ApplicationMain(_ argc: Int32, + _ argv: UnsafeMutablePointer?>, + _ application: String?, + _ delegate: String?) -> Int32 +``` diff --git a/SwiftWin32/Application_LaunchOptionsKey.md b/SwiftWin32/Application_LaunchOptionsKey.md new file mode 100644 index 00000000..244b639f --- /dev/null +++ b/SwiftWin32/Application_LaunchOptionsKey.md @@ -0,0 +1,131 @@ +--- +layout: default +title: Application.LaunchOptionsKey +parent: SwiftWin32 +--- +# Application.LaunchOptionsKey + +Keys used to access values in the launch options dictionary passed to your +application at initialization time. + +``` swift +public struct LaunchOptionsKey: Equatable, Hashable, RawRepresentable +``` + +## Inheritance + +`Equatable`, `Hashable`, `RawRepresentable` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = String +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public var rawValue: RawValue +``` + +### `annotation` + +A key indicating that the URL passed to your application contains custom +annotation data from the source application. + +``` swift +public static var annotation: Application.LaunchOptionsKey +``` + +### `bluetoothCentrals` + +A key indicating that the application was relaunched to handle +bluetooth-related events. + +``` swift +public static var bluetoothCentrals: Application.LaunchOptionsKey +``` + +### `bluetoothPeripherals` + +A key indicating that the application should continue actions associated +with it's bluetooth peripheral objects. + +``` swift +public static var bluetoothPeripherals: Application.LaunchOptionsKey +``` + +### `location` + +A key indicating that the application was launched to handle an incoming +location event. + +``` swift +public static var location: Application.LaunchOptionsKey +``` + +### `remoteNotification` + +A key indicating that a remove notification is available for the +application to process. + +``` swift +public static var remoteNotification: Application.LaunchOptionsKey +``` + +### `shortcutItem` + +A key indicating that the application was launched in response to the user +selecting a quick action. + +``` swift +public static var shortcutItem: Application.LaunchOptionsKey +``` + +### `sourceApplication` + +A key indicating that another application rrequested the launch of your +application. + +``` swift +public static var sourceApplication: Application.LaunchOptionsKey +``` + +### `url` + +A key indicating that the application was launched so it could open the +specified URL. + +``` swift +public static var url: Application.LaunchOptionsKey +``` + +### `userActivityDictionary` + +A key indicating a dictionary associated with an activity that the user +wants to continue. + +``` swift +public static var userActivityDictionary: Application.LaunchOptionsKey +``` + +### `userActivityType` + +A key indicating the type of user activity that the user wants to +continue. + +``` swift +public static var userActivityType: Application.LaunchOptionsKey +``` diff --git a/SwiftWin32/Application_State.md b/SwiftWin32/Application_State.md new file mode 100644 index 00000000..9c18d3ef --- /dev/null +++ b/SwiftWin32/Application_State.md @@ -0,0 +1,43 @@ +--- +layout: default +title: Application.State +parent: SwiftWin32 +--- +# Application.State + +The running states of the application + +``` swift +public enum State: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `active` + +The application is running in the foreground and currently receiving +events. + +``` swift +case active +``` + +### `inactive` + +The application is running in the foreground but is not receiving events. + +``` swift +case inactive +``` + +### `background` + +The application is running in the background. + +``` swift +case background +``` diff --git a/SwiftWin32/Axis.md b/SwiftWin32/Axis.md new file mode 100644 index 00000000..4f0b047f --- /dev/null +++ b/SwiftWin32/Axis.md @@ -0,0 +1,58 @@ +--- +layout: default +title: Axis +parent: SwiftWin32 +--- +# Axis + +Defines a structure that specifies the layout axes. + +``` swift +public struct Axis: OptionSet +``` + +## Inheritance + +`OptionSet` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = UInt +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `both` + +``` swift +public static var both: Axis +``` + +### `horizontal` + +``` swift +public static var horizontal: Axis +``` + +### `vertical` + +``` swift +public static var vertical: Axis +``` diff --git a/SwiftWin32/BackgroundConfiguration.md b/SwiftWin32/BackgroundConfiguration.md new file mode 100644 index 00000000..ac720e14 --- /dev/null +++ b/SwiftWin32/BackgroundConfiguration.md @@ -0,0 +1,250 @@ +--- +layout: default +title: BackgroundConfiguration +parent: SwiftWin32 +--- +# BackgroundConfiguration + +A configuration that describes a specific background appearance. + +``` swift +public struct BackgroundConfiguration +``` + +## Inheritance + +`CustomDebugStringConvertible`, `CustomReflectable`, `CustomStringConvertible`, `Hashable` + +## Properties + +### `customView` + +A custom view for the background. + +``` swift +public var customView: View? +``` + +### `cornerRadius` + +The preferred corner radius, using a continuous corner curve, for the +background and stroke. + +``` swift +public var cornerRadius: Double = 0.0 +``` + +### `backgroundInsets` + +The insets (or outsets, if negative) for the background and stroke, +relative to the edges of the containing view. + +``` swift +public var backgroundInsets: DirectionalEdgeInsets = .zero +``` + +### `edgesAddingLayoutMarginsToBackgroundInsets` + +The edges on which the configuration adds the containing view’s layout +margins to the background insets. + +``` swift +public var edgesAddingLayoutMarginsToBackgroundInsets: DirectionalRectEdge = + .none +``` + +### `backgroundColor` + +The color of the background. + +``` swift +public var backgroundColor: Color? +``` + +If the value is `nil`, the background color is the view's tint color. Use +`clear` for a transparent background with no color. + +### `backgroundColorTransformer` + +The color transformer for resolving the background color. + +``` swift +public var backgroundColorTransformer: ConfigurationColorTransformer? +``` + +If the value is `nil`, the configuration uses `backgroundColor` without +any transformations. + +### `visualEffect` + +The visual effect that the configuration applies to the background. + +``` swift +public var visualEffect: VisualEffect? +``` + +### `strokeColor` + +The color of the stroke. + +``` swift +public var strokeColor: Color? +``` + +If the value is `nil`, the stroke color is the view's tint color. Use +`clear` for a transparent stroke with no color. + +### `strokeColorTransformer` + +The color transformer for resolving the stroke color. + +``` swift +public var strokeColorTransformer: ConfigurationColorTransformer? +``` + +If the value is `nil`, the configuration uses `strokeColor` without any +transformations. + +### `strokeWidth` + +The width of the stroke. + +``` swift +public var strokeWidth: Double = 0.0 +``` + +### `strokeOutset` + +The outset (or inset, if negative) for the stroke. + +``` swift +public var strokeOutset: Double = 0.0 +``` + +### `description` + +``` swift +public var description: String +``` + +### `debugDescription` + +``` swift +public var debugDescription: String +``` + +### `customMirror` + +``` swift +public var customMirror: Mirror +``` + +## Methods + +### `listPlainCell()` + +Creates a default configuration for a plain list cell. + +``` swift +public static func listPlainCell() -> BackgroundConfiguration +``` + +### `listGroupedCell()` + +Creates a default configuration for a grouped list cell. + +``` swift +public static func listGroupedCell() -> BackgroundConfiguration +``` + +### `listSidebarCell()` + +Creates a default configuration for a sidebar list cell. + +``` swift +public static func listSidebarCell() -> BackgroundConfiguration +``` + +### `listAccompaniedSidebarCell()` + +Creates a default configuration for an accompanied sidebar list cell. + +``` swift +public static func listAccompaniedSidebarCell() -> BackgroundConfiguration +``` + +### `listPlainHeaderFooter()` + +Creates a default configuration for a plain list header or footer. + +``` swift +public static func listPlainHeaderFooter() -> BackgroundConfiguration +``` + +### `listGroupedHeaderFooter()` + +Creates a default configuration for a grouped list header or footer. + +``` swift +public static func listGroupedHeaderFooter() -> BackgroundConfiguration +``` + +### `listSidebarHeader()` + +Creates a default configuration for a sidebar list header. + +``` swift +public static func listSidebarHeader() -> BackgroundConfiguration +``` + +### `clear()` + +Creates an empty background configuration with a transparent background +and no default styling. + +``` swift +public static func clear() -> BackgroundConfiguration +``` + +### `resolvedBackgroundColor(for:)` + +Generates the resolved background color for the specified tint color, +using the background color and color transformer. + +``` swift +public func resolvedBackgroundColor(for tintColor: Color) -> Color +``` + +### `resolvedStrokeColor(for:)` + +Generates the resolved stroke color for the specified tint color, using +the stroke color and color transformer. + +``` swift +public func resolvedStrokeColor(for tintColor: Color) -> Color +``` + +### `updated(for:)` + +Generates a configuration for the specified state by applying the +configuration's default values for that state to any properties that you +haven't customized. + +``` swift +public func updated(for state: ConfigurationState) -> BackgroundConfiguration +``` + +### `hash(into:)` + +``` swift +public func hash(into hasher: inout Hasher) +``` + +## Operators + +### `==` + +``` swift +public static func ==(_ lhs: BackgroundConfiguration, + _ rhs: BackgroundConfiguration) -> Bool +``` diff --git a/SwiftWin32/BarButtonItem.md b/SwiftWin32/BarButtonItem.md new file mode 100644 index 00000000..197f3489 --- /dev/null +++ b/SwiftWin32/BarButtonItem.md @@ -0,0 +1,432 @@ +--- +layout: default +title: BarButtonItem +parent: SwiftWin32 +--- +# BarButtonItem + +A specialized button for placement on a toolbar or tab bar. + +``` swift +open class BarButtonItem: BarItem +``` + +You can customize the appearance of buttons by sending the setter messages +to `BarButtonItemAppearance` to customize all buttons, or to a specific +`BarButtonItem` instance. You can use customized buttons in standard places +in a `NavigationItem` object (`backBarButtonItem`, `leftBarButtonItem`, +`rightBarButtonItem`) or a `Toolbar` instance. + +In general, you should specify a value for the normal state so that other +states without a custom value set can use it. Similarly, when a property is +depends on the bar metrics, you should specify a value of +`BarMetrics.default`. + +## Inheritance + +[`BarItem`](https://compnerd.github.io/swift-win32/SwiftWin32/BarItem) + +## Initializers + +### `init(barButtonSystemItem:target:action:)` + +Initializes a new item containing the specified system item. + +``` swift +public convenience init(barButtonSystemItem systemItem: BarButtonItem.SystemItem, + target: Target?, + action: ((Target) -> () -> Void)?) +``` + +### `init(barButtonSystemItem:target:action:)` + +``` swift +public convenience init(barButtonSystemItem systemItem: BarButtonItem.SystemItem, + target: Target?, + action: ((Target) -> (AnyObject?) -> Void)?) +``` + +### `init(customView:)` + +Initializes a new item using the specified custom view. + +``` swift +public convenience init(customView: View) +``` + +The bar button item created by this method does not call the action method +of its target in response to user interactions. Instead, the bar button +item expects the specified custom view to handle any user interactions and +provide an appropriate response. + +### `init(image:style:target:action:)` + +Initializes a new item using the specified image and other properties. + +``` swift +public convenience init(image: Image?, + style: BarButtonItem.Style, + target: Target?, + action: ((Target) -> () -> Void)?) +``` + +### `init(image:style:target:action:)` + +``` swift +public convenience init(image: Image?, + style: BarButtonItem.Style, + target: Target?, + action: ((Target) -> (AnyObject?) -> Void)?) +``` + +### `init(title:style:target:action:)` + +Initializes a new item using the specified title and other properties. + +``` swift +public convenience init(title: String?, + style: BarButtonItem.Style, + target: Target?, + action: ((Target) -> () -> Void)?) +``` + +### `init(title:style:target:action:)` + +``` swift +public convenience init(title: String?, + style: BarButtonItem.Style, + target: Target?, + action: ((Target) -> (AnyObject?) -> Void)?) +``` + +### `init(title:image:primaryAction:menu:)` + +Initializes a new item using the specified title, image, action, and +context menu. + +``` swift +public convenience init(title: String? = nil, image: Image? = nil, + primaryAction: Action? = nil, menu: Menu? = nil) +``` + +The context menu is displayed immediately when touched. + +### `init(systemItem:primaryAction:menu:)` + +Initializes a new item using the specified system item, action, and +context menu. + +``` swift +public convenience init(systemItem: BarButtonItem.SystemItem, + primaryAction: Action? = nil, menu: Menu? = nil) +``` + +The context menu is displayed immediately when touched. + +### `init(image:landscapeImagePhone:style:target:action:)` + +Initializes a new item using the specified images and other properties. + +``` swift +public convenience init(image: Image?, + landscapeImagePhone: Image?, + style: BarButtonItem.Style, + target: Target?, + action: ((Target) -> () -> Void)?) +``` + +A new item initialized to use using the specified images and other +properties. + +### `init(image:landscapeImagePhone:style:target:action:)` + +``` swift +public convenience init(image: Image?, + landscapeImagePhone: Image?, + style: BarButtonItem.Style, + target: Target?, + action: ((Target) -> (_: AnyObject?) -> Void)?) +``` + +### `init()` + +Initializes the bar button item to its default state. + +``` swift +public override init() +``` + +## Properties + +### `target` + +The object that receives an action when the user selects the item. + +``` swift +open weak var target: AnyObject? +``` + +If `nil`, the action message is passed up the responder chain where it may +be handled by any object implementing a method corresponding to the +selector held by the action property. The default value is `nil`. + +### `style` + +The selector defining the action message to send to the target object when +the user taps this bar button item. + +``` swift +open var style: BarButtonItem.Style = .plain +``` + +If the value of this property is `nil`, no action message is sent. The +default value is `nil`. +The style of the item. + +One of the constants defined in `BarButtonItem.Style`. The default value +is `BarButtonItem.Style.plain`. + +### `possibleTitles` + +The set of possible titles to display on the bar button. + +``` swift +open var possibleTitles: Set? +``` + +### `width` + +The width of the item. + +``` swift +open var width: Double = 0.0 +``` + +If this property value is positive, the width of the combined image and +title are fixed. If the value is `0.0` or negative, the item sets the +width of the combined image and title to fit. This property is ignored if +the style uses radio mode. The default value is `0.0`. + +### `customView` + +A custom view representing the item. + +``` swift +open var customView: View? +``` + +### `menu` + +The context menu for this button. + +``` swift +open var menu: Menu? +``` + +The context menu is displayed immediately when touched. + +### `primaryAction` + +The action to send to the target when the user selects the item. + +``` swift +open var primaryAction: Action? +``` + +The `target` and `action` properties are ingored when `primaryAction` is +not `nil`. + +### `tintColor` + +The tint color to apply to the button item. + +``` swift +open var tintColor: Color? +``` + +All subclasses of `View` derive their behaviour for `tintColor` from the +base class. Although `BarButtonItem` is not a view, its `tintColor` +property behaves the same as that of `View`. See the discussion of +`tintColor` at the `View` level for more information. + +### `buttonGroup` + +The group on the shortcuts bar that the button belongs to. + +``` swift +open private(set) weak var buttonGroup: BarButtonItemGroup? +``` + +For bar button items installed on the shortcuts bar above the keyboard, +this property contains the group to which the item belongs. This property +is configured automatically when you add the bar button item to a +`BarButtonItemGroup` object. If the item is not associated with a bar +button item group, this property is `nil`. + +## Methods + +### `fixedSpace(_:)` + +Creates a new fixed space item using the width. + +``` swift +open class func fixedSpace(_ width: Double) -> Self +``` + +### `flexibleSpace()` + +Creates a new flexible width space item. + +``` swift +open class func flexibleSpace() -> Self +``` + +### `backButtonBackgroundImage(for:barMetrics:)` + +Returns the back button background image for a specified control state and +bar metrics. + +``` swift +open func backButtonBackgroundImage(for state: Control.State, + barMetrics: BarMetrics) -> Image? +``` + +This modifier applies only to navigation bar back buttons and is ignored +by other buttons. + +### `setBackButtonBackgroundImage(_:for:barMetrics:)` + +Sets the back button background image for a specified control state and +bar metrics. + +``` swift +open func setBackButtonBackgroundImage(_ backgroundImage: Image?, + for state: Control.State, + barMetrics: BarMetrics) +``` + +This modifier applies only to navigation bar back buttons and is ignored +by other buttons. + +For good results, backgroundImage must be a stretchable image. + +### `backButtonTitlePositionAdjustment(for:)` + +Returns the back button title offset for specified bar metrics. + +``` swift +open func backButtonTitlePositionAdjustment(for barMetrics: BarMetrics) + -> Offset +``` + +This modifier applies only to navigation bar back buttons and is ignored +by other buttons. + +### `setBackButtonTitlePositionAdjustment(_:for:)` + +Sets the back button title offset for specified bar metrics. + +``` swift +open func setBackButtonTitlePositionAdjustment(_ adjustment: Offset, + for barMetrics: BarMetrics) +``` + +This modifier applies only to navigation bar back buttons and is ignored +by other buttons. + +### `backButtonBackgroundVerticalPositionAdjustment(for:)` + +Returns the back button vertical position offset for specified bar +metrics. + +``` swift +open func backButtonBackgroundVerticalPositionAdjustment(for barMetrics: BarMetrics) + -> Double +``` + +This modifier applies only to navigation bar back buttons and is ignored +by other buttons. + +This offset is used to adjust the vertical centering of bordered bar +buttons within the bar. + +### `setBackgroundVerticalPositionAdjustment(_:for:)` + +Sets the background vertical position offset for specified bar metrics. + +``` swift +open func setBackgroundVerticalPositionAdjustment(_ adjustment: Double, + for barMetrics: BarMetrics) +``` + +This offset is used to adjust the vertical centering of bordered bar +buttons within the bar. + +### `backgroundImage(for:barMetrics:)` + +Returns the background image for a specified state and bar metrics. + +``` swift +open func backgroundImage(for state: Control.State, barMetrics: BarMetrics) + -> Image? +``` + +The background image for the button given state and metrics. + +### `setBackgroundImage(_:for:barMetrics:)` + +Sets the background image for a specified state and bar metrics. + +``` swift +open func setBackgroundImage(_ backgroundImage: Image?, + for state: Control.State, + barMetrics: BarMetrics) +``` + +For good results, `backgroundImage` must be a stretchable image. + +### `backgroundImage(for:style:barMetrics:)` + +Returns the background image for the specified state, style, and metrics. + +``` swift +open func backgroundImage(for state: Control.State, + style: BarButtonItem.Style, + barMetrics: BarMetrics) -> Image? +``` + +### `setBackgroundImage(_:for:style:barMetrics:)` + +Sets the background image for the specified state, style, and metrics. + +``` swift +open func setBackgroundImage(_ backgroundImage: Image?, + for state: Control.State, + style: BarButtonItem.Style, + barMetrics: BarMetrics) +``` + +For good results, `backgroundImage` must be a stretchable image. + +### `titlePositionAdjustment(for:)` + +Returns the title offset for specified bar metrics. + +``` swift +open func titlePositionAdjustment(for barMetrics: BarMetrics) -> Offset +``` + +This offset is used to adjust the position of a title (if any) within a +bordered bar button. + +### `setTitlePositionAdjustment(_:for:)` + +Sets the title offset for specified bar metrics. + +``` swift +open func setTitlePositionAdjustment(_ adjustment: Offset, + for barMetrics: BarMetrics) +``` + +This offset is used to adjust the position of a title (if any) within a +bordered bar button. diff --git a/SwiftWin32/BarButtonItemGroup.md b/SwiftWin32/BarButtonItemGroup.md new file mode 100644 index 00000000..553f8759 --- /dev/null +++ b/SwiftWin32/BarButtonItemGroup.md @@ -0,0 +1,77 @@ +--- +layout: default +title: BarButtonItemGroup +parent: SwiftWin32 +--- +# BarButtonItemGroup + +A set of bar button items on the shortcuts bar. + +``` swift +open class BarButtonItemGroup +``` + +## Initializers + +### `init(barButtonItems:representativeItem:)` + +Initializes and returns a bar button item group with the specified items. + +``` swift +public init(barButtonItems: [BarButtonItem], representativeItem: BarButtonItem?) +``` + +## Properties + +### `barButtonItems` + +The bar button items to display on the shortcuts bar. + +``` swift +open var barButtonItems: [BarButtonItem] +``` + +You may include any number of bar button items in a group, but you should +keep the total number of items relatively small because of space +considerations. The items in a group are typically related to each other, +but need not be. The array must contain at least one item. + +Items can belong to only one group at a time. If you specify an item that +is already in a group, the framework removes the item from its previous +group before assigning it to the current group. + +### `representativeItem` + +The item to display for a group when space is constrained. + +``` swift +open var representativeItem: BarButtonItem? +``` + +When space is constrained on the shortcuts bar, the framework may display +a group's representative item in place of its actual items. The +representative item is a single bar button item that is unique from the +other items in the group. Tapping the representative item calls its action +method normally. If you omit that action method, the framework responds by +automatically displaying the group’s items in a standard interface. + +If you do not specify a representative item for a group, the framework +tries to display the group's items in the shortcuts bar. If space is still +constrained, the framework may modify the appearance of items in the group +to make room for all of the items. For example, the framework may truncate +the titles of textual bar button items. When space is severely +constrained, the framework may not even display a group's representative +item. + +### `isDisplayingRepresentativeItem` + +A boolean value indicating whether the representative item is being +displayed in place of the group's items. + +``` swift +open private(set) var isDisplayingRepresentativeItem: Bool = true +``` + +The value of this property is `true` when the representative item is being +displayed in the shortcuts bar. The value is false when the individual bar +button items are being displayed in the shortcuts bar. diff --git a/SwiftWin32/BarButtonItem_Style.md b/SwiftWin32/BarButtonItem_Style.md new file mode 100644 index 00000000..5b9cf440 --- /dev/null +++ b/SwiftWin32/BarButtonItem_Style.md @@ -0,0 +1,44 @@ +--- +layout: default +title: BarButtonItem.Style +parent: SwiftWin32 +--- +# BarButtonItem.Style + +The system close button. + +``` swift +public enum Style: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `plain` + +Glows when tapped. The default item style. + +``` swift +case plain +``` + +### `bordered` + +A simple button style with a border. + +``` swift +@available(*, unavailable) + case bordered +``` + +### `done` + +The style for a done button — for example, a button that completes some +task and returns to the previous view. + +``` swift +case done +``` diff --git a/SwiftWin32/BarButtonItem_SystemItem.md b/SwiftWin32/BarButtonItem_SystemItem.md new file mode 100644 index 00000000..3742e08a --- /dev/null +++ b/SwiftWin32/BarButtonItem_SystemItem.md @@ -0,0 +1,222 @@ +--- +layout: default +title: BarButtonItem.SystemItem +parent: SwiftWin32 +--- +# BarButtonItem.SystemItem + +Defines system-supplied images for bar button items. + +``` swift +public enum SystemItem: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `done` + +The system Done button, localized. + +``` swift +case done +``` + +### `cancel` + +The system Cancel button, localized. + +``` swift +case cancel +``` + +### `edit` + +The system Edit button, localized. + +``` swift +case edit +``` + +### `save` + +The system Save button, localized. + +``` swift +case save +``` + +### `add` + +The system plus button containing an icon of a plus sign. + +``` swift +case add +``` + +### `flexibleSpace` + +Blank space to add between other items. The space is distributed equally +between the other items. Other item properties are ignored when this +value is set. + +``` swift +case flexibleSpace +``` + +### `fixedSpace` + +Blank space to add between other items. Only the `width` property is +used when this value is set. + +``` swift +case fixedSpace +``` + +### `compose` + +The system compose button. + +``` swift +case compose +``` + +### `reply` + +The system reply button. + +``` swift +case reply +``` + +### `action` + +The system action button. + +``` swift +case action +``` + +### `organize` + +The system organize button. + +``` swift +case organize +``` + +### `bookmarks` + +The system bookmarks button. + +``` swift +case bookmarks +``` + +### `search` + +The system search button. + +``` swift +case search +``` + +### `refresh` + +The system refresh button. + +``` swift +case refresh +``` + +### `stop` + +The system stop button. + +``` swift +case stop +``` + +### `camera` + +The system camera button. + +``` swift +case camera +``` + +### `trash` + +The system trash button. + +``` swift +case trash +``` + +### `play` + +The system play button. + +``` swift +case play +``` + +### `pause` + +The system pause button. + +``` swift +case pause +``` + +### `rewind` + +The system rewind button. + +``` swift +case rewind +``` + +### `fastForward` + +The system fast forward button. + +``` swift +case fastForward +``` + +### `undo` + +The system undo button. + +``` swift +case undo +``` + +### `redo` + +The system redo button. + +``` swift +case redo +``` + +### `pageCurl` + +The system page curl button. + +``` swift +@available(*, unavailable) + case pageCurl +``` + +### `close` + +The system close button. + +``` swift +case close +``` diff --git a/SwiftWin32/BarItem.md b/SwiftWin32/BarItem.md new file mode 100644 index 00000000..4c04c54d --- /dev/null +++ b/SwiftWin32/BarItem.md @@ -0,0 +1,156 @@ +--- +layout: default +title: BarItem +parent: SwiftWin32 +--- +# BarItem + +An abstract superclass for items that you can add to a bar that appears at +the bottom of the screen. + +``` swift +open class BarItem +``` + +## Initializers + +### `init()` + +Initializes the bar item to its default state. + +``` swift +public init() +``` + +## Properties + +### `title` + +The title displayed on the item. + +``` swift +open var title: String? +``` + +You should set this property before adding the item to a bar. The default +value is `nil`. + +### `image` + +The image used to represent the item. + +``` swift +open var image: Image? +``` + +This image can be used to create other images to represent this item on +the bar — for example, a selected and unselected image may be derived from +this image. You should set this property before adding the item to a bar. +The default value is `nil`. + +### `landscapeImage` + +The image to use to represent the item in landscape orientation. + +``` swift +open var landscapeImage: Image? +``` + +This image can be used to create other images to represent this item on +the bar — for example, a selected and unselected image may be derived from +this image. You should set this property before adding the item to a bar. +The default value is `nil`. + +### `largeContentSizeImage` + +The image to display for assistive interfaces. + +``` swift +open var largeContentSizeImage: Image? +``` + +Use this property to specify a high-resolution version of the item's +image. When displaying an assistive interface, the framework displays this +image instead of the standard image. The default value of this property is +`nil`. + +If you do not specify an image for this property, the framework scales the +image that you specified in the image property. + +### `imageInsets` + +The image inset or outset for each edge. + +``` swift +open var imageInsets: EdgeInsets = .zero +``` + +The default value is `zero`. + +### `landscapeImageInsets` + +The image inset or outset for each edge of the image in landscape +orientation. + +``` swift +open var landscapeImageInsets: EdgeInsets = .zero +``` + +The default value is `zero`. + +### `largeContentSizeImageInsets` + +The insets to apply to the bar item's large image when displaying the +image in an assistive UI. + +``` swift +open var largeContentSizeImageInsets: EdgeInsets = .zero +``` + +The default value of this property is `zero`. + +### `isEnabled` + +A boolean value indicating whether the item is enabled. + +``` swift +open var isEnabled: Bool = true +``` + +If `false`, the item is drawn partially dimmed to indicate it is disabled. +The default value is `true`. + +### `tag` + +The receiver’s tag, an application-supplied integer that you can use to +identify bar item objects in your application. + +``` swift +open var tag: Int = 0 +``` + +The default value is `0`. + +## Methods + +### `setTitleTextAttributes(_:for:)` + +Sets the title’s text attributes for a given control state. + +``` swift +open func setTitleTextAttributes(_ attributes: [NSAttributedString.Key:Any]?, + for state: Control.State) +``` + +### `titleTextAttributes(for:)` + +Returns the title’s text attributes for a given control state. + +``` swift +open func titleTextAttributes(for state: Control.State) + -> [NSAttributedString.Key:Any]? +``` + +The dictionary may contain key-value pairs for text attributes for the +font, text color, text shadow color, and text shadow offset using the keys +listed in NSString Additions Reference. diff --git a/SwiftWin32/BarMetrics.md b/SwiftWin32/BarMetrics.md new file mode 100644 index 00000000..df58d7a4 --- /dev/null +++ b/SwiftWin32/BarMetrics.md @@ -0,0 +1,74 @@ +--- +layout: default +title: BarMetrics +parent: SwiftWin32 +--- +# BarMetrics + +Constants to specify metrics to use for appearance. + +``` swift +public enum BarMetrics: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `` `default` `` + +Specifies default metrics for the device. + +``` swift +case `default` +``` + +### `compact` + +Specifies metrics when using the phone idiom. + +``` swift +case compact +``` + +### `defaultPrompt` + +Specifies default metrics for the device for bars with the +prompt property, such as `NavigationBar` and `SearchBar`. + +``` swift +case defaultPrompt +``` + +### `compactPrompt` + +Specifies metrics for bars with the prompt property when using +the phone idiom, such as `NavigationBar` and `SearchBar`. + +``` swift +case compactPrompt +``` + +## Properties + +### `landscapePhone` + +Specifies metrics for landscape orientation using the phone idiom. + +``` swift +@available(*, unavailable) + public static var landscapePhone: BarMetrics +``` + +### `landscapePhonePrompt` + +Specifies metrics for landscape orientation using the phone idiom +for bars with the prompt property, such as `NavigationBar` and +`SearchBar`. + +``` swift +@available(*, unavailable) + public static var landscapePhonePrompt: BarMetrics +``` diff --git a/SwiftWin32/BezierPath.md b/SwiftWin32/BezierPath.md new file mode 100644 index 00000000..e45b06c2 --- /dev/null +++ b/SwiftWin32/BezierPath.md @@ -0,0 +1,10 @@ +--- +layout: default +title: BezierPath +parent: SwiftWin32 +--- +# BezierPath + +``` swift +public class BezierPath +``` diff --git a/SwiftWin32/Button.md b/SwiftWin32/Button.md new file mode 100644 index 00000000..4f8b10a7 --- /dev/null +++ b/SwiftWin32/Button.md @@ -0,0 +1,46 @@ +--- +layout: default +title: Button +parent: SwiftWin32 +--- +# Button + +A control that executes your custom code in response to user interactions. + +``` swift +public class Button: Control +``` + +## Inheritance + +[`Control`](https://compnerd.github.io/swift-win32/SwiftWin32/Control) + +## Initializers + +### `init(frame:)` + +Creates a new button with the specified frame. + +``` swift +public init(frame: Rect) +``` + +### `init(frame:primaryAction:)` + +Creates a new button with the specified frame, registers the primary +action event, and sets the title and image to the action's title and +image. + +``` swift +public convenience init(frame: Rect, primaryAction: Action?) +``` + +## Methods + +### `setTitle(_:forState:)` + +Sets the title to use for the specified state. + +``` swift +public func setTitle(_ title: String?, forState state: Control.State) +``` diff --git a/SwiftWin32/Button_ButtonType.md b/SwiftWin32/Button_ButtonType.md new file mode 100644 index 00000000..42bdb9c1 --- /dev/null +++ b/SwiftWin32/Button_ButtonType.md @@ -0,0 +1,83 @@ +--- +layout: default +title: Button.ButtonType +parent: SwiftWin32 +--- +# Button.ButtonType + +Specifies the style of a button. + +``` swift +public enum ButtonType: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `custom` + +No button style. + +``` swift +case custom +``` + +### `system` + +A system style button, such as those shown in navigation bars and +toolbars. + +``` swift +case system +``` + +### `detailDisclosure` + +A detail disclosure button. + +``` swift +case detailDisclosure +``` + +### `infoLight` + +An information button that has a light background. + +``` swift +case infoLight +``` + +### `infoDark` + +An information button that has a dark background. + +``` swift +case infoDark +``` + +### `contactAdd` + +A contact add button. + +``` swift +case contactAdd +``` + +### `plain` + +A standard system button without a blurred background view. + +``` swift +case plain +``` + +### `close` + +A close button to dismiss panels and views. + +``` swift +case close +``` diff --git a/SwiftWin32/CellConfigurationState.md b/SwiftWin32/CellConfigurationState.md new file mode 100644 index 00000000..2146fded --- /dev/null +++ b/SwiftWin32/CellConfigurationState.md @@ -0,0 +1,69 @@ +--- +layout: default +title: CellConfigurationState +parent: SwiftWin32 +--- +# CellConfigurationState + +A structure that encapsulates a cell's state. + +``` swift +public struct CellConfigurationState: ConfigurationState +``` + +## Inheritance + +[`ConfigurationState`](https://compnerd.github.io/swift-win32/SwiftWin32/ConfigurationState) + +## Initializers + +### `init(traitCollection:)` + +Creates a cell configuration state with the specified trait collection. + +``` swift +public init(traitCollection: TraitCollection) +``` + +## Properties + +### `traitCollection` + +The traits that describe the current layout environment of the view, such +as the user interface style and layout direction. + +``` swift +public var traitCollection: TraitCollection +``` + +### `isSelected` + +A boolean value that indicates whether the cell is in a selected state. + +``` swift +public var isSelected: Bool = false +``` + +### `isHighlighted` + +A boolean value that indicates whether the cell is in a highlighted state. + +``` swift +public var isHighlighted: Bool = false +``` + +### `isFocused` + +A boolean value that indicates whether the cell is in a focused state. + +``` swift +public var isFocused: Bool = false +``` + +### `isDisabled` + +A boolean value that indicates whether the cell is in a disabled state. + +``` swift +public var isDisabled: Bool = false +``` diff --git a/SwiftWin32/Color.md b/SwiftWin32/Color.md new file mode 100644 index 00000000..e6091751 --- /dev/null +++ b/SwiftWin32/Color.md @@ -0,0 +1,562 @@ +--- +layout: default +title: Color +parent: SwiftWin32 +--- +# Color + +An object that stores color data and sometimes opacity. + +``` swift +public struct Color +``` + +## Inheritance + +`Equatable`, `Hashable`, `_ExpressibleByColorLiteral` + +## Initializers + +### `init(white:alpha:)` + +Creates a color object using the specified opacity and grayscale values. + +``` swift +public init(white: Double, alpha: Double) +``` + +### `init(hue:saturation:brightness:alpha:)` + +Creates a color object using the specified opacity and HSB color space +component values. + +``` swift +public init(hue: Double, saturation: Double, brightness: Double, + alpha: Double) +``` + +### `init(red:green:blue:alpha:)` + +Creates a color object using the specified opacity and RGB component +values. + +``` swift +public init(red: Double, green: Double, blue: Double, alpha: Double) +``` + +### `init(dynamicProvider:)` + +Creates a color object that uses the specified block to generate its color +data dynamically. + +``` swift +public init(dynamicProvider block: @escaping (TraitCollection) -> Color) +``` + +### `init(_colorLiteralRed:green:blue:alpha:)` + +``` swift +public init(_colorLiteralRed red: Float, green: Float, blue: Float, + alpha: Float) +``` + +## Properties + +### `systemBlue` + +A blue color that automatically adapts to the current trait environment. + +``` swift +public static var systemBlue: Color +``` + +### `systemBrown` + +A brown color that automatically adapts to the current trait environment. + +``` swift +public static var systemBrown: Color +``` + +### `systemGreen` + +A green color that automatically adapts to the current trait environment. + +``` swift +public static var systemGreen: Color +``` + +### `systemIndigo` + +An indigo color that automatically adapts to the current trait +environment. + +``` swift +public static var systemIndigo: Color +``` + +### `systemOrange` + +An orange color that automatically adapts to the current trait +environment. + +``` swift +public static var systemOrange: Color +``` + +### `systemPink` + +A pink color that automatically adapts to the current trait environment. + +``` swift +public static var systemPink: Color +``` + +### `systemPurple` + +A purple color that automatically adapts to the current trait environment. + +``` swift +public static var systemPurple: Color +``` + +### `systemRed` + +A red color that automatically adapts to the current trait environment. + +``` swift +public static var systemRed: Color +``` + +### `systemTeal` + +A teal color that automatically adapts to the current trait environment. + +``` swift +public static var systemTeal: Color +``` + +### `systemYellow` + +A yellow color that automatically adapts to the current trait environment. + +``` swift +public static var systemYellow: Color +``` + +### `systemGray` + +The standard base gray color that adapts to the environment. + +``` swift +public static var systemGray: Color +``` + +### `systemGray2` + +A second-level shade of grey that adapts to the environment. + +``` swift +public static var systemGray2: Color +``` + +### `systemGray3` + +A third-level shade of grey that adapts to the environment. + +``` swift +public static var systemGray3: Color +``` + +### `systemGray4` + +A fourth-level shade of grey that adapts to the environment. + +``` swift +public static var systemGray4: Color +``` + +### `systemGray5` + +A fifth-level shade of grey that adapts to the environment. + +``` swift +public static var systemGray5: Color +``` + +### `systemGray6` + +A sixth-level shade of grey that adapts to the environment. + +``` swift +public static var systemGray6: Color +``` + +### `clear` + +A color object with grayscale and alpha values that are both 0.0. + +``` swift +public static var clear: Color +``` + +### `black` + +A color object in the sRGB color space with a grayscale value of 0.0 and +an alpha value of 1.0. + +``` swift +public static var black: Color +``` + +### `blue` + +A color object with RGB values of 0.0, 0.0, and 1.0, and an alpha value of +1.0. + +``` swift +public static var blue: Color +``` + +### `brown` + +A color object with RGB values of 0.6, 0.4, and 0.2, and an alpha value of +1.0. + +``` swift +public static var brown: Color +``` + +### `cyan` + +A color object with RGB values of 0.0, 1.0, and 1.0, and an alpha value of +1.0. + +``` swift +public static var cyan: Color +``` + +### `darkGray` + +A color object with a grayscale value of 1/3 and an alpha value of 1.0. + +``` swift +public static var darkGray: Color +``` + +### `gray` + +A color object with a grayscale value of 0.5 and an alpha value of 1.0. + +``` swift +public static var gray: Color +``` + +### `green` + +A color object with RGB values of 0.0, 1.0, and 0.0, and an alpha value of +1.0. + +``` swift +public static var green: Color +``` + +### `lightGray` + +A color object with a grayscale value of 2/3 and an alpha value of 1.0. + +``` swift +public static var lightGray: Color +``` + +### `magenta` + +A color object with RGB values of 1.0, 0.0, and 1.0, and an alpha value of +1.0. + +``` swift +public static var magenta: Color +``` + +### `orange` + +A color object with RGB values of 1.0, 0.5, and 0.0, and an alpha value of +1.0. + +``` swift +public static var orange: Color +``` + +### `purple` + +A color object with RGB values of 0.5, 0.0, and 0.5, and an alpha value of +1.0. + +``` swift +public static var purple: Color +``` + +### `red` + +A color object with RGB values of 1.0, 0.0, and 0.0, and an alpha value of +1.0. + +``` swift +public static var red: Color +``` + +### `white` + +A color object with a grayscale value of 1.0 and an alpha value of 1.0. + +``` swift +public static var white: Color +``` + +### `yellow` + +A color object with RGB values of 1.0, 1.0, and 0.0, and an alpha value of +1.0. + +``` swift +public static var yellow: Color +``` + +### `label` + +The Color for text labels that contain primary content. + +``` swift +public static var label: Color +``` + +### `secondaryLabel` + +The color for text labels that contain secondary content. + +``` swift +public static var secondaryLabel: Color +``` + +### `tertiaryLabel` + +The color for text labels that contain tertiary content. + +``` swift +public static var tertiaryLabel: Color +``` + +### `quatenaryLabel` + +The color for text labels that contain quatenary content. + +``` swift +public static var quatenaryLabel: Color +``` + +### `systemFill` + +An overlay fill color for thin and small shapes. + +``` swift +public static var systemFill: Color +``` + +### `secondarySystemFill` + +An overlay fill color for medium-size shapes. + +``` swift +public static var secondarySystemFill: Color +``` + +### `tertiarySystemFill` + +An overlay fill color for large shapes. + +``` swift +public static var tertiarySystemFill: Color +``` + +### `quaternarySystemFill` + +An overlay fill color for large areas that contain complex content. + +``` swift +public static var quaternarySystemFill: Color +``` + +### `placeholderText` + +The color for placeholder text in controls or text views. + +``` swift +public static var placeholderText: Color +``` + +### `systemBackground` + +Standard Content Background Colors + +``` swift +public static var systemBackground: Color +``` + +Use these colors for standard table views and designs that have a white +primary background in a light environment. +The color for the main background of your interface. + +### `secondarySystemBackground` + +The color for content layered on top of the main background. + +``` swift +public static var secondarySystemBackground: Color +``` + +### `tertiarySystemBackground` + +The color for content layered on top of secondary backgrounds. + +``` swift +public static var tertiarySystemBackground: Color +``` + +### `systemGroupedBackground` + +Grouped Content Background Colors + +``` swift +public static var systemGroupedBackground: Color +``` + +Use these colors for grouped content, including table views and +platter-based designs. +The color for the main background of your grouped interface. + +### `secondarySystemGroupedBackground` + +The color for content layered on top of the main background of your +grouped interface. + +``` swift +public static var secondarySystemGroupedBackground: Color +``` + +### `tertiarySystemGroupedBackground` + +The color for content layered on top of secondary backgrounds of your +grouped interface. + +``` swift +public static var tertiarySystemGroupedBackground: Color +``` + +### `separator` + +The color for thin borders or divider lines that allows some underlying +content to be visible. + +``` swift +public static var separator: Color +``` + +### `opaqueSeparator` + +The color for borders or divider lines that hides any underlying content. + +``` swift +public static var opaqueSeparator: Color +``` + +### `link` + +The color for links. + +``` swift +public static var link: Color +``` + +### `darkText` + +The nonadaptable system color for text on a light background. + +``` swift +public static var darkText: Color +``` + +### `lightText` + +The nonadaptable system color for text on a dark background. + +``` swift +public static var lightText: Color +``` + +## Methods + +### `getHue(_:saturation:brightness:alpha:)` + +Returns the components that form the color in the HSB color space. + +``` swift +public func getHue(_ hue: UnsafeMutablePointer?, + saturation: UnsafeMutablePointer?, + brightness: UnsafeMutablePointer?, + alpha: UnsafeMutablePointer?) -> Bool +``` + +If the color is in a compatible color space, it converts into the HSB +color space, and its components return to your application. If the color +isn’t in a compatible color space, the parameters don’t change. + +### `getRed(_:green:blue:alpha:)` + +Returns the components that form the color in the RGB color space. + +``` swift +public func getRed(_ red: UnsafeMutablePointer?, + green: UnsafeMutablePointer?, + blue: UnsafeMutablePointer?, + alpha: UnsafeMutablePointer?) -> Bool +``` + +If the color is in a compatible color space, it converts into RGB format +and its components return to your application. If the color isn’t in a +compatible color space, the parameters don’t change. + +### `getWhite(_:alpha:)` + +Returns the grayscale components of the color. + +``` swift +public func getWhite(_ white: UnsafeMutablePointer?, + alpha: UnsafeMutablePointer?) -> Bool +``` + +If the color is in a compatible color space, it converts into grayscale +format and its returned to your application. If the color isn’t in a +compatible color space, the parameters don’t change. + +### `resolvedColor(with:)` + +Returns the version of the current color that results from the specified +traits. + +``` swift +public func resolvedColor(with traitCollection: TraitCollection) -> Color +``` + +### `hash(into:)` + +``` swift +public func hash(into hasher: inout Hasher) +``` + +## Operators + +### `==` + +``` swift +public static func ==(lhs: Color, rhs: Color) -> Bool +``` diff --git a/SwiftWin32/Command.md b/SwiftWin32/Command.md new file mode 100644 index 00000000..3ba16e4e --- /dev/null +++ b/SwiftWin32/Command.md @@ -0,0 +1,91 @@ +--- +layout: default +title: Command +parent: SwiftWin32 +--- +# Command + +A menu element that performs its action in a selector. + +``` swift +public class Command: MenuElement +``` + +## Inheritance + +[`MenuElement`](https://compnerd.github.io/swift-win32/SwiftWin32/MenuElement) + +## Initializers + +### `init(title:image:action:propertyList:alternates:discoverabilityTitle:attributes:state:)` + +Creates a command. + +``` swift +public /*convenience*/ init(title: String = "", image: Image? = nil, + action: @escaping (_: AnyObject?) -> Void, + propertyList: Any? = nil, + alternates: [CommandAlternate] = [], + discoverabilityTitle: String? = nil, + attributes: MenuElement.Attributes = [], + state: MenuElement.State = .off) +``` + +## Properties + +### `title` + +The command's title. + +``` swift +public override var title: String +``` + +### `image` + +The command's image. + +``` swift +public override var image: Image? +``` + +### `action` + +The selector identifying the action method called after the user selects +the command. + +``` swift +public var action: (_: AnyObject?) -> Void +``` + +### `discoverabilityTitle` + +An elaborated title that explains the purpose of the command. + +``` swift +public var discoverabilityTitle: String? +``` + +### `attributes` + +The attributes indicating the style of the command. + +``` swift +public var attributes: MenuElement.Attributes +``` + +### `state` + +The state of the command. + +``` swift +public var state: MenuElement.State +``` + +### `alternates` + +An array of alternative actions to take for the command. + +``` swift +public private(set) var alternates: [CommandAlternate] +``` diff --git a/SwiftWin32/CommandAlternate.md b/SwiftWin32/CommandAlternate.md new file mode 100644 index 00000000..86658e54 --- /dev/null +++ b/SwiftWin32/CommandAlternate.md @@ -0,0 +1,52 @@ +--- +layout: default +title: CommandAlternate +parent: SwiftWin32 +--- +# CommandAlternate + +An object representing an alternative action for a command. + +``` swift +public class CommandAlternate +``` + +## Initializers + +### `init(title:action:modifierFlags:)` + +Creates a command alternative with the specified title, action, and +modifier flags. + +``` swift +public /*convenience*/ init(title: String, + action: @escaping (_: AnyObject?) -> Void, + modifierFlags: KeyModifierFlags) +``` + +## Properties + +### `title` + +The command alternative's title. + +``` swift +public private(set) var title: String +``` + +### `action` + +The command alternative's action-method selector. + +``` swift +public private(set) var action: (_: AnyObject?) -> Void +``` + +### `modifierFlags` + +The bit mask of modifier keys that the user must press to invoke the +action for the alternative command. + +``` swift +public private(set) var modifierFlags: KeyModifierFlags +``` diff --git a/SwiftWin32/ConfigurationColorTransformer.md b/SwiftWin32/ConfigurationColorTransformer.md new file mode 100644 index 00000000..b40fe6d0 --- /dev/null +++ b/SwiftWin32/ConfigurationColorTransformer.md @@ -0,0 +1,67 @@ +--- +layout: default +title: ConfigurationColorTransformer +parent: SwiftWin32 +--- +# ConfigurationColorTransformer + +A transformer that generates a modified output color from an input color. + +``` swift +public struct ConfigurationColorTransformer +``` + +## Initializers + +### `init(_:)` + +Creates a color transformer with the specified closure. + +``` swift +public init(_ transform: @escaping (Color) -> Color) +``` + +## Properties + +### `grayscale` + +Creates a color transformer that generates a grayscale version of the +color. + +``` swift +public static var grayscale: ConfigurationColorTransformer +``` + +### `preferredTint` + +A color transformer that returns the preferred system accent color. + +``` swift +public static var preferredTint: ConfigurationColorTransformer +``` + +### `monochromeTint` + +A color transformer that returns the color with a monochrome tint. + +``` swift +public static var monochromeTint: ConfigurationColorTransformer +``` + +### `transform` + +The transform closure of the color transformer. + +``` swift +public private(set) var transform: (Color) -> Color +``` + +## Methods + +### `callAsFunction(_:)` + +Calls the transform closure of the color transformer. + +``` swift +public func callAsFunction(_ input: Color) -> Color +``` diff --git a/SwiftWin32/ConfigurationState.md b/SwiftWin32/ConfigurationState.md new file mode 100644 index 00000000..7af08902 --- /dev/null +++ b/SwiftWin32/ConfigurationState.md @@ -0,0 +1,39 @@ +--- +layout: default +title: ConfigurationState +parent: SwiftWin32 +--- +# ConfigurationState + +The requirements for an object that encapsulate a view's state. + +``` swift +public protocol ConfigurationState +``` + +## Requirements + +### traitCollection + +The traits that describe the current layout environment of the view, such +as the user interface style and layout direction. + +``` swift +var traitCollection: TraitCollection +``` + +### subscript(key:​) + +Accesses custom states by key. + +``` swift +subscript(key: ConfigurationStateCustomKey) -> AnyHashable? +``` + +### init(traitCollection:​) + +Creates a View configuration state with the specified trait collection. + +``` swift +init(traitCollection: TraitCollection) +``` diff --git a/SwiftWin32/ConfigurationStateCustomKey.md b/SwiftWin32/ConfigurationStateCustomKey.md new file mode 100644 index 00000000..54a35fba --- /dev/null +++ b/SwiftWin32/ConfigurationStateCustomKey.md @@ -0,0 +1,46 @@ +--- +layout: default +title: ConfigurationStateCustomKey +parent: SwiftWin32 +--- +# ConfigurationStateCustomKey + +A key that defines a custom state for a view. + +``` swift +public struct ConfigurationStateCustomKey: Equatable, Hashable, RawRepresentable +``` + +## Inheritance + +`Equatable`, `Hashable`, `RawRepresentable` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = String +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +### `init(_:)` + +``` swift +public init(_ rawValue: String) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` diff --git a/SwiftWin32/ContentConfiguration.md b/SwiftWin32/ContentConfiguration.md new file mode 100644 index 00000000..b7224ac5 --- /dev/null +++ b/SwiftWin32/ContentConfiguration.md @@ -0,0 +1,33 @@ +--- +layout: default +title: ContentConfiguration +parent: SwiftWin32 +--- +# ContentConfiguration + +The requirements for an object that provides the configuration for a content +view. + +``` swift +public protocol ContentConfiguration +``` + +## Requirements + +### makeContentView() + +Creates a new instance of the content view using this configuration. + +``` swift +func makeContentView() -> View & ContentView +``` + +### updated(for:​) + +Generates a configuration for the specified state by applying the +configuration's default values for that state to any properties that you +haven't customized. + +``` swift +func updated(for state: ConfigurationState) -> Self +``` diff --git a/SwiftWin32/ContentContainer.md b/SwiftWin32/ContentContainer.md new file mode 100644 index 00000000..2e0a633d --- /dev/null +++ b/SwiftWin32/ContentContainer.md @@ -0,0 +1,68 @@ +--- +layout: default +title: ContentContainer +parent: SwiftWin32 +--- +# ContentContainer + +A set of methods for adapting the contents of your view controllers to size +and trait changes. + +``` swift +public protocol ContentContainer +``` + +## Requirements + +### willTransition(to:​with:​) + +Notifies the container that the size of its view is about to change. + +``` swift +func willTransition(to: Size, + with coodinator: ViewControllerTransitionCoordinator) +``` + +### willTransition(to:​with:​) + +Notifies the container that its trait collection changed. + +``` swift +func willTransition(to: TraitCollection, + with coordinator: ViewControllerTransitionCoordinator) +``` + +### preferredContentSize + +The preferred size for the container's content. + +``` swift +var preferredContentSize: Size +``` + +### size(forChildContentContainer:​withParentContainerSize:​) + +Returns the size of the specified child view controller's content. + +``` swift +func size(forChildContentContainer container: ContentContainer, + withParentContainerSize parentSize: Size) -> Size +``` + +### preferredContentSizeDidChange(forChildContentContainer:​) + +Notifies an interested controller that the preferred content size of one of +its children changed. + +``` swift +func preferredContentSizeDidChange(forChildContentContainer container: ContentContainer) +``` + +### systemLayoutFittingSizeDidChange(forChildContentContainer:​) + +Notifies the container that a child view controller was resized using auto +layout. + +``` swift +func systemLayoutFittingSizeDidChange(forChildContentContainer container: ContentContainer) +``` diff --git a/SwiftWin32/ContentSizeCategory.md b/SwiftWin32/ContentSizeCategory.md new file mode 100644 index 00000000..0a079555 --- /dev/null +++ b/SwiftWin32/ContentSizeCategory.md @@ -0,0 +1,171 @@ +--- +layout: default +title: ContentSizeCategory +parent: SwiftWin32 +--- +# ContentSizeCategory + +Constants that indicate the preferred size of your content. + +``` swift +public struct ContentSizeCategory: Equatable, Hashable, RawRepresentable +``` + +## Inheritance + +`Equatable`, `Hashable`, `RawRepresentable` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = String +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public var rawValue: RawValue +``` + +### `unspecified` + +An unspecified font size. + +``` swift +public static var unspecified: ContentSizeCategory +``` + +### `extraSmall` + +An extra-small font. + +``` swift +public static var extraSmall: ContentSizeCategory +``` + +### `small` + +A small font. + +``` swift +public static var small: ContentSizeCategory +``` + +### `medium` + +A medium-sized font. + +``` swift +public static var medium: ContentSizeCategory +``` + +### `large` + +A large font. + +``` swift +public static var large: ContentSizeCategory +``` + +### `extraLarge` + +An extra-large font. + +``` swift +public static var extraLarge: ContentSizeCategory +``` + +### `extraExtraLarge` + +A font that is larger than the extra-large font but smaller than the +largest font size available. + +``` swift +public static var extraExtraLarge: ContentSizeCategory +``` + +### `extraExtraExtraLarge` + +The largest font size. + +``` swift +public static var extraExtraExtraLarge: ContentSizeCategory +``` + +### `accessibilityMedium` + +A medium font size that reflects the current accessibility settings. + +``` swift +public static var accessibilityMedium: ContentSizeCategory +``` + +### `accessibilityLarge` + +A large font size that reflects the current accessibility settings. + +``` swift +public static var accessibilityLarge: ContentSizeCategory +``` + +### `accessibilityExtraLarge` + +An extra-large font size that reflects the current accessibility settings. + +``` swift +public static var accessibilityExtraLarge: ContentSizeCategory +``` + +### `accessibilityExtraExtraLarge` + +A font that is larger than the extra-large font but not the largest +available, reflecting the current accessibility settings. + +``` swift +public static var accessibilityExtraExtraLarge: ContentSizeCategory +``` + +### `accessibilityExtraExtraExtraLarge` + +The largest font size that reflects the current accessibility settings. + +``` swift +public static var accessibilityExtraExtraExtraLarge: ContentSizeCategory +``` + +### `didChangeNotification` + +A notification that posts when the user changes the preferred content size +setting. + +``` swift +public static var didChangeNotification: NSNotification.Name +``` + +This notification is sent when the value in the +`preferredContentSizeCategory` property changes. The `userInfo` dictionary +of the notification contains the `newValueUserInfoKey` key, which reflects +the new setting. + +### `newValueUserInfoKey` + +A key that reflects the new preferred content size. + +``` swift +public static var newValueUserInfoKey: String +``` + +This key's value is an `NSString` object that reflects the new value of +the `preferredContentSizeCategory` property. diff --git a/SwiftWin32/ContentSizeCategoryAdjusting.md b/SwiftWin32/ContentSizeCategoryAdjusting.md new file mode 100644 index 00000000..87af089c --- /dev/null +++ b/SwiftWin32/ContentSizeCategoryAdjusting.md @@ -0,0 +1,25 @@ +--- +layout: default +title: ContentSizeCategoryAdjusting +parent: SwiftWin32 +--- +# ContentSizeCategoryAdjusting + +A collection of methods that gives controls an easy way to adopt automatic +adjustment to content category changes. + +``` swift +public protocol ContentSizeCategoryAdjusting +``` + +## Requirements + +### adjustsFontForContentSizeCategory + +Adjusting the Size of Fonts +A boolean that indicates whether the object automatically updates its font +when the device's context size category changes. + +``` swift +var adjustsFontForContentSizeCategory: Bool +``` diff --git a/SwiftWin32/ContentSizeCategoryImageAdjusting.md b/SwiftWin32/ContentSizeCategoryImageAdjusting.md new file mode 100644 index 00000000..426a6200 --- /dev/null +++ b/SwiftWin32/ContentSizeCategoryImageAdjusting.md @@ -0,0 +1,25 @@ +--- +layout: default +title: ContentSizeCategoryImageAdjusting +parent: SwiftWin32 +--- +# ContentSizeCategoryImageAdjusting + +Methods to determine when to adjust images for different content size +categories. + +``` swift +public protocol ContentSizeCategoryImageAdjusting +``` + +## Requirements + +### adjustsImageSizeForAccessibilityContentSizeCategory + +Preferring Accessibility-Specific Images +A boolean that indicates whether the image size increases to support +accessibility content size categories. + +``` swift +var adjustsImageSizeForAccessibilityContentSizeCategory: Bool +``` diff --git a/SwiftWin32/ContentView.md b/SwiftWin32/ContentView.md new file mode 100644 index 00000000..7666e223 --- /dev/null +++ b/SwiftWin32/ContentView.md @@ -0,0 +1,22 @@ +--- +layout: default +title: ContentView +parent: SwiftWin32 +--- +# ContentView + +The requirements for a content view that you create using a configuration. + +``` swift +public protocol ContentView +``` + +## Requirements + +### configuration + +The current configuration of the view. + +``` swift +var configuration: ContentConfiguration +``` diff --git a/SwiftWin32/ContextMenuConfiguration.md b/SwiftWin32/ContextMenuConfiguration.md new file mode 100644 index 00000000..bc468f73 --- /dev/null +++ b/SwiftWin32/ContextMenuConfiguration.md @@ -0,0 +1,54 @@ +--- +layout: default +title: ContextMenuConfiguration +parent: SwiftWin32 +--- +# ContextMenuConfiguration + +Returns the configuration data to use when previewing the content. + +``` swift +public class ContextMenuConfiguration +``` + +## Nested Type Aliases + +### `ContextMenuContentPreviewProvider` + +Returns the custom view controller to use when previewing your content. + +``` swift +public typealias ContextMenuContentPreviewProvider = () -> ViewController? +``` + +### `ContextMenuActionProvider` + +Returns an action-based contextual menu, optionally incorporating the +system-suggested actions. + +``` swift +public typealias ContextMenuActionProvider = ([MenuElement]) -> Menu? +``` + +## Initializers + +### `init(identifier:previewProvider:actionProvider:)` + +Creates a menu configuration object with the specified action and preview +providers. + +``` swift +public convenience init(identifier: NSCopying?, + previewProvider: ContextMenuContentPreviewProvider?, + actionProvider: ContextMenuActionProvider? = nil) +``` + +## Properties + +### `identifier` + +The unique identifier for this configuration object. + +``` swift +public let identifier: NSCopying +``` diff --git a/SwiftWin32/ContextMenuInteraction.md b/SwiftWin32/ContextMenuInteraction.md new file mode 100644 index 00000000..a16ce7e7 --- /dev/null +++ b/SwiftWin32/ContextMenuInteraction.md @@ -0,0 +1,92 @@ +--- +layout: default +title: ContextMenuInteraction +parent: SwiftWin32 +--- +# ContextMenuInteraction + +An interaction object that you use to display relevant actions for your +content. + +``` swift +public class ContextMenuInteraction: Interaction +``` + +## Inheritance + +[`Interaction`](https://compnerd.github.io/swift-win32/SwiftWin32/Interaction) + +## Initializers + +### `init(delegate:)` + +Creates a context menu interaction object with the specified delegate +object. + +``` swift +public init(delegate: ContextMenuInteractionDelegate) +``` + +## Properties + +### `delegate` + +The object that provides the preview and contextual menu for your content +and responds to interaction-related events. + +``` swift +public private(set) weak var delegate: ContextMenuInteractionDelegate? +``` + +### `view` + +``` swift +public private(set) weak var view: View? +``` + +### `appearance` + +The appearance of the context menu. + +``` swift +public var appearance: ContextMenuInteraction.Appearance = .compact +``` + +## Methods + +### `willMove(to:)` + +``` swift +public func willMove(to view: View?) +``` + +### `didMove(to:)` + +``` swift +public func didMove(to view: View?) +``` + +### `location(in:)` + +Returns the location of the user interaction in the specified view's +coordinate system. + +``` swift +public func location(in view: View?) -> Point +``` + +### `dismissMenu()` + +Dismisses the context menu. + +``` swift +public func dismissMenu() +``` + +### `updateVisibleMenu(_:)` + +Updates the currently visible menu. + +``` swift +public func updateVisibleMenu(_ block: (Menu) -> Menu) +``` diff --git a/SwiftWin32/ContextMenuInteractionAnimating.md b/SwiftWin32/ContextMenuInteractionAnimating.md new file mode 100644 index 00000000..9c20a07b --- /dev/null +++ b/SwiftWin32/ContextMenuInteractionAnimating.md @@ -0,0 +1,41 @@ +--- +layout: default +title: ContextMenuInteractionAnimating +parent: SwiftWin32 +--- +# ContextMenuInteractionAnimating + +Methods adopted by system-supplied animator objects when interacting with +context menus. + +``` swift +public protocol ContextMenuInteractionAnimating +``` + +## Requirements + +### addAnimations(\_:​) + +Adding Custom Animations +Adds the specified animation block to the animator. + +``` swift +func addAnimations(_ animations: @escaping () -> Void) +``` + +### addCompletion(\_:​) + +Adds the specified completion block to the animator. + +``` swift +func addCompletion(_ completion: @escaping () -> Void) +``` + +### previewViewController + +Previewing the Content +The current preview controller. + +``` swift +var previewViewController: ViewController? +``` diff --git a/SwiftWin32/ContextMenuInteractionCommitAnimating.md b/SwiftWin32/ContextMenuInteractionCommitAnimating.md new file mode 100644 index 00000000..0fe39aeb --- /dev/null +++ b/SwiftWin32/ContextMenuInteractionCommitAnimating.md @@ -0,0 +1,27 @@ +--- +layout: default +title: ContextMenuInteractionCommitAnimating +parent: SwiftWin32 +--- +# ContextMenuInteractionCommitAnimating + +Methods adopted by system-supplied animator objects when committing +preview-related animations. + +``` swift +public protocol ContextMenuInteractionCommitAnimating: ContextMenuInteractionAnimating +``` + +## Inheritance + +[`ContextMenuInteractionAnimating`](https://compnerd.github.io/swift-win32/SwiftWin32/ContextMenuInteractionAnimating) + +## Requirements + +### preferredCommitStyle + +Specifying the Commit Style + +``` swift +var preferredCommitStyle: ContextMenuInteractionCommitStyle +``` diff --git a/SwiftWin32/ContextMenuInteractionCommitStyle.md b/SwiftWin32/ContextMenuInteractionCommitStyle.md new file mode 100644 index 00000000..5d3beb41 --- /dev/null +++ b/SwiftWin32/ContextMenuInteractionCommitStyle.md @@ -0,0 +1,34 @@ +--- +layout: default +title: ContextMenuInteractionCommitStyle +parent: SwiftWin32 +--- +# ContextMenuInteractionCommitStyle + +Constants that control the interaction commit style. + +``` swift +public enum ContextMenuInteractionCommitStyle: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `dismiss` + +An interaction with no animations. + +``` swift +case dismiss +``` + +### `pop` + +An interaction that uses animations. + +``` swift +case pop +``` diff --git a/SwiftWin32/ContextMenuInteractionDelegate.md b/SwiftWin32/ContextMenuInteractionDelegate.md new file mode 100644 index 00000000..443d0323 --- /dev/null +++ b/SwiftWin32/ContextMenuInteractionDelegate.md @@ -0,0 +1,123 @@ +--- +layout: default +title: ContextMenuInteractionDelegate +parent: SwiftWin32 +--- +# ContextMenuInteractionDelegate + +The methods for providing the set of actions to perform on your content, +and for customizing the preview of that content. + +``` swift +public protocol ContextMenuInteractionDelegate: AnyObject +``` + +## Inheritance + +`AnyObject` + +## Default Implementations + +### `contextMenuInteraction(_:previewForHighlightingMenuWithConfiguration:)` + +``` swift +public func contextMenuInteraction(_ interaction: ContextMenuInteraction, + previewForHighlightingMenuWithConfiguration configuration: ContextMenuConfiguration) + -> TargetedPreview? +``` + +### `contextMenuInteraction(_:previewForDismissingMenuWithConfiguration:)` + +``` swift +public func contextMenuInteraction(_ interaction: ContextMenuInteraction, + previewForDismissingMenuWithConfiguration configuration: ContextMenuConfiguration) + -> TargetedPreview? +``` + +### `contextMenuInteraction(_:willPerformPreviewActionForMenuWith:animator:)` + +``` swift +public func contextMenuInteraction(_ interaction: ContextMenuInteraction, + willPerformPreviewActionForMenuWith configuration: ContextMenuConfiguration, + animator: ContextMenuInteractionCommitAnimating) +``` + +### `contextMenuInteraction(_:willDisplayMenuFor:animator:)` + +``` swift +public func contextMenuInteraction(_ interaction: ContextMenuInteraction, + willDisplayMenuFor configuration: ContextMenuConfiguration, + animator: ContextMenuInteractionAnimating?) +``` + +### `contextMenuInteraction(_:willEndFor:animator:)` + +``` swift +public func contextMenuInteraction(_ interaction: ContextMenuInteraction, + willEndFor configuration: ContextMenuConfiguration, + animator: ContextMenuInteractionAnimating?) +``` + +## Requirements + +### contextMenuInteraction(\_:​configurationForMenuAtLocation:​) + +Returns the configuration data to use when previewing the content. + +``` swift +func contextMenuInteraction(_ interaction: ContextMenuInteraction, + configurationForMenuAtLocation location: Point) + -> ContextMenuConfiguration? +``` + +### contextMenuInteraction(\_:​previewForHighlightingMenuWithConfiguration:​) + +Returns the source view to use when animating the appearance of the +preview interface. + +``` swift +func contextMenuInteraction(_ interaction: ContextMenuInteraction, + previewForHighlightingMenuWithConfiguration configuration: ContextMenuConfiguration) + -> TargetedPreview? +``` + +### contextMenuInteraction(\_:​previewForDismissingMenuWithConfiguration:​) + +Returns the destination view to use when animating the appearance of the +preview interface. + +``` swift +func contextMenuInteraction(_ interaction: ContextMenuInteraction, + previewForDismissingMenuWithConfiguration configuration: ContextMenuConfiguration) + -> TargetedPreview? +``` + +### contextMenuInteraction(\_:​willPerformPreviewActionForMenuWith:​animator:​) + +Informs the delegate when a preview action begins. + +``` swift +func contextMenuInteraction(_ interaction: ContextMenuInteraction, + willPerformPreviewActionForMenuWith configuration: ContextMenuConfiguration, + animator: ContextMenuInteractionCommitAnimating) +``` + +### contextMenuInteraction(\_:​willDisplayMenuFor:​animator:​) + +Informs the delegate when a menu display begins. + +``` swift +func contextMenuInteraction(_ interaction: ContextMenuInteraction, + willDisplayMenuFor configuration: ContextMenuConfiguration, + animator: ContextMenuInteractionAnimating?) +``` + +### contextMenuInteraction(\_:​willEndFor:​animator:​) + +Informs the delegate when a menu display ends. + +``` swift +func contextMenuInteraction(_ interaction: ContextMenuInteraction, + willEndFor configuration: ContextMenuConfiguration, + animator: ContextMenuInteractionAnimating?) +``` diff --git a/SwiftWin32/ContextMenuInteraction_Appearance.md b/SwiftWin32/ContextMenuInteraction_Appearance.md new file mode 100644 index 00000000..98ebcfa1 --- /dev/null +++ b/SwiftWin32/ContextMenuInteraction_Appearance.md @@ -0,0 +1,42 @@ +--- +layout: default +title: ContextMenuInteraction.Appearance +parent: SwiftWin32 +--- +# ContextMenuInteraction.Appearance + +Constants that describe the appearance of the menu. + +``` swift +public enum Appearance: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `unknown` + +No menu appearance. + +``` swift +case unknown +``` + +### `rich` + +A modal menu with an optional preview. + +``` swift +case rich +``` + +### `compact` + +A nonmodal, compact menu with no preview. + +``` swift +case compact +``` diff --git a/SwiftWin32/ContextualAction.md b/SwiftWin32/ContextualAction.md new file mode 100644 index 00000000..228e72e1 --- /dev/null +++ b/SwiftWin32/ContextualAction.md @@ -0,0 +1,76 @@ +--- +layout: default +title: ContextualAction +parent: SwiftWin32 +--- +# ContextualAction + +An action to display when the user swipes a table row. + +``` swift +public class ContextualAction +``` + +## Nested Type Aliases + +### `Handler` + +The handler block to call in response to the selection of an action. + +``` swift +public typealias Handler = + (ContextualAction, View, @escaping (Bool) -> Void) -> Void +``` + +## Initializers + +### `init(style:title:handler:)` + +Creates a new contextual action with the specified title and handler. + +``` swift +public /*convenience*/ init(style: ContextualAction.Style, title: String?, + handler: @escaping ContextualAction.Handler) +``` + +## Properties + +### `title` + +The title displayed on the action button. + +``` swift +public var title: String? +``` + +### `backgroundColor` + +The background color of the action button. + +``` swift +public let backgroundColor: Color! +``` + +### `image` + +The image to display in the action button. + +``` swift +public var image: Image? +``` + +### `handler` + +The handler block to execute when the user selects the action. + +``` swift +public let handler: ContextualAction.Handler +``` + +### `style` + +The style that is applied to the action button. + +``` swift +public let style: ContextualAction.Style +``` diff --git a/SwiftWin32/ContextualAction_Style.md b/SwiftWin32/ContextualAction_Style.md new file mode 100644 index 00000000..8c2e50cb --- /dev/null +++ b/SwiftWin32/ContextualAction_Style.md @@ -0,0 +1,35 @@ +--- +layout: default +title: ContextualAction.Style +parent: SwiftWin32 +--- +# ContextualAction.Style + +Constants indicating the style information that is applied to the action +button. + +``` swift +public enum Style: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `normal` + +A normal action. + +``` swift +case normal +``` + +### `destructive` + +An action that deletes data or performs some type of destructive task. + +``` swift +case destructive +``` diff --git a/SwiftWin32/Control.md b/SwiftWin32/Control.md new file mode 100644 index 00000000..8b23bb2a --- /dev/null +++ b/SwiftWin32/Control.md @@ -0,0 +1,59 @@ +--- +layout: default +title: Control +parent: SwiftWin32 +--- +# Control + +The base class for controls, which are visual elements that convey a +specific action or intention in response to user interactions. + +``` swift +public class Control: View +``` + +## Inheritance + +[`View`](https://compnerd.github.io/swift-win32/SwiftWin32/View) + +## Properties + +### `allControlEvents` + +Returns the events for which the control has associated actions. + +``` swift +public private(set) var allControlEvents: Control.Event +``` + +## Methods + +### `addTarget(_:action:for:)` + +Associates a target object and action method with the control. + +``` swift +public func addTarget(_ target: Target, + action: @escaping (Target) -> () -> Void, + for controlEvents: Control.Event) +``` + +### `addTarget(_:action:for:)` + +Associates a target object and action method with the control. + +``` swift +public func addTarget(_ target: Target, + action: @escaping (Target) -> (_: Source) -> Void, + for controlEvents: Control.Event) +``` + +### `addTarget(_:action:for:)` + +Associates a target object and action method with the control. + +``` swift +public func addTarget(_ target: Target, + action: @escaping (Target) -> (_: Source, _: Control.Event) -> Void, + for controlEvents: Control.Event) +``` diff --git a/SwiftWin32/Control_Event.md b/SwiftWin32/Control_Event.md new file mode 100644 index 00000000..3af85208 --- /dev/null +++ b/SwiftWin32/Control_Event.md @@ -0,0 +1,215 @@ +--- +layout: default +title: Control.Event +parent: SwiftWin32 +--- +# Control.Event + +Constants describing the types of events possible for controls. + +``` swift +public struct Event: Equatable, Hashable, RawRepresentable +``` + +## Inheritance + +`Equatable`, `Hashable`, `RawRepresentable` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = Int +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `touchDown` + +A touch-down event in the control. + +``` swift +public static var touchDown: Control.Event +``` + +### `touchDownRepeat` + +A repeated touch-down event in the control; for this event the value of +the UITouch tapCount method is greater than one. + +``` swift +public static var touchDownRepeat: Control.Event +``` + +### `touchDragInside` + +An event where a finger is dragged inside the bounds of the control. + +``` swift +public static var touchDragInside: Control.Event +``` + +### `touchDragOutside` + +An event where a finger is dragged just outside the bounds of the control. + +``` swift +public static var touchDragOutside: Control.Event +``` + +### `touchDragEnter` + +An event where a finger is dragged into the bounds of the control. + +``` swift +public static var touchDragEnter: Control.Event +``` + +### `touchDragExit` + +An event where a finger is dragged from within a control to outside its +bounds. + +``` swift +public static var touchDragExit: Control.Event +``` + +### `touchUpInside` + +A touch-up event in the control where the finger is inside the bounds of +the control. + +``` swift +public static var touchUpInside: Control.Event +``` + +### `touchUpOutside` + +A touch-up event in the control where the finger is outside the bounds of +the control. + +``` swift +public static var touchUpOutside: Control.Event +``` + +### `touchCancel` + +A system event canceling the current touches for the control. + +``` swift +public static var touchCancel: Control.Event +``` + +### `valueChanged` + +A touch dragging or otherwise manipulating a control, causing it to emit +a series of different values. + +``` swift +public static var valueChanged: Control.Event +``` + +### `menuActionTriggered` + +A menu action has triggered prior to the menu being presented. + +``` swift +public static var menuActionTriggered: Control.Event +``` + +### `primaryActionTriggered` + +A semantic action triggered by buttons. + +``` swift +public static var primaryActionTriggered: Control.Event +``` + +### `editingDidBegin` + +A touch initiating an editing session in a `TextField` object by entering +its bounds. + +``` swift +public static var editingDidBegin: Control.Event +``` + +### `editingChanged` + +A touch making an editing change in a `TextField` object. + +``` swift +public static var editingChanged: Control.Event +``` + +### `editingDidEnd` + +A touch ending an editing session in a `TextField` object by leaving its +bounds. + +``` swift +public static var editingDidEnd: Control.Event +``` + +### `editingDidEndOnExit` + +A touch ending an editing session in a `TextField` object. + +``` swift +public static var editingDidEndOnExit: Control.Event +``` + +### `allTouchEvents` + +All touch events. + +``` swift +public static var allTouchEvents: Control.Event +``` + +### `allEditingEvents` + +All editing touches for `TextField` objects. + +``` swift +public static var allEditingEvents: Control.Event +``` + +### `applicationReserved` + +A range of control-event values available for application use. + +``` swift +public static var applicationReserved: Control.Event +``` + +### `systemReserved` + +A range of control-event values reserved for internal framework use. + +``` swift +public static var systemReserved: Control.Event +``` + +### `allEvents` + +All events, including system events. + +``` swift +public static var allEvents: Control.Event +``` diff --git a/SwiftWin32/Control_State.md b/SwiftWin32/Control_State.md new file mode 100644 index 00000000..a76afdda --- /dev/null +++ b/SwiftWin32/Control_State.md @@ -0,0 +1,89 @@ +--- +layout: default +title: Control.State +parent: SwiftWin32 +--- +# Control.State + +The state of the control, specified as a bit mask value. + +``` swift +struct State: OptionSet +``` + +## Inheritance + +`OptionSet` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: Int) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: Int +``` + +### `normal` + +The normal, or default state of a control—that is, enabled but neither +selected nor highlighted. + +``` swift +static var normal: Control.State +``` + +### `highlighted` + +Highlighted state of a control. + +``` swift +static var highlighted: Control.State +``` + +### `disabled` + +Disabled state of a control. + +``` swift +static var disabled: Control.State +``` + +### `selected` + +Selected state of a control. + +``` swift +static var selected: Control.State +``` + +### `focused` + +Focused state of a control. + +``` swift +static var focused: Control.State +``` + +### `application` + +Additional control-state flags available for application use. + +``` swift +static var application: Control.State +``` + +### `reserved` + +Control-state flags reserved for internal framework use. + +``` swift +static var reserved: Control.State +``` diff --git a/SwiftWin32/CoordinateSpace.md b/SwiftWin32/CoordinateSpace.md new file mode 100644 index 00000000..53eb3f4e --- /dev/null +++ b/SwiftWin32/CoordinateSpace.md @@ -0,0 +1,62 @@ +--- +layout: default +title: CoordinateSpace +parent: SwiftWin32 +--- +# CoordinateSpace + +A set of methods for converting between different frames of reference on a +screen. + +``` swift +public protocol CoordinateSpace +``` + +## Requirements + +### bounds + +Getting the Bounds Rectangle +The bounds rectangle describing the item's location and size in its own +coordinate system. + +``` swift +var bounds: Rect +``` + +### convert(\_:​to:​) + +Converting Between Coordinate Spaces +Converts a point from the coordinate space of the current object to the +specified coordinate space. + +``` swift +func convert(_: Point, to: CoordinateSpace) -> Point +``` + +### convert(\_:​from:​) + +Converts a point from the specified coordinate space to the coordinate +space of the current object. + +``` swift +func convert(_: Point, from: CoordinateSpace) -> Point +``` + +### convert(\_:​to:​) + +Converts a rectangle from the coordinate space of the current object to +the specified coordinate space. + +``` swift +func convert(_: Rect, to: CoordinateSpace) -> Rect +``` + +### convert(\_:​from:​) + +Converts a rectangle from the specified coordinate space to the coordinate +space of the current object. + +``` swift +func convert(_: Rect, from: CoordinateSpace) -> Rect +``` diff --git a/SwiftWin32/CubicTimingParameters.md b/SwiftWin32/CubicTimingParameters.md new file mode 100644 index 00000000..a5ad29b4 --- /dev/null +++ b/SwiftWin32/CubicTimingParameters.md @@ -0,0 +1,65 @@ +--- +layout: default +title: CubicTimingParameters +parent: SwiftWin32 +--- +# CubicTimingParameters + +The timing information for animations in the form of a cubic Bézier curve. + +``` swift +public class CubicTimingParameters +``` + +## Initializers + +### `init()` + +Initializes the object with the system’s default timing curve. + +``` swift +public init() +``` + +### `init(animationCurve:)` + +Initializes the object with the specified builtin timing curve. + +``` swift +public init(animationCurve curve: View.AnimationCurve) +``` + +### `init(controlPoint1:controlPoint2:)` + +Initializes the object with the specified control points for a cubic +Bézier curve. + +``` swift +public init(controlPoint1 point1: Point, controlPoint2 point2: Point) +``` + +## Properties + +### `animationCurve` + +The standard builtin animation curve to use for timing. + +``` swift +public private(set) var animationCurve: View.AnimationCurve +``` + +### `controlPoint1` + +The first control point for the cubic Bézier curve. + +``` swift +public private(set) var controlPoint1: Point +``` + +### `controlPoint2` + +The second control point of the cubic Bézier curve. + +``` swift +public private(set) var controlPoint2: Point +``` diff --git a/SwiftWin32/DatePicker.md b/SwiftWin32/DatePicker.md new file mode 100644 index 00000000..dec16651 --- /dev/null +++ b/SwiftWin32/DatePicker.md @@ -0,0 +1,55 @@ +--- +layout: default +title: DatePicker +parent: SwiftWin32 +--- +# DatePicker + +``` swift +public class DatePicker: Control +``` + +## Inheritance + +[`Control`](https://compnerd.github.io/swift-win32/SwiftWin32/Control) + +## Initializers + +### `init(frame:)` + +``` swift +public init(frame: Rect) +``` + +## Properties + +### `date` + +The date displayed by the date picker. + +``` swift +public var date: Date +``` + +### `datePickerStyle` + +``` swift +public private(set) var datePickerStyle: DatePickerStyle = .inline +``` + +### `preferredDatePickerStyle` + +``` swift +public private(set) var preferredDatePickerStyle: DatePickerStyle = .automatic +``` + +## Methods + +### `setDate(_:animated:)` + +Sets the date to display in the date picker, with an option to animate the +setting. + +``` swift +public func setDate(_ date: Date, animated: Bool) +``` diff --git a/SwiftWin32/DatePickerStyle.md b/SwiftWin32/DatePickerStyle.md new file mode 100644 index 00000000..e410e615 --- /dev/null +++ b/SwiftWin32/DatePickerStyle.md @@ -0,0 +1,40 @@ +--- +layout: default +title: DatePickerStyle +parent: SwiftWin32 +--- +# DatePickerStyle + +``` swift +public enum DatePickerStyle: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `automatic` + +``` swift +case automatic +``` + +### `wheels` + +``` swift +case wheels +``` + +### `compact` + +``` swift +case compact +``` + +### `inline` + +``` swift +case inline +``` diff --git a/SwiftWin32/Device.md b/SwiftWin32/Device.md new file mode 100644 index 00000000..a67b9446 --- /dev/null +++ b/SwiftWin32/Device.md @@ -0,0 +1,174 @@ +--- +layout: default +title: Device +parent: SwiftWin32 +--- +# Device + +``` swift +public struct Device +``` + +## Properties + +### `current` + +``` swift +public static let current: Device +``` + +### `isMultitaskingSupported` + +Is multitasking supported on the current device + +``` swift +public internal(set) var isMultitaskingSupported: Bool = true +``` + +### `name` + +The name identifyying the device + +``` swift +public var name: String +``` + +### `systemName` + +The name of the operating system running on the device represented by the + +``` swift +public var systemName: String +``` + +### `systemVersion` + +The current version of the operating system. + +``` swift +public var systemVersion: String +``` + +### `model` + +The model of the device. + +``` swift +public var model: String +``` + +### `localizedModel` + +``` swift +public var localizedModel: String +``` + +### `userInterfaceIdiom` + +The style of interface to use on the current device. + +``` swift +public var userInterfaceIdiom: UserInterfaceIdiom +``` + +### `identifierForVendor` + +An alphanumeric string that uniquely identifies a device to the +application vendor. + +``` swift +public var identifierForVendor: UUID? +``` + +### `orientation` + +Tracking the Device Orientation + +``` swift +public var orientation: Device.Orientation +``` + +### `isGeneratingDeviceOrientationNotifications` + +``` swift +public private(set) var isGeneratingDeviceOrientationNotifications: Bool = + false +``` + +### `isPortrait` + +Determining the Current Orientation + +``` swift +public var isPortrait: Bool +``` + +### `isLandscape` + +``` swift +public var isLandscape: Bool +``` + +### `isValidIntefaceOrientation` + +``` swift +public var isValidIntefaceOrientation: Bool +``` + +### `batteryLevel` + +Getting the Device Battery State + +``` swift +public var batteryLevel: Float +``` + +### `isBatteryMonitoringEnabled` + +``` swift +public var isBatteryMonitoringEnabled: Bool = false +``` + +### `batteryState` + +``` swift +public var batteryState: Device.BatteryState +``` + +### `batteryLevelDidChangeNotification` + +``` swift +public static var batteryLevelDidChangeNotification: NSNotification.Name +``` + +### `batteryStateDidChangeNotification` + +``` swift +public static var batteryStateDidChangeNotification: NSNotification.Name +``` + +### `orientationDidChangeNotification` + +``` swift +public static var orientationDidChangeNotification: NSNotification.Name +``` + +### `proximityStateDidChangeNotification` + +``` swift +public static var proximityStateDidChangeNotification: NSNotification.Name +``` + +## Methods + +### `beginGeneratingDeviceOrientationNotifications()` + +``` swift +public func beginGeneratingDeviceOrientationNotifications() +``` + +### `endGeneratingDeviceOrientationNotifications()` + +``` swift +public func endGeneratingDeviceOrientationNotifications() +``` diff --git a/SwiftWin32/Device_BatteryState.md b/SwiftWin32/Device_BatteryState.md new file mode 100644 index 00000000..ddf166ef --- /dev/null +++ b/SwiftWin32/Device_BatteryState.md @@ -0,0 +1,40 @@ +--- +layout: default +title: Device.BatteryState +parent: SwiftWin32 +--- +# Device.BatteryState + +``` swift +public enum BatteryState: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `unknown` + +``` swift +case unknown +``` + +### `unplugged` + +``` swift +case unplugged +``` + +### `charging` + +``` swift +case charging +``` + +### `full` + +``` swift +case full +``` diff --git a/SwiftWin32/Device_Orientation.md b/SwiftWin32/Device_Orientation.md new file mode 100644 index 00000000..ce119122 --- /dev/null +++ b/SwiftWin32/Device_Orientation.md @@ -0,0 +1,58 @@ +--- +layout: default +title: Device.Orientation +parent: SwiftWin32 +--- +# Device.Orientation + +``` swift +public enum Orientation: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `unknown` + +``` swift +case unknown +``` + +### `portrait` + +``` swift +case portrait +``` + +### `portraitUpsideDown` + +``` swift +case portraitUpsideDown +``` + +### `landscapeLeft` + +``` swift +case landscapeLeft +``` + +### `landscapeRight` + +``` swift +case landscapeRight +``` + +### `faceUp` + +``` swift +case faceUp +``` + +### `faceDown` + +``` swift +case faceDown +``` diff --git a/SwiftWin32/DirectionalEdgeInsets.md b/SwiftWin32/DirectionalEdgeInsets.md new file mode 100644 index 00000000..221d5959 --- /dev/null +++ b/SwiftWin32/DirectionalEdgeInsets.md @@ -0,0 +1,86 @@ +--- +layout: default +title: DirectionalEdgeInsets +parent: SwiftWin32 +--- +# DirectionalEdgeInsets + +Edge insets that take language direction into account. + +``` swift +public struct DirectionalEdgeInsets +``` + +## Initializers + +### `init()` + +Initializes the edge inset struct to default values. + +``` swift +public init() +``` + +## Properties + +### `bottom` + +The bottom edge inset value. + +``` swift +public var bottom: Double +``` + +### `leading` + +The leading edge inset value. + +``` swift +public var leading: Double +``` + +### `top` + +The top edge inset value. + +``` swift +public var top: Double +``` + +### `trailing` + +The trailing edge inset value. + +``` swift +public var trailing: Double +``` + +### `zero` + +A directional edge insets struct whose top, leading, bottom, and trailing +fields are all set to 0. + +``` swift +public static var zero: DirectionalEdgeInsets +``` + +## Methods + +### `string(for:)` + +Returns a string formatted to contain the data from a directional edge +insets structure. + +``` swift +public static func string(for insets: DirectionalEdgeInsets) -> String +``` + +### `directionalEdgeInsets(for:)` + +Returns a directional edge insets structure based on the data in the +specified string. + +``` swift +public static func directionalEdgeInsets(for: String) + -> DirectionalEdgeInsets +``` diff --git a/SwiftWin32/DirectionalRectEdge.md b/SwiftWin32/DirectionalRectEdge.md new file mode 100644 index 00000000..599e5989 --- /dev/null +++ b/SwiftWin32/DirectionalRectEdge.md @@ -0,0 +1,81 @@ +--- +layout: default +title: DirectionalRectEdge +parent: SwiftWin32 +--- +# DirectionalRectEdge + +Constants that specify an edge or a set of edges, taking the user interface +layout direction into account. + +``` swift +public struct DirectionalRectEdge: OptionSet +``` + +## Inheritance + +`OptionSet` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: UInt) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: UInt +``` + +### `none` + +No specified edge. + +``` swift +public static var none: DirectionalRectEdge +``` + +### `top` + +The top edge. + +``` swift +public static var top: DirectionalRectEdge +``` + +### `leading` + +The leading edge. + +``` swift +public static var leading: DirectionalRectEdge +``` + +### `bottom` + +The bottom edge. + +``` swift +public static var bottom: DirectionalRectEdge +``` + +### `trailing` + +The trailing edge. + +``` swift +public static var trailing: DirectionalRectEdge +``` + +### `all` + +All edges. + +``` swift +public static var all: DirectionalRectEdge +``` diff --git a/SwiftWin32/DisplayGamut.md b/SwiftWin32/DisplayGamut.md new file mode 100644 index 00000000..32182f46 --- /dev/null +++ b/SwiftWin32/DisplayGamut.md @@ -0,0 +1,42 @@ +--- +layout: default +title: DisplayGamut +parent: SwiftWin32 +--- +# DisplayGamut + +Constants that indicate the gamut of the current display. + +``` swift +public enum DisplayGamut: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `unspecified` + +An unspecified gamut value. + +``` swift +case unspecified +``` + +### `SRGB` + +The sRGB display gamut. + +``` swift +case SRGB +``` + +### `P3` + +The P3 display gamut. + +``` swift +case P3 +``` diff --git a/SwiftWin32/EdgeInsets.md b/SwiftWin32/EdgeInsets.md new file mode 100644 index 00000000..5e6e3a51 --- /dev/null +++ b/SwiftWin32/EdgeInsets.md @@ -0,0 +1,68 @@ +--- +layout: default +title: EdgeInsets +parent: SwiftWin32 +--- +# EdgeInsets + +``` swift +public class EdgeInsets +``` + +## Inheritance + +`Equatable` + +## Initializers + +### `init()` + +``` swift +public init() +``` + +### `init(top:left:bottom:right:)` + +``` swift +public init(top: Double, left: Double, bottom: Double, right: Double) +``` + +## Properties + +### `zero` + +``` swift +public static let zero: EdgeInsets +``` + +### `bottom` + +``` swift +public let bottom: Double +``` + +### `left` + +``` swift +public let left: Double +``` + +### `right` + +``` swift +public let right: Double +``` + +### `top` + +``` swift +public let top: Double +``` + +## Operators + +### `==` + +``` swift +public static func == (_ lhs: EdgeInsets, _ rhs: EdgeInsets) -> Bool +``` diff --git a/SwiftWin32/Event.md b/SwiftWin32/Event.md new file mode 100644 index 00000000..f2d1db60 --- /dev/null +++ b/SwiftWin32/Event.md @@ -0,0 +1,104 @@ +--- +layout: default +title: Event +parent: SwiftWin32 +--- +# Event + +An object that describes a single user interaction with your app. + +``` swift +open class Event +``` + +## Properties + +### `allTouches` + +Returns all touches associated with the event. + +``` swift +open private(set) var allTouches: Set? +``` + +### `timestamp` + +The time when the event occurred. + +``` swift +open private(set) var timestamp: TimeInterval +``` + +### `type` + +Returns the type of the event. + +``` swift +open private(set) var type: Event.EventType +``` + +### `subtype` + +Returns the subtype of the event. + +``` swift +open private(set) var subtype: Event.EventSubtype +``` + +### `buttonMask` + +``` swift +open private(set) var buttonMask: Event.ButtonMask +``` + +### `modifierFlags` + +``` swift +open private(set) var modifierFlags: KeyModifierFlags +``` + +## Methods + +### `touches(for:)` + +Returns the touch objects from the event that belong to the specified +given view. + +``` swift +open func touches(for view: View) -> Set? +``` + +### `touches(for:)` + +Returns the touch objects from the event that belong to the specified +window. + +``` swift +open func touches(for window: Window) -> Set? +``` + +### `coalescedTouches(for:)` + +Returns all of the touches associated with the specified main touch. + +``` swift +open func coalescedTouches(for touch: Touch) -> [Touch]? +``` + +### `predictedTouches(for:)` + +Returns an array of touches that are predicted to occur for the specified +touch. + +``` swift +open func predictedTouches(for touch: Touch) -> [Touch]? +``` + +### `touches(for:)` + +Returns the touch objects that are being delivered to the specified +gesture recognizer. + +``` swift +open func touches(for gesture: GestureRecognizer) -> Set? +``` diff --git a/SwiftWin32/Event_ButtonMask.md b/SwiftWin32/Event_ButtonMask.md new file mode 100644 index 00000000..53164042 --- /dev/null +++ b/SwiftWin32/Event_ButtonMask.md @@ -0,0 +1,63 @@ +--- +layout: default +title: Event.ButtonMask +parent: SwiftWin32 +--- +# Event.ButtonMask + +Set of buttons pressed for the current event + +``` swift +public struct ButtonMask: OptionSet +``` + +## Inheritance + +`OptionSet` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = Int +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: Int) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `primary` + +``` swift +public static var primary: ButtonMask +``` + +### `secondary` + +``` swift +public static var secondary: ButtonMask +``` + +## Methods + +### `button(_:)` + +Convenience initializer for a button mask where `buttonNumber` is a +one-based index of the button on the input device + +``` swift +public static func button(_ buttonNumber: Int) -> ButtonMask +``` diff --git a/SwiftWin32/Event_EventSubtype.md b/SwiftWin32/Event_EventSubtype.md new file mode 100644 index 00000000..80c63076 --- /dev/null +++ b/SwiftWin32/Event_EventSubtype.md @@ -0,0 +1,42 @@ +--- +layout: default +title: Event.EventSubtype +parent: SwiftWin32 +--- +# Event.EventSubtype + +Specifies the subtype of the event in relation to its general type. + +``` swift +public enum EventSubtype: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `none` + +The event has no subtype. + +``` swift +case none +``` + +### `motionShake` + +The event is related to the user shaking the device. + +``` swift +case motionShake +``` + +### `remoteControlPlay` + +A remote-control event for playing audio or video. + +``` swift +case remoteControlPlay +``` diff --git a/SwiftWin32/Event_EventType.md b/SwiftWin32/Event_EventType.md new file mode 100644 index 00000000..a354382e --- /dev/null +++ b/SwiftWin32/Event_EventType.md @@ -0,0 +1,50 @@ +--- +layout: default +title: Event.EventType +parent: SwiftWin32 +--- +# Event.EventType + +Specifies the general type of event. + +``` swift +public enum EventType: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `touches` + +The event is related to touches on the screen. + +``` swift +case touches +``` + +### `motion` + +The event is related to motion of the device. + +``` swift +case motion +``` + +### `remoteControl` + +The event is a remote-control event. + +``` swift +case remoteControl +``` + +### `presses` + +The event is related to the press of a physical button. + +``` swift +case presses +``` diff --git a/SwiftWin32/FocusAnimationContext.md b/SwiftWin32/FocusAnimationContext.md new file mode 100644 index 00000000..f2bc28ae --- /dev/null +++ b/SwiftWin32/FocusAnimationContext.md @@ -0,0 +1,22 @@ +--- +layout: default +title: FocusAnimationContext +parent: SwiftWin32 +--- +# FocusAnimationContext + +Information about focusing animations being performed by the system. + +``` swift +public protocol FocusAnimationContext +``` + +## Requirements + +### duration + +The duration (measured in seconds) of the focus animation. + +``` swift +var duration: TimeInterval +``` diff --git a/SwiftWin32/FocusAnimationCoordinator.md b/SwiftWin32/FocusAnimationCoordinator.md new file mode 100644 index 00000000..421d66c0 --- /dev/null +++ b/SwiftWin32/FocusAnimationCoordinator.md @@ -0,0 +1,43 @@ +--- +layout: default +title: FocusAnimationCoordinator +parent: SwiftWin32 +--- +# FocusAnimationCoordinator + +A coordinator of focus-related animations during a focus update. + +``` swift +public class FocusAnimationCoordinator +``` + +## Methods + +### `addCoordinatedFocusingAnimations(_:completion:)` + +Runs the specified set of animations together with the system animations +for adding focus to an item. + +``` swift +public func addCoordinatedFocusingAnimations(_ animations: ((FocusAnimationContext) -> Void)?, + completion: (() -> Void)? = nil) +``` + +### `addCoordinatedUnfocusingAnimations(_:completion:)` + +Runs the specified set of animations together with the system animations +for removing focus from an item. + +``` swift +public func addCoordinatedUnfocusingAnimations(_ animations: ((FocusAnimationContext) -> Void)?, + completion: (() -> Void)? = nil) +``` + +### `addCoordinatedAnimations(_:completion:)` + +Specifies the animations to coordinate with the active focus animation. + +``` swift +public func addCoordinatedAnimations(_ animations: (() -> Void)?, + completion: (() -> Void)? = nil) +``` diff --git a/SwiftWin32/FocusEnvironment.md b/SwiftWin32/FocusEnvironment.md new file mode 100644 index 00000000..7c4136b2 --- /dev/null +++ b/SwiftWin32/FocusEnvironment.md @@ -0,0 +1,119 @@ +--- +layout: default +title: FocusEnvironment +parent: SwiftWin32 +--- +# FocusEnvironment + +A set of methods that define the focus behavior for a branch of the view +hierarchy. + +``` swift +public protocol FocusEnvironment: AnyObject +``` + +## Inheritance + +`AnyObject` + +## Default Implementations + +### `soundIdentifierForFocusUpdate(in:)` + +``` swift +public func soundIdentifierForFocusUpdate(in context: FocusUpdateContext) + -> FocusSoundIdentifier? +``` + +### `focusGroupIdentifier` + +``` swift +public var focusGroupIdentifier: String? +``` + +## Requirements + +### setNeedsFocusUpdate() + +Submits a request to the focus engine for a focus update in this +environment. + +``` swift +func setNeedsFocusUpdate() +``` + +### updateFocusIfNeeded() + +Tells the focus engine to force a focus update immediately. + +``` swift +func updateFocusIfNeeded() +``` + +### shouldUpdateFocus(in:​) + +Returns a boolean value indicating whether the focus engine should allow +the focus update described by the specified context to occur. + +``` swift +func shouldUpdateFocus(in context: FocusUpdateContext) -> Bool +``` + +### didUpdateFocus(in:​with:​) + +Called immediately after the system updates the focus to a new view. + +``` swift +func didUpdateFocus(in context: FocusUpdateContext, + with coordinator: FocusAnimationCoordinator) +``` + +### preferredFocusEnvironments + +An array of focus environments, ordered by priority, to which this +environment prefers focus to be directed during a focus update. + +``` swift +var preferredFocusEnvironments: [FocusEnvironment] +``` + +### soundIdentifierForFocusUpdate(in:​) + +Asks the delegate for the identifier of the sound to play when the object +gains focus. + +``` swift +func soundIdentifierForFocusUpdate(in context: FocusUpdateContext) + -> FocusSoundIdentifier? +``` + +### contains(\_:​) + +Returns a boolean value indicating whether the focus environment contains +the specified environment. + +``` swift +func contains(_ environment: FocusEnvironment) -> Bool +``` + +### parentFocusEnvironment + +The parent focus environment for this environment. + +``` swift +var parentFocusEnvironment: FocusEnvironment? +``` + +### focusItemContainer + +The container for the child focus items in this focus environment. + +``` swift +var focusItemContainer: FocusItemContainer? +``` + +### focusGroupIdentifier + +``` swift +var focusGroupIdentifier: String? +``` diff --git a/SwiftWin32/FocusHeading.md b/SwiftWin32/FocusHeading.md new file mode 100644 index 00000000..2a4514e4 --- /dev/null +++ b/SwiftWin32/FocusHeading.md @@ -0,0 +1,88 @@ +--- +layout: default +title: FocusHeading +parent: SwiftWin32 +--- +# FocusHeading + +The general type of an event. + +``` swift +public struct FocusHeading: OptionSet +``` + +## Inheritance + +`OptionSet` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = UInt +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `up` + +The focus update is heading in the up direction. + +``` swift +public static var up: FocusHeading +``` + +### `down` + +The focus update is heading in the down direction. + +``` swift +public static var down: FocusHeading +``` + +### `left` + +The focus update is heading in the left direction. + +``` swift +public static var left: FocusHeading +``` + +### `right` + +The focus update is heading in the right direction. + +``` swift +public static var right: FocusHeading +``` + +### `next` + +The focus update is heading to the next item. + +``` swift +public static var next: FocusHeading +``` + +### `previous` + +The focus update is heading to the previous item. + +``` swift +public static var previous: FocusHeading +``` diff --git a/SwiftWin32/FocusItem.md b/SwiftWin32/FocusItem.md new file mode 100644 index 00000000..b3dca48a --- /dev/null +++ b/SwiftWin32/FocusItem.md @@ -0,0 +1,62 @@ +--- +layout: default +title: FocusItem +parent: SwiftWin32 +--- +# FocusItem + +An object that can become focused. + +``` swift +public protocol FocusItem: FocusEnvironment +``` + +## Inheritance + +[`FocusEnvironment`](https://compnerd.github.io/swift-win32/SwiftWin32/FocusEnvironment) + +## Default Implementations + +### `isFocused` + +``` swift +public var isFocused: Bool +``` + +### `didHintFocusMovement(_:)` + +``` swift +public func didHintFocusMovement(_ hint: FocusMovementHint) +``` + +## Requirements + +### canBecomeFocused + +A boolean value that indicates whether the item can become focused. + +``` swift +var canBecomeFocused: Bool +``` + +### isFocused + +A boolean value indicating whether the item is currently focused. + +``` swift +var isFocused: Bool +``` + +### frame + +The geometric frame of the item. + +``` swift +var frame: Rect +``` + +### didHintFocusMovement(\_:​) + +``` swift +func didHintFocusMovement(_ hint: FocusMovementHint) +``` diff --git a/SwiftWin32/FocusItemContainer.md b/SwiftWin32/FocusItemContainer.md new file mode 100644 index 00000000..205696d0 --- /dev/null +++ b/SwiftWin32/FocusItemContainer.md @@ -0,0 +1,33 @@ +--- +layout: default +title: FocusItemContainer +parent: SwiftWin32 +--- +# FocusItemContainer + +The container responsible for providing geometric context to focus items +within a given focus environment. + +``` swift +public protocol FocusItemContainer +``` + +## Requirements + +### focusItems(in:​) + +Retrieves all of the focus items within this container that intersect with +the provided rectangle. + +``` swift +func focusItems(in rect: Rect) -> [FocusItem] +``` + +### coordinateSpace + +The coordinate space of the focus items contained in the focus item +container. + +``` swift +var coordinateSpace: CoordinateSpace +``` diff --git a/SwiftWin32/FocusMovementHint.md b/SwiftWin32/FocusMovementHint.md new file mode 100644 index 00000000..6cfa8939 --- /dev/null +++ b/SwiftWin32/FocusMovementHint.md @@ -0,0 +1,57 @@ +--- +layout: default +title: FocusMovementHint +parent: SwiftWin32 +--- +# FocusMovementHint + +Provides movement hint information for the focused item. + +``` swift +public class FocusMovementHint +``` + +## Properties + +### `movementDirection` + +A vector representing how close focus is to moving to another item in the +swiped direction. + +``` swift +public private(set) var movementDirection: Vector +``` + +### `interactionTransform` + +A 3D transform that contains the combined transformations of perspective, +rotation, and translation. + +``` swift +public private(set) var interactionTransform: Transform3D +``` + +### `perspectiveTransform` + +A 3D transform that represents a perspective matrix to be applied to match +the system interaction hinting. + +``` swift +public private(set) var perspectiveTransform: Transform3D +``` + +### `rotation` + +A vector to apply to a transform to match system interaction hinting. + +``` swift +public private(set) var rotation: Vector +``` + +### `translation` + +A vector to apply to a transform to match system interaction hinting. + +``` swift +public private(set) var translation: Vector +``` diff --git a/SwiftWin32/FocusSoundIdentifier.md b/SwiftWin32/FocusSoundIdentifier.md new file mode 100644 index 00000000..a3d8fb69 --- /dev/null +++ b/SwiftWin32/FocusSoundIdentifier.md @@ -0,0 +1,62 @@ +--- +layout: default +title: FocusSoundIdentifier +parent: SwiftWin32 +--- +# FocusSoundIdentifier + +An identifier for a focus-related sound. + +``` swift +public struct FocusSoundIdentifier: Equatable, Hashable, RawRepresentable +``` + +## Inheritance + +`Equatable`, `Hashable`, `RawRepresentable` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = String +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +### `init(_:)` + +``` swift +public init(_ rawValue: String) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `` `default` `` + +The identifier for the default system sound to play during focus updates. + +``` swift +public static var `default`: FocusSoundIdentifier +``` + +### `none` + +The identifier for disabling sound during a focus update. + +``` swift +public static var none: FocusSoundIdentifier +``` diff --git a/SwiftWin32/FocusUpdateContext.md b/SwiftWin32/FocusUpdateContext.md new file mode 100644 index 00000000..6138414e --- /dev/null +++ b/SwiftWin32/FocusUpdateContext.md @@ -0,0 +1,87 @@ +--- +layout: default +title: FocusUpdateContext +parent: SwiftWin32 +--- +# FocusUpdateContext + +An object that provides information relevant to a specific focus update from +one view to another. + +``` swift +public class FocusUpdateContext +``` + +## Properties + +### `previouslyFocusedView` + +The view that was focused before the focus update. + +``` swift +public private(set) weak var previouslyFocusedView: View? +``` + +### `nextFocusedView` + +The view that takes the focus after the focus update. + +``` swift +public private(set) weak var nextFocusedView: View? +``` + +### `focusHeading` + +The heading in which the focus update is occurring. + +``` swift +public private(set) var focusHeading: FocusHeading = .none +``` + +### `previouslyFocusedItem` + +The item that was focused before the update. + +``` swift +public private(set) weak var previouslyFocusedItem: FocusItem? +``` + +### `nextFocusedItem` + +The item to be focused after the update. + +``` swift +public private(set) weak var nextFocusedItem: FocusItem? +``` + +### `didUpdateNotification` + +The focus for the UI has been updated. + +``` swift +public static var didUpdateNotification: NSNotification.Name +``` + +### `movementDidFailNotification` + +The focus failed to move to another item. + +``` swift +public static var movementDidFailNotification: NSNotification.Name +``` + +### `animationCoordinatorUserInfoKey` + +Updates the animation coordinator. + +``` swift +public static var animationCoordinatorUserInfoKey: String +``` + +### `focusUpdateContextUserInfoKey` + +Updates the context key. + +``` swift +public static var focusUpdateContextUserInfoKey: String +``` diff --git a/SwiftWin32/Font.md b/SwiftWin32/Font.md new file mode 100644 index 00000000..d0b80300 --- /dev/null +++ b/SwiftWin32/Font.md @@ -0,0 +1,216 @@ +--- +layout: default +title: Font +parent: SwiftWin32 +--- +# Font + +Represents a font. + +``` swift +public class Font +``` + +## Initializers + +### `init?(name:size:)` + +Creates an returns a font object for the specified font name and size. + +``` swift +public init?(name: String, size: Double) +``` + +## Properties + +### `familyNames` + +Returns an array of font family names available on the system. + +``` swift +public static var familyNames: [String] +``` + +### `fontName` + +The font face name. + +``` swift +public var fontName: String +``` + +### `pointSize` + +The font's point size, or the effective vertical point size for a font +with a non-standard matrix. + +``` swift +public var pointSize: Double +``` + +### `ascender` + +The top y-coordinate, offset from the baseline, of the font's longest +ascender. + +``` swift +public var ascender: Double +``` + +### `descender` + +The bottom y-coordinate, offset from the baseline, of the font's longest +descender. + +``` swift +public var descender: Double +``` + +### `leading` + +The font's leading information. + +``` swift +public var leading: Double +``` + +### `capHeight` + +The font's cap height information. + +``` swift +public var capHeight: Double +``` + +### `xHeight` + +The x-height of the font. + +``` swift +public var xHeight: Double +``` + +### `labelFontSize` + +The height, in points, of text lines. +The standard font size, in points, for labels. + +``` swift +public static var labelFontSize: Double +``` + +### `buttonFontSize` + +The standard font size, in points, for buttons. + +``` swift +public static var buttonFontSize: Double +``` + +### `smallSystemFontSize` + +The size, in points, of the standard small system font. + +``` swift +public static var smallSystemFontSize: Double +``` + +### `systemFontSize` + +The size, in points, of the standard system font. + +``` swift +public static var systemFontSize: Double +``` + +## Methods + +### `preferredFont(forTextStyle:)` + +Returns an instance of the system font for the specified text style with +scaling for the user's selected content size category. + +``` swift +public static func preferredFont(forTextStyle style: Font.TextStyle) -> Font +``` + +### `preferredFont(forTextStyle:compatibleWith:)` + +Returns an instance of the system font for the appropriate text style and +traits. + +``` swift +public static func preferredFont(forTextStyle style: Font.TextStyle, + compatibleWith traits: TraitCollection?) + -> Font +``` + +### `withSize(_:)` + +``` swift +public func withSize(_ fontSize: Double) -> Font +``` + +### `systemFont(ofSize:)` + +Returns the font object for standard interface items in the specified +size. + +``` swift +public static func systemFont(ofSize fontSize: Double) -> Font +``` + +### `systemFont(ofSize:weight:)` + +Returns the font object for standard interface items in the specifed size +and weight. + +``` swift +public static func systemFont(ofSize fontSize: Double, weight: Font.Weight) + -> Font +``` + +### `boldSystemFont(ofSize:)` + +Returns the font object for standard interface items in boldface type in +the specified size. + +``` swift +public static func boldSystemFont(ofSize fontSize: Double) -> Font +``` + +### `italicSystemFont(ofSize:)` + +Returns the font object for standard interface items in italic type in the +specified size. + +``` swift +public static func italicSystemFont(ofSize fontSize: Double) -> Font +``` + +### `monospacedSystemFont(ofSize:weight:)` + +Returns the fixed-width font for standard interface text in the specified +size. + +``` swift +public static func monospacedSystemFont(ofSize fontSize: Double, + weight: Font.Weight) -> Font +``` + +### `monospacedDigitSystemFont(ofSize:weight:)` + +Returns the standard system font with all digits of consistent width. + +``` swift +public static func monospacedDigitSystemFont(ofSize fontSize: Double, + weight: Font.Weight) -> Font +``` + +### `fontNames(forFontFamily:)` + +Returns an array of font names available in a particular font family. + +``` swift +public static func fontNames(forFontFamily family: String) -> [String] +``` diff --git a/SwiftWin32/FontDescriptor.md b/SwiftWin32/FontDescriptor.md new file mode 100644 index 00000000..2df37055 --- /dev/null +++ b/SwiftWin32/FontDescriptor.md @@ -0,0 +1,202 @@ +--- +layout: default +title: FontDescriptor +parent: SwiftWin32 +--- +# FontDescriptor + +A collection of attributes that describes a font. + +``` swift +public class FontDescriptor +``` + +## Nested Type Aliases + +### `Class` + +Constants that classify certain stylistic qualities of the font. + +``` swift +public typealias Class = Int +``` + +## Initializers + +### `init(name:matrix:)` + +Returns a font descriptor with the specified values for name and matrix +dictionary attributes. + +``` swift +public init(name fontName: String, matrix: AffineTransform) +``` + +### `init(name:size:)` + +Returns a font descriptor with the specified values for the name and size +dictionary attributes. + +``` swift +public init(name fontName: String, size: Double) +``` + +### `init(fontAttributes:)` + +Initializing a Font Descriptor +Creates a font descriptor with the specified attributes. + +``` swift +public init(fontAttributes attributes: [FontDescriptor.AttributeName:Any] = [:]) +``` + +## Properties + +### `fontAttributes` + +Querying a Font Descriptor +The font descriptor's dictionary of attributes. + +``` swift +public private(set) var fontAttributes: [FontDescriptor.AttributeName:Any] = [:] +``` + +### `matrix` + +The current transform matrix of the font decriptor. + +``` swift +public var matrix: AffineTransform +``` + +### `pointSize` + +The point size of the font descriptor. + +``` swift +public var pointSize: Double +``` + +### `postscriptName` + +The PostScript name of the font descriptor. + +``` swift +public var postscriptName: String +``` + +### `symbolicTraits` + +The traits of the font descriptor. + +``` swift +public var symbolicTraits: FontDescriptor.SymbolicTraits +``` + +## Methods + +### `preferredFontDescriptor(withTextStyle:)` + +Creating a Font Descriptor +Returns a font descriptor that contains the specified text style and the +user's selected content size category. + +``` swift +public static func preferredFontDescriptor(withTextStyle style: Font.TextStyle) + -> FontDescriptor +``` + +### `preferredFontDescriptor(withTextStyle:compatibleWith:)` + +Returns a font descriptor that contains the text style and the content +size category the provided trait collection specifies. + +``` swift +public static func preferredFontDescriptor(withTextStyle style: Font.TextStyle, + compatibleWith traitCollection: TraitCollection?) + -> FontDescriptor +``` + +### `addingAttributes(_:)` + +Returns a new font descriptor that is the same as the existing descriptor, +but with the specified attributes taking precedence over the existing +ones. + +``` swift +public func addingAttributes(_ attributes: [FontDescriptor.AttributeName:Any] = [:]) + -> FontDescriptor +``` + +### `withDesign(_:)` + +Returns a new font descriptor that is the same as the existing descriptor, +but with the specified design. + +``` swift +public func withDesign(_ design: FontDescriptor.SystemDesign) + -> FontDescriptor? +``` + +### `withFamily(_:)` + +Returns a new font descriptor that is the same as the existing descriptor, +but with the specified family. + +``` swift +public func withFamily(_ newFamily: String) -> FontDescriptor +``` + +### `withFace(_:)` + +Returns a new font descriptor that is the same as the existing descriptor, +but with the specified font face. + +``` swift +public func withFace(_ newFace: String) -> FontDescriptor +``` + +### `withMatrix(_:)` + +Returns a new font descriptor that is the same as the existing descriptor, +but with the specified matrix. + +``` swift +public func withMatrix(_ matrix: AffineTransform) -> FontDescriptor +``` + +### `withSize(_:)` + +Returns a new font descriptor that is the same as the existing descriptor, +but with the specified size. + +``` swift +public func withSize(_ newPointSize: Double) -> FontDescriptor +``` + +### `withSymbolicTraits(_:)` + +Returns a new font descriptor that is the same as the existing descriptor, +but with the specified symbolic traits. + +``` swift +public func withSymbolicTraits(_ symbolicTraits: FontDescriptor.SymbolicTraits) + -> FontDescriptor? +``` + +### `matchingFontDescriptors(withMandatoryKeys:)` + +Finding Fonts +Returns all the fonts available in the system with the specified +attributes. + +``` swift +public func matchingFontDescriptors(withMandatoryKeys mandatoryKeys: Set?) + -> [FontDescriptor] +``` + +### `object(forKey:)` + +``` swift +public func object(forKey attribute: FontDescriptor.AttributeName) -> Any? +``` diff --git a/SwiftWin32/FontDescriptor_AttributeName.md b/SwiftWin32/FontDescriptor_AttributeName.md new file mode 100644 index 00000000..d1b32dea --- /dev/null +++ b/SwiftWin32/FontDescriptor_AttributeName.md @@ -0,0 +1,144 @@ +--- +layout: default +title: FontDescriptor.AttributeName +parent: SwiftWin32 +--- +# FontDescriptor.AttributeName + +Constants that describe font attributes. + +``` swift +public struct AttributeName: Equatable, Hashable, RawRepresentable +``` + +## Inheritance + +`Equatable`, `Hashable`, `RawRepresentable` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = String +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `cascadeList` + +The cascading list attribute. + +``` swift +public static var cascadeList: FontDescriptor.AttributeName +``` + +### `characterSet` + +The character set attribute. + +``` swift +public static var characterSet: FontDescriptor.AttributeName +``` + +### `face` + +The font face attribute. + +``` swift +public static var face: FontDescriptor.AttributeName +``` + +### `family` + +The font family attribute. + +``` swift +public static var family: FontDescriptor.AttributeName +``` + +### `featureSettings` + +The font feature settings attribute. + +``` swift +public static var featureSettings: FontDescriptor.AttributeName +``` + +### `fixedAdvance` + +The glyph advancement attribute. + +``` swift +public static var fixedAdvance: FontDescriptor.AttributeName +``` + +### `matrix` + +The font's transformation matrix attribute. + +``` swift +public static var matrix: FontDescriptor.AttributeName +``` + +### `name` + +The font name attribute. + +``` swift +public static var name: FontDescriptor.AttributeName +``` + +### `size` + +The font size attribute. + +``` swift +public static var size: FontDescriptor.AttributeName +``` + +### `symbolic` + +The font's stylistic properties attribute. + +``` swift +public static var symbolic: FontDescriptor.AttributeName +``` + +### `textStyle` + +The text style attribute. + +``` swift +public static var textStyle: FontDescriptor.AttributeName +``` + +### `traits` + +The font traits dictionary attribute. + +``` swift +public static var traits: FontDescriptor.AttributeName +``` + +### `visibleName` + +The font's visible name attribute. + +``` swift +public static var visibleName: FontDescriptor.AttributeName +``` diff --git a/SwiftWin32/FontDescriptor_FeatureKey.md b/SwiftWin32/FontDescriptor_FeatureKey.md new file mode 100644 index 00000000..30f45c0d --- /dev/null +++ b/SwiftWin32/FontDescriptor_FeatureKey.md @@ -0,0 +1,63 @@ +--- +layout: default +title: FontDescriptor.FeatureKey +parent: SwiftWin32 +--- +# FontDescriptor.FeatureKey + +Keys for retrieving feature settings. + +``` swift +public struct FeatureKey: Equatable, Hashable, RawRepresentable +``` + +## Inheritance + +`Equatable`, `Hashable`, `RawRepresentable` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = String +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +### `init(_:)` + +``` swift +public init(_ rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `featureIdentifier` + +A key for identifying a font feature type such as ligature or character +shape. + +``` swift +public static var featureIdentifier: FontDescriptor.FeatureKey +``` + +### `typeIdentifier` + +A key for identifying the font feature selector. + +``` swift +public static var typeIdentifier: FontDescriptor.FeatureKey +``` diff --git a/SwiftWin32/FontDescriptor_SymbolicTraits.md b/SwiftWin32/FontDescriptor_SymbolicTraits.md new file mode 100644 index 00000000..c766d884 --- /dev/null +++ b/SwiftWin32/FontDescriptor_SymbolicTraits.md @@ -0,0 +1,208 @@ +--- +layout: default +title: FontDescriptor.SymbolicTraits +parent: SwiftWin32 +--- +# FontDescriptor.SymbolicTraits + +Constants that describe the stylistic aspects of a font. + +``` swift +public struct SymbolicTraits: OptionSet +``` + +## Inheritance + +`OptionSet` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = UInt32 +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `traitItalic` + +The font's style is italic. + +``` swift +public static var traitItalic: FontDescriptor.SymbolicTraits +``` + +### `traitBold` + +The font's style is bold. + +``` swift +public static var traitBold: FontDescriptor.SymbolicTraits +``` + +### `traitExpanded` + +The font's characters have an expanded width. + +``` swift +public static var traitExpanded: FontDescriptor.SymbolicTraits +``` + +### `traitCondensed` + +The font's characters have a condensed width. + +``` swift +public static var traitCondensed: FontDescriptor.SymbolicTraits +``` + +### `traitMonoSpace` + +The font's characters all have the same width. + +``` swift +public static var traitMonoSpace: FontDescriptor.SymbolicTraits +``` + +### `traitVertical` + +The font uses vertical glyph variants and metrics. + +``` swift +public static var traitVertical: FontDescriptor.SymbolicTraits +``` + +### `traitUIOptimized` + +The font synthesizes appropriate attributes for user interface rendering, +such as in control titles, if necessary. + +``` swift +public static var traitUIOptimized: FontDescriptor.SymbolicTraits +``` + +### `traitTightLeading` + +The font uses a leading value that's less than the default. + +``` swift +public static var traitTightLeading: FontDescriptor.SymbolicTraits +``` + +### `traitLooseLeading` + +The font uses a leading value that’s greater than the default. + +``` swift +public static var traitLooseLeading: FontDescriptor.SymbolicTraits +``` + +### `classMask` + +The font family class mask that you use to access font descriptor values. + +``` swift +public static var classMask: FontDescriptor.SymbolicTraits +``` + +### `classOldStyleSerifs` + +The font's characters include serifs, and reflect the Latin printing style +of the 15th to 17th centuries. + +``` swift +public static var classOldStyleSerifs: FontDescriptor.SymbolicTraits +``` + +### `classTransitionalSerifs` + +The font's characters include serifs, and reflect the Latin printing style +of the 18th to 19th centuries. + +``` swift +public static var classTransitionalSerifs: FontDescriptor.SymbolicTraits +``` + +### `classModernSerifs` + +The font's characters include serifs, and reflect the Latin printing style +of the 20th century. + +``` swift +public static var classModernSerifs: FontDescriptor.SymbolicTraits +``` + +### `classClarendonSerifs` + +The font's characters include variations of old style and transitional +serifs. + +``` swift +public static var classClarendonSerifs: FontDescriptor.SymbolicTraits +``` + +### `classSlabSerifs` + +The font's characters use square transitions, without brackets, between +strokes and serifs. + +``` swift +public static var classSlabSerifs: FontDescriptor.SymbolicTraits +``` + +### `classFreeformSerifs` + +The font's characters include serifs, and don’t generally fit within other +serif design classifications. + +``` swift +public static var classFreeformSerifs: FontDescriptor.SymbolicTraits +``` + +### `classSansSerif` + +The font's characters don’t have serifs. + +``` swift +public static var classSansSerif: FontDescriptor.SymbolicTraits +``` + +### `classOrnamentals` + +The font's characters use highly decorated or stylized character shapes. + +``` swift +public static var classOrnamentals: FontDescriptor.SymbolicTraits +``` + +### `classScripts` + +The font's characters simulate handwriting. + +``` swift +public static var classScripts: FontDescriptor.SymbolicTraits +``` + +### `classSymbolic` + +The font's characters consist mainly of symbols rather than letters and +numbers. + +``` swift +public static var classSymbolic: FontDescriptor.SymbolicTraits +``` diff --git a/SwiftWin32/FontDescriptor_SystemDesign.md b/SwiftWin32/FontDescriptor_SystemDesign.md new file mode 100644 index 00000000..1e361d05 --- /dev/null +++ b/SwiftWin32/FontDescriptor_SystemDesign.md @@ -0,0 +1,72 @@ +--- +layout: default +title: FontDescriptor.SystemDesign +parent: SwiftWin32 +--- +# FontDescriptor.SystemDesign + +Constants that describe the system-defined typeface designs. + +``` swift +public struct SystemDesign: Hashable, Equatable, RawRepresentable +``` + +## Inheritance + +`Equatable`, `Hashable`, `RawRepresentable` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = String +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `` `default` `` + +The default typeface for an app's user interface. + +``` swift +public static var `default`: FontDescriptor.SystemDesign +``` + +### `monospaced` + +The monospace variant of the default typeface. + +``` swift +public static var monospaced: FontDescriptor.SystemDesign +``` + +### `rounded` + +The rounded variant of the default typeface. + +``` swift +public static var rounded: FontDescriptor.SystemDesign +``` + +### `serif` + +The serif variant of the default typeface. + +``` swift +public static var serif: FontDescriptor.SystemDesign +``` diff --git a/SwiftWin32/FontDescriptor_TraitKey.md b/SwiftWin32/FontDescriptor_TraitKey.md new file mode 100644 index 00000000..5d61d51c --- /dev/null +++ b/SwiftWin32/FontDescriptor_TraitKey.md @@ -0,0 +1,70 @@ +--- +layout: default +title: FontDescriptor.TraitKey +parent: SwiftWin32 +--- +# FontDescriptor.TraitKey + +``` swift +public struct TraitKey: Equatable, Hashable, RawRepresentable +``` + +## Inheritance + +`Equatable`, `Hashable`, `RawRepresentable` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = String +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `slant` + +The relative slant angle of the font. + +``` swift +public static var slant: FontDescriptor.TraitKey +``` + +### `symbolic` + +The symbolic font traits. + +``` swift +public static var symbolic: FontDescriptor.TraitKey +``` + +### `weight` + +The normalized font weight. + +``` swift +public static var weight: FontDescriptor.TraitKey +``` + +### `width` + +The inter-glyph spacing of the font. + +``` swift +public static var width: FontDescriptor.TraitKey +``` diff --git a/SwiftWin32/FontMetrics.md b/SwiftWin32/FontMetrics.md new file mode 100644 index 00000000..eb2c402a --- /dev/null +++ b/SwiftWin32/FontMetrics.md @@ -0,0 +1,74 @@ +--- +layout: default +title: FontMetrics +parent: SwiftWin32 +--- +# FontMetrics + +``` swift +public class FontMetrics +``` + +## Initializers + +### `init(forTextStyle:)` + +Creating a Font Metrics Object +Creates a font metrics object for the specified text style. + +``` swift +public init (forTextStyle style: Font.TextStyle) +``` + +## Properties + +### `` `default` `` + +The default font metrics object for content. + +``` swift +public static let `default`: FontMetrics +``` + +## Methods + +### `scaledFont(for:)` + +Creating Scaled Fonts +Returns a version of the specified font that adopts the current font +metrics. + +``` swift +public func scaledFont(for font: Font) -> Font +``` + +### `scaledFont(for:compatibleWith:)` + +Returns a version of the specified font that adopts the current font +metrics and suports the specified traitss. + +``` swift +public func scaledFont(for font: Font, + compatibleWith traitCollection: TraitCollection?) + -> Font +``` + +### `scaledFont(for:maximumPointSize:)` + +Returns a version of the specified font that adopts the current font +metrics and is constrained to the specified maximum size. + +``` swift +public func scaledFont(for font: Font, maximumPointSize: Double) -> Font +``` + +### `scaledFont(for:maximumPointSize:compatibleWith:)` + +Returns a version of the specified font that adopts the current font +metrics and is constrained to the specified traits and size. + +``` swift +public func scaledFont(for font: Font, maximumPointSize: Double, + compatibleWith traitCollection: TraitCollection?) + -> Font +``` diff --git a/SwiftWin32/Font_TextStyle.md b/SwiftWin32/Font_TextStyle.md new file mode 100644 index 00000000..dca3791e --- /dev/null +++ b/SwiftWin32/Font_TextStyle.md @@ -0,0 +1,120 @@ +--- +layout: default +title: Font.TextStyle +parent: SwiftWin32 +--- +# Font.TextStyle + +Constants that describe the preferred styles for fonts. + +``` swift +struct TextStyle: Hashable, Equatable, RawRepresentable +``` + +## Inheritance + +`Equatable`, `Hashable`, `RawRepresentable` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: String) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: String +``` + +### `body` + +The font for body text. + +``` swift +static var body: Font.TextStyle +``` + +### `callout` + +The font for callouts. + +``` swift +static var callout: Font.TextStyle +``` + +### `caption1` + +The font for standard captions. + +``` swift +static var caption1: Font.TextStyle +``` + +### `caption2` + +The font for alternate captions. + +``` swift +static var caption2: Font.TextStyle +``` + +### `footnote` + +The font for footnotes. + +``` swift +static var footnote: Font.TextStyle +``` + +### `headline` + +The font for headings. + +``` swift +static var headline: Font.TextStyle +``` + +### `subheadline` + +The font for subheadings. + +``` swift +static var subheadline: Font.TextStyle +``` + +### `largeTitle` + +The font style for large titles. + +``` swift +static var largeTitle: Font.TextStyle +``` + +### `title1` + +The font for first-level hierarchical headings. + +``` swift +static var title1: Font.TextStyle +``` + +### `title2` + +The font for second-level hierarchical headings. + +``` swift +static var title2: Font.TextStyle +``` + +### `title3` + +The font for third-level hierarchical headings. + +``` swift +static var title3: Font.TextStyle +``` diff --git a/SwiftWin32/Font_Weight.md b/SwiftWin32/Font_Weight.md new file mode 100644 index 00000000..52207fcd --- /dev/null +++ b/SwiftWin32/Font_Weight.md @@ -0,0 +1,104 @@ +--- +layout: default +title: Font.Weight +parent: SwiftWin32 +--- +# Font.Weight + +Constants that represent standard font weights. + +``` swift +struct Weight: Hashable, Equatable, RawRepresentable +``` + +## Inheritance + +`Equatable`, `Hashable`, `RawRepresentable` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: Int32) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: Int32 +``` + +### `ultraLight` + +The ultra-light font weight. + +``` swift +static var ultraLight: Font.Weight +``` + +### `thin` + +The thin font weight. + +``` swift +static var thin: Font.Weight +``` + +### `light` + +The light font weight. + +``` swift +static var light: Font.Weight +``` + +### `regular` + +The regular font weight. + +``` swift +static var regular: Font.Weight +``` + +### `medium` + +The medium font weight. + +``` swift +static var medium: Font.Weight +``` + +### `semibold` + +The semibold font weight. + +``` swift +static var semibold: Font.Weight +``` + +### `bold` + +The bold font weight. + +``` swift +static var bold: Font.Weight +``` + +### `heavy` + +The heavy font weight. + +``` swift +static var heavy: Font.Weight +``` + +### `black` + +The black font weight. + +``` swift +static var black: Font.Weight +``` diff --git a/SwiftWin32/ForceTouchCapability.md b/SwiftWin32/ForceTouchCapability.md new file mode 100644 index 00000000..8be845c8 --- /dev/null +++ b/SwiftWin32/ForceTouchCapability.md @@ -0,0 +1,45 @@ +--- +layout: default +title: ForceTouchCapability +parent: SwiftWin32 +--- +# ForceTouchCapability + +Keys that indicate the availability of 3D Touch on a device. + +``` swift +public enum ForceTouchCapability: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `unspecified` + +The availability of 3D Touch is unknown. + +``` swift +case unspecified +``` + +A view has this trait after you create it but before you add it your +application's view hierarchy. + +### `available` + +3D Touch is available on the device. + +``` swift +case available +``` + +### `unavailable` + +3D Touch is not available on the device. + +``` swift +case unavailable +``` diff --git a/SwiftWin32/GestureRecognizer.md b/SwiftWin32/GestureRecognizer.md new file mode 100644 index 00000000..0e803f00 --- /dev/null +++ b/SwiftWin32/GestureRecognizer.md @@ -0,0 +1,176 @@ +--- +layout: default +title: GestureRecognizer +parent: SwiftWin32 +--- +# GestureRecognizer + +``` swift +public class GestureRecognizer +``` + +## Initializers + +### `init(target:action:)` + +Initializes an allocated gesture-recognizer object with a target and an +action selector. + +``` swift +public init(target: Target, + action: @escaping (Target) -> () -> Void) +``` + +The valid signatures for `action` are: + + - `(Target) -> () -> Void` aka `()` + + - `(Target) -> (_: GestureRecognizer) -> Void` aka `(_: GestureRecognizer)` + +Although the signature permits nullable types, the values may not be nil. + +### `init(target:action:)` + +``` swift +public init(target: Target, + action: @escaping (Target) -> (_: GestureRecognizer) -> Void) +``` + +### `init()` + +``` swift +public /* convenience */ init() +``` + +## Properties + +### `delegate` + +The delegate of the gesture recognizer. + +``` swift +public weak var delegate: GestureRecognizerDelegate? +``` + +### `numberOfTouches` + +Returns the number of touches involved in the gesture represented by the +receiver. + +``` swift +public private(set) var numberOfTouches: Int = 0 +``` + +### `state` + +The current state of the gesture recognizer. + +``` swift +public var state: GestureRecognizer.State = .possible +``` + +### `view` + +The view the gesture recognizer is attached to. + +``` swift +public internal(set) var view: View? +``` + +### `isEnabled` + +A boolean property that indicates whether the gesture recognizer is +enabled. + +``` swift +public var isEnabled: Bool = true +``` + +### `buttonMask` + +A bit mask of the button (or buttons) in the gesture represented by the +receiver. + +``` swift +public private(set) var buttonMask: Event.ButtonMask = [] +``` + +### `modifierFlags` + +Constants that indicate which modifier keys are pressed. + +``` swift +public private(set) var modifierFlags: KeyModifierFlags = [] +``` + +### `name` + +The name associated with the gesture recognizer. + +``` swift +public var name: String? +``` + +## Methods + +### `addTarget(_:action:)` + +Adds a target and an action to a gesture-recognizer object. + +``` swift +public func addTarget(_ target: Target, + action: @escaping (Target) -> () -> Void) +``` + +The valid signatures for `action` are: + + - `(Target) -> () -> Void` aka `()` + + - `(Target) -> (_: GestureRecognizer) -> Void` aka `(_: GestureRecognizer)` + +### `addTarget(_:action:)` + +``` swift +public func addTarget(_ target: Target, + action: @escaping (Target) -> (_: GestureRecognizer) -> Void) +``` + +### `removeTarget(_:action:)` + +Removes a target and an action from a gesture-recognizer object. + +``` swift +public func removeTarget(_ target: Target, + action: @escaping (Target) -> () -> Void) +``` + +### `removeTarget(_:action:)` + +``` swift +public func removeTarget(_ target: Target, + action: @escaping (Target) -> (_: GestureRecognizer) -> Void) +``` + +### `location(in:)` + +Returns the point computed as the location in a given view of the gesture +represented by the receiver. + +``` swift +public func location(in view: View?) -> Point +``` + +### `location(ofTouch:in:)` + +Returns the location of one of the gesture’s touches in the local +coordinate system of a given view. + +``` swift +public func location(ofTouch touchIndex: Int, in view: View?) -> Point +``` + +### `shouldReceive(_:)` + +``` swift +public func shouldReceive(_ event: Event) -> Bool +``` diff --git a/SwiftWin32/GestureRecognizerDelegate.md b/SwiftWin32/GestureRecognizerDelegate.md new file mode 100644 index 00000000..62c043d8 --- /dev/null +++ b/SwiftWin32/GestureRecognizerDelegate.md @@ -0,0 +1,157 @@ +--- +layout: default +title: GestureRecognizerDelegate +parent: SwiftWin32 +--- +# GestureRecognizerDelegate + +A set of methods implemented by the delegate of a gesture recognizer to +fine-tune an application’s gesture-recognition behavior. + +``` swift +public protocol GestureRecognizerDelegate: AnyObject +``` + +## Inheritance + +`AnyObject` + +## Default Implementations + +### `gestureRecognizerShouldBegin(_:)` + +``` swift +public func gestureRecognizerShouldBegin(_ gestureRecognizer: GestureRecognizer) + -> Bool +``` + +### `gestureRecognizer(_:shouldReceive:)` + +``` swift +public func gestureRecognizer(_ gestureRecognizer: GestureRecognizer, + shouldReceive touch: Touch) -> Bool +``` + +### `gestureRecognizer(_:shouldReceive:)` + +
+
NOT_YET_IMPLEMENTED
+
+ +``` swift +public func gestureRecognizer(_ gestureRecognizer: GestureRecognizer, + shouldReceive press: Press) -> Bool +``` + +
+
+ +### `gestureRecognizer(_:shouldReceive:)` + +``` swift +public func gestureRecognizer(_ gestureRecognizer: GestureRecognizer, + shouldReceive event: Event) -> Bool +``` + +### `gestureRecognizer(_:shouldRecognizeSimultaneouslyWith:)` + +``` swift +public func gestureRecognizer(_ gestureRecognizer: GestureRecognizer, + shouldRecognizeSimultaneouslyWith otherGestureRecognizer: GestureRecognizer) + -> Bool +``` + +### `gestureRecognizer(_:shouldRequireFailureOf:)` + +``` swift +public func gestureRecognizer(_ gestureRecognizer: GestureRecognizer, + shouldRequireFailureOf otherGestureRecognizer: GestureRecognizer) + -> Bool +``` + +### `gestureRecognizer(_:shouldBeRequiredToFailBy:)` + +``` swift +public func gestureRecognizer(_ gestureRecognizer: GestureRecognizer, + shouldBeRequiredToFailBy otherGestureRecognizer: GestureRecognizer) + -> Bool +``` + +## Requirements + +### gestureRecognizerShouldBegin(\_:​) + +Asks the delegate if a gesture recognizer should begin interpreting +touches. + +``` swift +func gestureRecognizerShouldBegin(_ gestureRecognizer: GestureRecognizer) + -> Bool +``` + +### gestureRecognizer(\_:​shouldReceive:​) + +Asks the delegate if a gesture recognizer should receive an object +representing a touch. + +``` swift +func gestureRecognizer(_ gestureRecognizer: GestureRecognizer, + shouldReceive touch: Touch) -> Bool +``` + +### gestureRecognizer(\_:​shouldReceive:​) + +
+
NOT_YET_IMPLEMENTED
+
+ +``` swift +func gestureRecognizer(_ gestureRecognizer: GestureRecognizer, + shouldReceive press: Press) -> Bool +``` + +
+
+ +### gestureRecognizer(\_:​shouldReceive:​) + +Asks the delegate if a gesture recognizer should receive an object +representing a touch or press event. + +``` swift +func gestureRecognizer(_ gestureRecognizer: GestureRecognizer, + shouldReceive event: Event) -> Bool +``` + +### gestureRecognizer(\_:​shouldRecognizeSimultaneouslyWith:​) + +Asks the delegate if two gesture recognizers should be allowed to +recognize gestures simultaneously. + +``` swift +func gestureRecognizer(_ gestureRecognizer: GestureRecognizer, + shouldRecognizeSimultaneouslyWith otherGestureRecognizer: GestureRecognizer) + -> Bool +``` + +### gestureRecognizer(\_:​shouldRequireFailureOf:​) + +Asks the delegate if a gesture recognizer should require another gesture +recognizer to fail. + +``` swift +func gestureRecognizer(_ gestureRecognizer: GestureRecognizer, + shouldRequireFailureOf otherGestureRecognizer: GestureRecognizer) + -> Bool +``` + +### gestureRecognizer(\_:​shouldBeRequiredToFailBy:​) + +Asks the delegate if a gesture recognizer should be required to fail by +another gesture recognizer. + +``` swift +func gestureRecognizer(_ gestureRecognizer: GestureRecognizer, + shouldBeRequiredToFailBy otherGestureRecognizer: GestureRecognizer) + -> Bool +``` diff --git a/SwiftWin32/GestureRecognizer_State.md b/SwiftWin32/GestureRecognizer_State.md new file mode 100644 index 00000000..b96c8d8b --- /dev/null +++ b/SwiftWin32/GestureRecognizer_State.md @@ -0,0 +1,92 @@ +--- +layout: default +title: GestureRecognizer.State +parent: SwiftWin32 +--- +# GestureRecognizer.State + +The current state a gesture recognizer is in. + +``` swift +public enum State: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `possible` + +The gesture recognizer has not yet recognized its gesture, but may be +evaluating touch events. This is the default state. + +``` swift +case possible +``` + +### `began` + +The gesture recognizer has received touch objects recognized as a +continuous gesture. It sends its action message (or messages) at the +next cycle of the run loop. + +``` swift +case began +``` + +### `changed` + +The gesture recognizer has received touches recognized as a change to a +continuous gesture. It sends its action message (or messages) at the +next cycle of the run loop. + +``` swift +case changed +``` + +### `ended` + +The gesture recognizer has received touches recognized as the end of a +continuous gesture. It sends its action message (or messages) at the +next cycle of the run loop and resets its state to +`GestureRecognizer.State.possible`. + +``` swift +case ended +``` + +### `cancelled` + +The gesture recognizer has received touches resulting in the +cancellation of a continuous gesture. It sends its action message (or +messages) at the next cycle of the run loop and resets its state to +`GestureRecognizer.State.possible`. + +``` swift +case cancelled +``` + +### `failed` + +The gesture recognizer has received a multi-touch sequence that it +cannot recognize as its gesture. No action message is sent and the +gesture recognizer is reset to `GestureRecognizer.State.possible`. + +``` swift +case failed +``` + +## Properties + +### `recognized` + +The gesture recognizer has received a multi-touch sequence that it +recognizes as its gesture. It sends its action message (or messages) at +the next cycle of the run loop and resets its state to +`GestureRecognizer.State.possible`. + +``` swift +public static var recognized: GestureRecognizer.State +``` diff --git a/SwiftWin32/Image.md b/SwiftWin32/Image.md new file mode 100644 index 00000000..f9fa06f8 --- /dev/null +++ b/SwiftWin32/Image.md @@ -0,0 +1,41 @@ +--- +layout: default +title: Image +parent: SwiftWin32 +--- +# Image + +An object that manages image data in your app. + +``` swift +public class Image +``` + +## Initializers + +### `init?(contentsOfFile:)` + +Initializes and returns the image object with the contents of the +specified file. + +``` swift +public init?(contentsOfFile path: String) +``` + +## Properties + +### `scale` + +The scale factor of the image. + +``` swift +public var scale: Float +``` + +### `size` + +The logical dimensions, in points, for the image. + +``` swift +public var size: Size +``` diff --git a/SwiftWin32/ImageView.md b/SwiftWin32/ImageView.md new file mode 100644 index 00000000..87cb03bc --- /dev/null +++ b/SwiftWin32/ImageView.md @@ -0,0 +1,60 @@ +--- +layout: default +title: ImageView +parent: SwiftWin32 +--- +# ImageView + +An object that displays a single image or a sequence of animated images in +your interface. + +``` swift +public class ImageView: View +``` + +## Inheritance + +[`View`](https://compnerd.github.io/swift-win32/SwiftWin32/View) + +## Initializers + +### `init(image:)` + +Returns an image view initialized with the specified image. + +``` swift +public init(image: Image?) +``` + +### `init(image:highlightedImage:)` + +Returns an image view initialized with the specified regular and +highlighted images. + +``` swift +public init(image: Image?, highlightedImage: Image?) +``` + +## Properties + +### `image` + +The image displayed in the image view. + +``` swift +public var image: Image? +``` + +### `highlightedImage` + +The highlighted image displayed in the image view. + +``` swift +public var highlightedImage: Image? +``` + +### `adjustsImageSizeForAccessibilityContentSizeCategory` + +``` swift +public var adjustsImageSizeForAccessibilityContentSizeCategory = false +``` diff --git a/SwiftWin32/Image_Configuration.md b/SwiftWin32/Image_Configuration.md new file mode 100644 index 00000000..3ea9f31e --- /dev/null +++ b/SwiftWin32/Image_Configuration.md @@ -0,0 +1,43 @@ +--- +layout: default +title: Image.Configuration +parent: SwiftWin32 +--- +# Image.Configuration + +A configuration object that contains the traits that the system uses when +selecting the current image variant. + +``` swift +public class Configuration +``` + +## Properties + +### `traitCollection` + +The traits associated with the image configuration. + +``` swift +public private(set) var traitCollection: TraitCollection? +``` + +## Methods + +### `applying(_:)` + +Returns a configuration object that applies the specified configuration +values on top of the current object's values. + +``` swift +public func applying(_ otherConfiguration: Image.Configuration?) -> Self +``` + +### `withTraitCollection(_:)` + +Returns a new configuration object that merges the current traits with +the traits from the specified trait collection. + +``` swift +public func withTraitCollection(_ traitCollection: TraitCollection?) -> Self +``` diff --git a/SwiftWin32/Image_SymbolConfiguration.md b/SwiftWin32/Image_SymbolConfiguration.md new file mode 100644 index 00000000..d1525665 --- /dev/null +++ b/SwiftWin32/Image_SymbolConfiguration.md @@ -0,0 +1,157 @@ +--- +layout: default +title: Image.SymbolConfiguration +parent: SwiftWin32 +--- +# Image.SymbolConfiguration + +An object that contains the specific font, size, style, and weight +attributes to apply to a symbol image. + +``` swift +public class SymbolConfiguration: Image.Configuration +``` + +## Inheritance + +[`Image.Configuration`](https://compnerd.github.io/swift-win32/SwiftWin32/Image_Configuration) + +## Initializers + +### `init(pointSize:)` + +Creates a configuration object with the specified point-size information. + +``` swift +public convenience init(pointSize: Double) +``` + +### `init(pointSize:weight:)` + +Creates a configuration object with the specified point-size and weight +information. + +``` swift +public convenience init(pointSize: Double, weight: Image.SymbolWeight) +``` + +### `init(pointSize:weight:scale:)` + +Creates a configuration object with the specified point-size, weight, +and scale information. + +``` swift +public convenience init(pointSize: Double, weight: Image.SymbolWeight, + scale: Image.SymbolScale) +``` + +### `init(scale:)` + +Creates a configuration object with the specified scale information. + +``` swift +public convenience init(scale: Image.SymbolScale) +``` + +### `init(textStyle:)` + +Creates a configuration object with the specified font text style +information. + +``` swift +public convenience init(textStyle: Font.TextStyle) +``` + +### `init(textStyle:scale:)` + +Creates a configuration object with the specified font text style and +scale information. + +``` swift +public convenience init(textStyle: Font.TextStyle, + scale: Image.SymbolScale) +``` + +### `init(weight:)` + +Creates a configuration object with the specified weight information. + +``` swift +public convenience init(weight: Image.SymbolWeight) +``` + +### `init(font:)` + +Creates a configuration object with the specified font information. + +``` swift +public convenience init(font: Font) +``` + +### `init(font:scale:)` + +Creates a configuration object with the specified font and scale +information. + +``` swift +public convenience init(font: Font, scale: Image.SymbolScale) +``` + +## Properties + +### `unspecified` + +A symbol configuration object that contains unspecified values for all +attributes. + +``` swift +public class var unspecified: Image.SymbolConfiguration +``` + +## Methods + +### `configurationWithoutPointSizeAndWeight()` + +Returns a copy of the current symbol configuration object without +point-size and weight information. + +``` swift +public func configurationWithoutPointSizeAndWeight() -> Self +``` + +### `configurationWithoutScale()` + +Returns a copy of the current symbol configuration object without scale +information. + +``` swift +public func configurationWithoutScale() -> Self +``` + +### `configurationWithoutTextStyle()` + +Returns a copy of the current symbol configuration object without font +text style information. + +``` swift +public func configurationWithoutTextStyle() -> Self +``` + +### `configurationWithoutWeight()` + +Returns a copy of the current symbol configuration object without weight +information. + +``` swift +public func configurationWithoutWeight() -> Self +``` + +### `isEqual(to:)` + +Returns a boolean value that indicates whether the configuration objects +are equivalent. + +``` swift +public func isEqual(to otherConfiguration: Image.SymbolConfiguration?) + -> Bool +``` diff --git a/SwiftWin32/Image_SymbolScale.md b/SwiftWin32/Image_SymbolScale.md new file mode 100644 index 00000000..877c9ea1 --- /dev/null +++ b/SwiftWin32/Image_SymbolScale.md @@ -0,0 +1,56 @@ +--- +layout: default +title: Image.SymbolScale +parent: SwiftWin32 +--- +# Image.SymbolScale + +``` swift +public enum SymbolScale: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `` `default` `` + +The default scale variant that matches the system usage. + +``` swift +case `default` +``` + +### `unspecified` + +An unspecified scale. + +``` swift +case unspecified +``` + +### `small` + +The small variant of the symbol image. + +``` swift +case small +``` + +### `medium` + +The medium variant of the symbol image. + +``` swift +case medium +``` + +### `large` + +The large variant of the symbol image. + +``` swift +case large +``` diff --git a/SwiftWin32/Image_SymbolWeight.md b/SwiftWin32/Image_SymbolWeight.md new file mode 100644 index 00000000..6c9e1c48 --- /dev/null +++ b/SwiftWin32/Image_SymbolWeight.md @@ -0,0 +1,108 @@ +--- +layout: default +title: Image.SymbolWeight +parent: SwiftWin32 +--- +# Image.SymbolWeight + +Constants that indicate which weight variant of a symbol image to use. + +``` swift +public enum SymbolWeight: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `unspecified` + +An unspecified symbol image weight. + +``` swift +case unspecified +``` + +### `ultraLight` + +An ultralight weight. + +``` swift +case ultraLight +``` + +### `thin` + +A thin weight + +``` swift +case thin +``` + +### `light` + +A light weight. + +``` swift +case light +``` + +### `regular` + +A regular weight. + +``` swift +case regular +``` + +### `medium` + +A medium weight. + +``` swift +case medium +``` + +### `semibold` + +A semibold weight. + +``` swift +case semibold +``` + +### `bold` + +A bold weight. + +``` swift +case bold +``` + +### `heavy` + +A heavy weight. + +``` swift +case heavy +``` + +### `black` + +An ultra-heavy weight. + +``` swift +case black +``` + +## Methods + +### `fontWeight()` + +The font weight for the specified symbol weight. + +``` swift +public func fontWeight() -> Font.Weight +``` diff --git a/SwiftWin32/IndexPath.md b/SwiftWin32/IndexPath.md new file mode 100644 index 00000000..22bbca4a --- /dev/null +++ b/SwiftWin32/IndexPath.md @@ -0,0 +1,52 @@ +--- +layout: default +title: IndexPath +parent: SwiftWin32 +--- +# Extensions on IndexPath + +## Initializers + +### `init(row:section:)` + +Initializes an index path with the indexes of a specific row and section +in a table view. + +``` swift +public init(row: Int, section: Int) +``` + +### `init(item:section:)` + +Initializes an index path with the index of a specific item and section in +a collection view. + +``` swift +public init(item: Int, section: Int) +``` + +## Properties + +### `section` + +An index number identifying a section in a table view or collection view. + +``` swift +public var section: Int +``` + +### `row` + +An index number identifying a row in a section of a table view. + +``` swift +public var row: Int +``` + +### `item` + +An index number identifying an item in a section of a collection view. + +``` swift +public var item: Int +``` diff --git a/SwiftWin32/InputViewController.md b/SwiftWin32/InputViewController.md new file mode 100644 index 00000000..bd1c97d1 --- /dev/null +++ b/SwiftWin32/InputViewController.md @@ -0,0 +1,14 @@ +--- +layout: default +title: InputViewController +parent: SwiftWin32 +--- +# InputViewController + +``` swift +public class InputViewController: ViewController +``` + +## Inheritance + +[`ViewController`](https://compnerd.github.io/swift-win32/SwiftWin32/ViewController) diff --git a/SwiftWin32/Interaction.md b/SwiftWin32/Interaction.md new file mode 100644 index 00000000..18928b3c --- /dev/null +++ b/SwiftWin32/Interaction.md @@ -0,0 +1,44 @@ +--- +layout: default +title: Interaction +parent: SwiftWin32 +--- +# Interaction + +The protocol that an interaction implements to access the view that owns it. + +``` swift +public protocol Interaction: AnyObject +``` + +## Inheritance + +`AnyObject` + +## Requirements + +### view + +The view that owns the interaction. + +``` swift +var view: View? +``` + +### didMove(to:​) + +Tells the interaction that a view added or removed it from the view's +interaction array. + +``` swift +func didMove(to view: View?) +``` + +### willMove(to:​) + +Tells the interaction that a view will add or remove it from the view's +interaction array. + +``` swift +func willMove(to view: View?) +``` diff --git a/SwiftWin32/InterfaceOrientation.md b/SwiftWin32/InterfaceOrientation.md new file mode 100644 index 00000000..1e5fa254 --- /dev/null +++ b/SwiftWin32/InterfaceOrientation.md @@ -0,0 +1,72 @@ +--- +layout: default +title: InterfaceOrientation +parent: SwiftWin32 +--- +# InterfaceOrientation + +The orientation of the application's user interface + +``` swift +public enum InterfaceOrientation: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `unknown` + +The orientation of the device is unknown. + +``` swift +case unknown +``` + +### `portrait` + +The device is in portrait mode, with the device upright. + +``` swift +case portrait +``` + +### `portraitUpsideDown` + +The device is in portrait mode, with the device upside down. + +``` swift +case portraitUpsideDown +``` + +### `landscapeLeft` + +The device is in landscape mode, with the device upright. + +``` swift +case landscapeLeft +``` + +### `landscapeRight` + +The device is in landscape mode, with the device upright. + +``` swift +case landscapeRight +``` + +## Properties + +### `isLandscape` + +``` swift +public var isLandscape: Bool +``` + +### `isPortrait` + +``` swift +public var isPortrait: Bool +``` diff --git a/SwiftWin32/InterfaceOrientationMask.md b/SwiftWin32/InterfaceOrientationMask.md new file mode 100644 index 00000000..c41d895e --- /dev/null +++ b/SwiftWin32/InterfaceOrientationMask.md @@ -0,0 +1,100 @@ +--- +layout: default +title: InterfaceOrientationMask +parent: SwiftWin32 +--- +# InterfaceOrientationMask + +These constants are mask bits for specifying a view controller's supported +interface orientations. + +``` swift +public struct InterfaceOrientationMask: OptionSet +``` + +## Inheritance + +`OptionSet` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = UInt +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `portrait` + +The view controller supports a portrait interface orientation. + +``` swift +public static var portrait: InterfaceOrientationMask +``` + +### `landscapeLeft` + +The view controller supports a landscape-left interface orientation. + +``` swift +public static var landscapeLeft: InterfaceOrientationMask +``` + +### `landscapeRight` + +The view controller supports a landscape-right interface orientation. + +``` swift +public static var landscapeRight: InterfaceOrientationMask +``` + +### `portraitUpsideDown` + +The view controller supports an upside-down portrait interface +orientation. + +``` swift +public static var portraitUpsideDown: InterfaceOrientationMask +``` + +### `landscape` + +The view controller supports both landscape-left and landscape-right +interface orientation. + +``` swift +public static var landscape: InterfaceOrientationMask +``` + +### `all` + +The view controller supports all interface orientations. + +``` swift +public static var all: InterfaceOrientationMask +``` + +### `allButUpsideDown` + +The view controller supports all but the upside-down portrait interface +orientation. + +``` swift +public static var allButUpsideDown: InterfaceOrientationMask +``` diff --git a/SwiftWin32/KeyModifierFlags.md b/SwiftWin32/KeyModifierFlags.md new file mode 100644 index 00000000..806e95d9 --- /dev/null +++ b/SwiftWin32/KeyModifierFlags.md @@ -0,0 +1,89 @@ +--- +layout: default +title: KeyModifierFlags +parent: SwiftWin32 +--- +# KeyModifierFlags + +Constants that indicate which modifier keys are pressed. + +``` swift +public struct KeyModifierFlags: OptionSet +``` + +## Inheritance + +`OptionSet` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = Int +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `alphaShift` + +A modifier flag that indicates the user pressed the Caps Lock key. + +``` swift +public static var alphaShift: KeyModifierFlags +``` + +### `shift` + +A modifier flag that indicates the user pressed the Shift key. + +``` swift +public static var shift: KeyModifierFlags +``` + +### `control` + +A modifier flag that indicates the user pressed the Control key. + +``` swift +public static var control: KeyModifierFlags +``` + +### `alternate` + +A modifier flag that indicates the user pressed the Option key. + +``` swift +public static var alternate: KeyModifierFlags +``` + +### `command` + +A modifier flag that indicates the user pressed the Command key. + +``` swift +public static var command: KeyModifierFlags +``` + +### `numericPad` + +A modifier flag that indicates the user pressed a key located on the +numeric keypad. + +``` swift +public static var numericPad: KeyModifierFlags +``` diff --git a/SwiftWin32/Label.md b/SwiftWin32/Label.md new file mode 100644 index 00000000..9c948ada --- /dev/null +++ b/SwiftWin32/Label.md @@ -0,0 +1,62 @@ +--- +layout: default +title: Label +parent: SwiftWin32 +--- +# Label + +``` swift +public class Label: Control +``` + +## Inheritance + +[`Control`](https://compnerd.github.io/swift-win32/SwiftWin32/Control) + +## Initializers + +### `init(frame:)` + +``` swift +public init(frame: Rect) +``` + +## Properties + +### `text` + +``` swift +public var text: String? +``` + +### `font` + +``` swift +public override var font: Font! +``` + +### `frame` + +``` swift +public override var frame: Rect +``` + +### `adjustsFontForContentSizeCategory` + +``` swift +public var adjustsFontForContentSizeCategory = false +``` + +## Methods + +### `sizeThatFits(_:)` + +``` swift +override public func sizeThatFits(_ size: Size) -> Size +``` + +### `traitCollectionDidChange(_:)` + +``` swift +override public func traitCollectionDidChange(_ previousTraitCollection: TraitCollection?) +``` diff --git a/SwiftWin32/LayoutAnchor.md b/SwiftWin32/LayoutAnchor.md new file mode 100644 index 00000000..20e8ccb5 --- /dev/null +++ b/SwiftWin32/LayoutAnchor.md @@ -0,0 +1,74 @@ +--- +layout: default +title: LayoutAnchor +parent: SwiftWin32 +--- +# LayoutAnchor + +A factory class for creating layout constraint objects using a fluent API. + +``` swift +public class LayoutAnchor +``` + +## Methods + +### `constraint(equalTo:)` + +Returns a constraint that defines one item's attribute as equal to +another. + +``` swift +public func constraint(equalTo anchor: LayoutAnchor) + -> LayoutConstraint +``` + +### `constraint(equalTo:constant:)` + +Returns a constraint that defines one item's attribute as equal to another +item's attribute plus a constant offset. + +``` swift +public func constraint(equalTo anchor: LayoutAnchor, + constant offset: Double) -> LayoutConstraint +``` + +### `constraint(greaterThanOrEqualTo:)` + +Returns a constraint that defines one item's attribute as greater than or +equal to another. + +``` swift +public func constraint(greaterThanOrEqualTo anchor: LayoutAnchor) + -> LayoutConstraint +``` + +### `constraint(greaterThanOrEqualTo:constant:)` + +Returns a constraint that defines one item's attribute as greater than or +equal to another item's attribute plus a constant offset. + +``` swift +public func constraint(greaterThanOrEqualTo anchor: LayoutAnchor, + constant offset: Double) -> LayoutConstraint +``` + +### `constraint(lessThanOrEqualTo:)` + +Returns a constraint that defines one item's attribute as less than or +equal to another. + +``` swift +public func constraint(lessThanOrEqualTo anchor: LayoutAnchor) + -> LayoutConstraint +``` + +### `constraint(lessThanOrEqualTo:constant:)` + +Returns a constraint that defines one item's attribute as less than or +equal to another item's attribute plus a constant offset. + +``` swift +public func constraint(lessThanOrEqualTo anchor: LayoutAnchor, + constant offset: Double) -> LayoutConstraint +``` diff --git a/SwiftWin32/LayoutConstraint.md b/SwiftWin32/LayoutConstraint.md new file mode 100644 index 00000000..a41d39a2 --- /dev/null +++ b/SwiftWin32/LayoutConstraint.md @@ -0,0 +1,144 @@ +--- +layout: default +title: LayoutConstraint +parent: SwiftWin32 +--- +# LayoutConstraint + +``` swift +public class LayoutConstraint +``` + +## Initializers + +### `init(item:attribute:relatedBy:toItem:attribute:multiplier:constant:)` + +Creates a constraint that defines the relationship between the specified +attributes of the given views. + +``` swift +public /*convenience*/ init(item firstItem: AnyObject, + attribute firstAttribute: LayoutConstraint.Attribute, + relatedBy relation: LayoutConstraint.Relation, + toItem secondItem: AnyObject?, + attribute secondAttribute: LayoutConstraint.Attribute, + multiplier: Double, constant: Double) +``` + +## Properties + +### `isActive` + +The active state of the constraint. + +``` swift +public var isActive: Bool = false +``` + +### `firstItem` + +The first object participating in the constraint. + +``` swift +public unowned(unsafe) var firstItem: AnyObject? +``` + +### `firstAttribute` + +The attribute of the first object participating in the constraint. + +``` swift +public var firstAttribute: LayoutConstraint.Attribute +``` + +### `relation` + +The relationship between the two attributes in the constraint. + +``` swift +public private(set) var relation: LayoutConstraint.Relation +``` + +### `secondItem` + +The second object participating in the constraint. + +``` swift +public unowned(unsafe) var secondItem: AnyObject? +``` + +### `secondAttribute` + +The attribute of the second object participating in the constraint. + +``` swift +public var secondAttribute: LayoutConstraint.Attribute +``` + +### `multiplier` + +The multiplier applied to the second attribute participating in the +constraint. + +``` swift +public private(set) var multiplier: Double +``` + +### `constant` + +The constant added to the multiplied second attribute participating in the +constraint. + +``` swift +public private(set) var constant: Double +``` + +### `firstAnchor` + +The first anchor that defines the constraint. + +``` swift +public private(set) var firstAnchor: LayoutAnchor +``` + +### `secondAnchor` + +The second anchor that defines the constraint. + +``` swift +public private(set) var secondAnchor: LayoutAnchor? +``` + +### `priority` + +The priority of the constraint. + +``` swift +public var priority: LayoutPriority = .required +``` + +### `identifier` + +The name that identifies the constraint. + +``` swift +public var identifier: String? +``` + +## Methods + +### `activate(_:)` + +Activates each constraint in the specified array. + +``` swift +public class func activate(_ constraints: [LayoutConstraint]) +``` + +### `deactivate(_:)` + +Deactivates each constraint in the specified array. + +``` swift +public class func deactivate(_ constraints: [LayoutConstraint]) +``` diff --git a/SwiftWin32/LayoutConstraint_Attribute.md b/SwiftWin32/LayoutConstraint_Attribute.md new file mode 100644 index 00000000..ca7757d7 --- /dev/null +++ b/SwiftWin32/LayoutConstraint_Attribute.md @@ -0,0 +1,200 @@ +--- +layout: default +title: LayoutConstraint.Attribute +parent: SwiftWin32 +--- +# LayoutConstraint.Attribute + +The part of the object's visual representation that should be used to get +the value for the constraint. + +``` swift +public enum Attribute: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `left` + +The left side of the object's alignment rectangle. + +``` swift +case left +``` + +### `right` + +The right side of the object's alignment rectangle. + +``` swift +case right +``` + +### `top` + +The top of the object's alignment rectangle. + +``` swift +case top +``` + +### `bottom` + +The bottom of the object's alignment rectangle. + +``` swift +case bottom +``` + +### `leading` + +The leading edge of the object's alignment rectangle. + +``` swift +case leading +``` + +### `trailing` + +The trailing edge of the object's alignment rectangle. + +``` swift +case trailing +``` + +### `width` + +The width of the object's alignment rectangle. + +``` swift +case width +``` + +### `height` + +The height of the object's alignment rectangle. + +``` swift +case height +``` + +### `centerX` + +Tne center along the x-axis of the object's alignment rectangle. + +``` swift +case centerX +``` + +### `centerY` + +The center along the y-axis of the object's alignment rectangle. + +``` swift +case centerY +``` + +### `lastBaseline` + +The object's baseline. For objects with more than one line of text, this +is the baseline for the bottom-most line of text. + +``` swift +case lastBaseline +``` + +### `firstBaseline` + +The object's baseline. For objects with more than one line of text, this +is the baseline for the top-most line of text. + +``` swift +case firstBaseline +``` + +### `leftMargin` + +The object's left margin. For `View` objects, the margins are defined by +their `layoutMargins` property. + +``` swift +case leftMargin +``` + +### `rightMargin` + +The object's right margin. For `View` objects, the margins are defined by +their `layoutMargins` property. + +``` swift +case rightMargin +``` + +### `topMargin` + +The object's top margin. For `View` objects, the margins are defined by +their `layoutMargins` property. + +``` swift +case topMargin +``` + +### `bottomMargin` + +The object's bottom margin. For `View` objects, the margins are defined +by their `layoutMargins` property. + +``` swift +case bottomMargin +``` + +### `leadingMargin` + +The object's leading margin. For `View` objects, the margins are defined +by their `layoutMargins` property. + +``` swift +case leadingMargin +``` + +### `trailingMargin` + +The object's trailing margin. For `View` objects, the margins are defined +by thier `layoutMargins` property. + +``` swift +case trailingMargin +``` + +### `centerXWithinMargins` + +The center along the x-axis between the object's left and right margin. +For `View` objects, the margins are defined by their `layoutMargins` +property. + +``` swift +case centerXWithinMargins +``` + +### `centerYWithinMargins` + +The center along the y-axis between the object's top and bottom margin. +For `View` objects, the margins are defined by thier `layoutMargins` +property. + +``` swift +case centerYWithinMargins +``` + +### `notAnAttribute` + +A placeholder value that is used to indicate taht the constraint's second +item and second attribute are not used in any calculations. + +``` swift +case notAnAttribute +``` diff --git a/SwiftWin32/LayoutConstraint_Relation.md b/SwiftWin32/LayoutConstraint_Relation.md new file mode 100644 index 00000000..e00c1d8b --- /dev/null +++ b/SwiftWin32/LayoutConstraint_Relation.md @@ -0,0 +1,46 @@ +--- +layout: default +title: LayoutConstraint.Relation +parent: SwiftWin32 +--- +# LayoutConstraint.Relation + +The relation between the first attribute and the modified second attribute +in a constraint. + +``` swift +public enum Relation: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `lessThanOrEqual` + +The constraint requires the first attribute to be less than or equal to +the modified second attribute. + +``` swift +case lessThanOrEqual +``` + +### `equal` + +The constraint requires the first attribute to be exactly equal to the +modified second attribute. + +``` swift +case equal +``` + +### `greaterThanOrEqual` + +The constraint requires the first attribute to be greater than or equal to +the modified second attribute. + +``` swift +case greaterThanOrEqual +``` diff --git a/SwiftWin32/LayoutDimension.md b/SwiftWin32/LayoutDimension.md new file mode 100644 index 00000000..32df2d69 --- /dev/null +++ b/SwiftWin32/LayoutDimension.md @@ -0,0 +1,112 @@ +--- +layout: default +title: LayoutDimension +parent: SwiftWin32 +--- +# LayoutDimension + +A factory class for creating size-based layout constraint objects using a +fluent API. + +``` swift +public class LayoutDimension: LayoutAnchor +``` + +## Inheritance + +`LayoutAnchor` + +## Methods + +### `constraint(equalTo:multiplier:)` + +Returns a constraint that defines the anchor's size attribute as equal to +the specified anchor multiplied by the constant. + +``` swift +public func constraint(equalTo anchor: LayoutDimension, multiplier: Double) + -> LayoutConstraint +``` + +### `constraint(equalTo:multiplier:constant:)` + +Returns a constraint that defines the anchor's size attribute as equal to +the specified size attribute multiplied by a constant plus an offset. + +``` swift +public func constraint(equalTo anchor: LayoutDimension, multiplier: Double, + constant offset: Double) -> LayoutConstraint +``` + +### `constraint(equalToConstant:)` + +Returns a constraint that defines a constant size for the anchor's size +attribute. + +``` swift +public func constraint(equalToConstant constant: Double) -> LayoutConstraint +``` + +### `constraint(greaterThanOrEqualTo:multiplier:)` + +Returns a constraint that defines the anchor's size attribute as greater +than or equal to the specified anchor multiplied by the constant. + +``` swift +public func constraint(greaterThanOrEqualTo anchor: LayoutDimension, + multiplier: Double) -> LayoutConstraint +``` + +### `constraint(greaterThanOrEqualTo:multiplier:constant:)` + +Returns a constraint that defines teh anchor's size attribute greater than +or equal to the specified anchor multiplied by the constant plus an +offset. + +``` swift +public func constraint(greaterThanOrEqualTo anchor: LayoutDimension, + multiplier: Double, constant offset: Double) + -> LayoutConstraint +``` + +### `constraint(greaterThanOrEqualToConstant:)` + +Returns a constraint that defines the minimum size for the anchor's size +attribute. + +``` swift +public func constraint(greaterThanOrEqualToConstant constant: Double) + -> LayoutConstraint +``` + +### `constraint(lessThanOrEqualTo:multiplier:)` + +Returns a constraint that defines the anchor's size attribute as less than +or requal to the specified anchor multiplied by the constant. + +``` swift +public func constraint(lessThanOrEqualTo anchor: LayoutDimension, + multiplier: Double) -> LayoutConstraint +``` + +### `constraint(lessThanOrEqualTo:multiplier:constant:)` + +Returns a constraint that defines the anchor's size attribute as greater +than or equal to the specified anchor multiplied by the constant plus an +offset. + +``` swift +public func constraint(lessThanOrEqualTo anchor: LayoutDimension, + multiplier: Double, constant offset: Double) + -> LayoutConstraint +``` + +### `constraint(lessThanOrEqualToConstant:)` + +Returns a constraint that defines the maximum size for teh anchor's size +attribute. + +``` swift +public func constraint(lessThanOrEqualToConstant constant: Double) + -> LayoutConstraint +``` diff --git a/SwiftWin32/LayoutGuide.md b/SwiftWin32/LayoutGuide.md new file mode 100644 index 00000000..00fb86a0 --- /dev/null +++ b/SwiftWin32/LayoutGuide.md @@ -0,0 +1,119 @@ +--- +layout: default +title: LayoutGuide +parent: SwiftWin32 +--- +# LayoutGuide + +``` swift +public class LayoutGuide +``` + +## Properties + +### `identifier` + +A string used to identify the layout guide. + +``` swift +public var identifier: String = "" +``` + +### `layoutFrame` + +The layout guide's frame in its owning view's coordinate system. + +``` swift +public private(set) var layoutFrame: Rect = .zero +``` + +### `owningView` + +The view that owns the layout guide. + +``` swift +public weak var owningView: View? +``` + +### `bottomAnchor` + +A layout anchor representing the bottom edge of the layout guide's frame. + +``` swift +public var bottomAnchor: LayoutYAxisAnchor +``` + +### `centerXAnchor` + +A layout anchor representing the horizontal center of the layout guide's +frame. + +``` swift +public var centerXAnchor: LayoutXAxisAnchor +``` + +### `centerYAnchor` + +A layout anchor representing the vertical center of the layout guide's +frame. + +``` swift +public var centerYAnchor: LayoutYAxisAnchor +``` + +### `heightAnchor` + +A layout anchor representing the height of the layout guide's frame. + +``` swift +public var heightAnchor: LayoutDimension +``` + +### `leadingAnchor` + +A layout anchor representing the leading edge of the layout guide's frame. + +``` swift +public var leadingAnchor: LayoutXAxisAnchor +``` + +### `leftAnchor` + +A layout anchor representing the left edge of the layout guide's frame. + +``` swift +public var leftAnchor: LayoutXAxisAnchor +``` + +### `rightAnchor` + +A layout anchor representing the right edge of the layout guide's frame. + +``` swift +public var rightAnchor: LayoutXAxisAnchor +``` + +### `topAnchor` + +A layout anchor representing the top edge of teh layout guide's frame. + +``` swift +public var topAnchor: LayoutYAxisAnchor +``` + +### `trailingAnchor` + +A layout anchor representing the trailing edge of teh layout guide's +frame. + +``` swift +public var trailingAnchor: LayoutXAxisAnchor +``` + +### `widthAnchor` + +A layout anchor representing the width of the layout guide's frame. + +``` swift +public var widthAnchor: LayoutDimension +``` diff --git a/SwiftWin32/LayoutPriority.md b/SwiftWin32/LayoutPriority.md new file mode 100644 index 00000000..e0247297 --- /dev/null +++ b/SwiftWin32/LayoutPriority.md @@ -0,0 +1,106 @@ +--- +layout: default +title: LayoutPriority +parent: SwiftWin32 +--- +# LayoutPriority + +The layout priority is used to indicate to the constraint-based layout +system which constraints are more important, allowing the system to make +appropriate tradeoffs when satisfying the constraints of the system as a +whole. + +``` swift +public struct LayoutPriority: Equatable, Hashable, RawRepresentable +``` + +## Inheritance + +`Equatable`, `Hashable`, `RawRepresentable` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = Float +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +### `init(_:)` + +``` swift +public init(_ rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `required` + +A required constraint. + +``` swift +public static var required: LayoutPriority +``` + +### `defaultHigh` + +The priority level with which a button resists compressing its content. + +``` swift +public static var defaultHigh: LayoutPriority +``` + +### `defaultLow` + +The priority level with which a button hugs its contents horizontally. + +``` swift +public static var defaultLow: LayoutPriority +``` + +### `fittingSizeLevel` + +The priority level with which the view wants to conform to the target size +in that computation. + +``` swift +public static var fittingSizeLevel: LayoutPriority +``` + +### `dragThatCanResizeScene` + +The priority with which a drag may end up resizing the window's scene. + +``` swift +public static var dragThatCanResizeScene: LayoutPriority +``` + +### `dragThatCannotResizeScene` + +The priority with which the a split view divider is dragged. + +``` swift +public static var dragThatCannotResizeScene: LayoutPriority +``` + +### `sceneSizeStayPut` + +The priority with which the window's scene prefers to stay the same size. + +``` swift +public static var sceneSizeStayPut: LayoutPriority +``` diff --git a/SwiftWin32/LayoutSupport.md b/SwiftWin32/LayoutSupport.md new file mode 100644 index 00000000..9d54ccb0 --- /dev/null +++ b/SwiftWin32/LayoutSupport.md @@ -0,0 +1,47 @@ +--- +layout: default +title: LayoutSupport +parent: SwiftWin32 +--- +# LayoutSupport + +A set of methods that provide layout support and access to layout anchors. + +``` swift +public protocol LayoutSupport +``` + +## Requirements + +### length + +Provides the length, in points, of the portion of the view controller's +view that is overlaid by translucent or transparent bars. + +``` swift +var length: Double +``` + +### bottomAnchor + +A layout anchor representing the guide's bottom edge. + +``` swift +var bottomAnchor: LayoutYAxisAnchor +``` + +### heightAnchor + +A layout anchor repreenting the guide's height. + +``` swift +var heightAnchor: LayoutDimension +``` + +### topAnchor + +A layout anchor representing the guide's top edge. + +``` swift +var topAnchor: LayoutYAxisAnchor +``` diff --git a/SwiftWin32/LayoutXAxisAnchor.md b/SwiftWin32/LayoutXAxisAnchor.md new file mode 100644 index 00000000..c73659f3 --- /dev/null +++ b/SwiftWin32/LayoutXAxisAnchor.md @@ -0,0 +1,57 @@ +--- +layout: default +title: LayoutXAxisAnchor +parent: SwiftWin32 +--- +# LayoutXAxisAnchor + +A factory class for creating horizontal layout constraint objects using a +fluent API. + +``` swift +public class LayoutXAxisAnchor: LayoutAnchor +``` + +## Inheritance + +`LayoutAnchor` + +## Methods + +### `constraint(equalToSystemSpacingBelow:multiplier:)` + +Returns a constraint that defines by how much the current anchor trails +the specified anchor. + +``` swift +public func constraint(equalToSystemSpacingBelow anchor: LayoutXAxisAnchor, + multiplier: Double) -> LayoutConstraint +``` + +### `constraint(greaterThanOrEqualToSystemSpacingBelow:multiplier:)` + +Returns a constraint that defines by how much the current anchor trails +the specified anchor. + +``` swift +public func constraint(greaterThanOrEqualToSystemSpacingBelow anchor: LayoutXAxisAnchor, + multiplier: Double) -> LayoutConstraint +``` + +### `constraint(lessThanOrEqualToSystemSpacingBelow:multiplier:)` + +Returns a constraint that defines the minimum distance by which the +current anchor is positioned below the specified anchor. + +``` swift +public func constraint(lessThanOrEqualToSystemSpacingBelow anchor: LayoutXAxisAnchor, + multiplier: Double) -> LayoutConstraint +``` + +### `anchorWithOffset(to:)` + +Creates a layout dimension object from two anchors. + +``` swift +public func anchorWithOffset(to anchor: LayoutXAxisAnchor) -> LayoutDimension +``` diff --git a/SwiftWin32/LayoutYAxisAnchor.md b/SwiftWin32/LayoutYAxisAnchor.md new file mode 100644 index 00000000..3554c621 --- /dev/null +++ b/SwiftWin32/LayoutYAxisAnchor.md @@ -0,0 +1,57 @@ +--- +layout: default +title: LayoutYAxisAnchor +parent: SwiftWin32 +--- +# LayoutYAxisAnchor + +A factory class for creating vertical layout constraint objects using a +fluent API. + +``` swift +public class LayoutYAxisAnchor: LayoutAnchor +``` + +## Inheritance + +`LayoutAnchor` + +## Methods + +### `constraint(equalToSystemSpacingBelow:multiplier:)` + +Returns a constraint that defines the specific distance at which the +current anchor is positioned below the specified anchor. + +``` swift +public func constraint(equalToSystemSpacingBelow anchor: LayoutYAxisAnchor, + multiplier: Double) -> LayoutConstraint +``` + +### `constraint(greaterThanOrEqualToSystemSpacingBelow:multiplier:)` + +Returns a constraint that defines the minimum distance by which the +current anchor is positioned below the specified anchor. + +``` swift +public func constraint(greaterThanOrEqualToSystemSpacingBelow anchor: LayoutYAxisAnchor, + multiplier: Double) -> LayoutConstraint +``` + +### `constraint(lessThanOrEqualToSystemSpacingBelow:multiplier:)` + +Returns a constraint that defines the maximum distance by which the +current anchor is positioned below the specified anchor. + +``` swift +public func constraint(lessThanOrEqualToSystemSpacingBelow anchor: LayoutYAxisAnchor, + multiplier: Double) -> LayoutConstraint +``` + +### `anchorWithOffset(to:)` + +Creates a layout dimension object from two anchors. + +``` swift +public func anchorWithOffset(to anchor: LayoutYAxisAnchor) -> LayoutDimension +``` diff --git a/SwiftWin32/LegibilityWeight.md b/SwiftWin32/LegibilityWeight.md new file mode 100644 index 00000000..f3304c11 --- /dev/null +++ b/SwiftWin32/LegibilityWeight.md @@ -0,0 +1,44 @@ +--- +layout: default +title: LegibilityWeight +parent: SwiftWin32 +--- +# LegibilityWeight + +The font weight to apply to text. + +``` swift +public enum LegibilityWeight: Int +``` + +The legibility weight reflects the value of the Bold Text display setting. + +## Inheritance + +`Int` + +## Enumeration Cases + +### `unspecified` + +An unspecified text weight. + +``` swift +case unspecified = -1 +``` + +### `regular` + +A regular font weight. + +``` swift +case regular +``` + +### `bold` + +A bold font weight. + +``` swift +case bold +``` diff --git a/SwiftWin32/LineBreakMode.md b/SwiftWin32/LineBreakMode.md new file mode 100644 index 00000000..ecd69099 --- /dev/null +++ b/SwiftWin32/LineBreakMode.md @@ -0,0 +1,71 @@ +--- +layout: default +title: LineBreakMode +parent: SwiftWin32 +--- +# LineBreakMode + +Constants that specify what happens when a line is too long for its +container. + +``` swift +public enum LineBreakMode: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `byWordWrapping` + +Wrapping occurs at word boundaries, unless the word doesn’t fit on a +single line. + +``` swift +case byWordWrapping +``` + +### `byCharWrapping` + +Wrapping occurs before the first character that doesn’t fit. + +``` swift +case byCharWrapping +``` + +### `byClipping` + +Lines don't extend past the edge of the text container. + +``` swift +case byClipping +``` + +### `byTruncatingHead` + +The line displays so that the end fits in the container and an ellipsis +glyph indicates the missing text at the beginning of the line. + +``` swift +case byTruncatingHead +``` + +### `byTruncatingTail` + +The line displays so that the beginning fits in the container and an +ellipsis glyph indicates the missing text at the end of the line. + +``` swift +case byTruncatingTail +``` + +### `byTruncatingMiddle` + +The line displays so that the beginning and end fit in the container and +an ellipsis glyph indicates the missing text in the middle. + +``` swift +case byTruncatingMiddle +``` diff --git a/SwiftWin32/ListContentConfiguration.md b/SwiftWin32/ListContentConfiguration.md new file mode 100644 index 00000000..e0acb17b --- /dev/null +++ b/SwiftWin32/ListContentConfiguration.md @@ -0,0 +1,286 @@ +--- +layout: default +title: ListContentConfiguration +parent: SwiftWin32 +--- +# ListContentConfiguration + +A content configuration for a list-based content view. + +``` swift +public struct ListContentConfiguration +``` + +## Inheritance + +[`ContentConfiguration`](https://compnerd.github.io/swift-win32/SwiftWin32/ContentConfiguration), `CustomDebugStringConvertible`, `CustomReflectable`, `CustomStringConvertible`, `Hashable` + +## Properties + +### `image` + +The image to display. + +``` swift +public var image: Image? +``` + +### `text` + +The primary text. + +``` swift +public var text: String? +``` + +### `attributedText` + +An attributed variant of the primary text. + +``` swift +public var attributedText: NSAttributedString? +``` + +### `secondaryText` + +The secondary text. + +``` swift +public var secondaryText: String? +``` + +### `secondaryAttributedText` + +An attributed variant of the secondary text. + +``` swift +public var secondaryAttributedText: NSAttributedString? +``` + +### `imageProperties` + +Properties for configuring the image. + +``` swift +public var imageProperties: ListContentConfiguration.ImageProperties +``` + +### `textProperties` + +Properties for configuring the primary text. + +``` swift +public var textProperties: ListContentConfiguration.TextProperties +``` + +### `secondaryTextProperties` + +Properties for configuring the secondary text. + +``` swift +public var secondaryTextProperties: ListContentConfiguration.TextProperties +``` + +### `axesPreservingSuperviewLayoutMargins` + +A boolean value that detemines whether the content view preserves the +layout margins that it inherits from its superview on the horizontal or +vertical axes. + +``` swift +public var axesPreservingSuperviewLayoutMargins: Axis = .both +``` + +### `directionalLayoutMargins` + +The margins between the content and the edges of the content view. + +``` swift +public var directionalLayoutMargins: DirectionalEdgeInsets +``` + +### `prefersSideBySideTextAndSecondaryText` + +A boolean value that detemines whether the configuration positions the +text and secondary text side by side. + +``` swift +public var prefersSideBySideTextAndSecondaryText: Bool +``` + +### `imageToTextPadding` + +The padding between the image and text. + +``` swift +public var imageToTextPadding: Double +``` + +### `textToSecondaryTextHorizontalPadding` + +The minimum horizontal padding between the text and secondary text. + +``` swift +public var textToSecondaryTextHorizontalPadding: Double +``` + +### `textToSecondaryTextVerticalPadding` + +The vertical padding between the text and secondary text. + +``` swift +public var textToSecondaryTextVerticalPadding: Double +``` + +### `description` + +``` swift +public var description: String +``` + +### `debugDescription` + +``` swift +public var debugDescription: String +``` + +### `customMirror` + +``` swift +public var customMirror: Mirror +``` + +## Methods + +### `cell()` + +Creates the default configuration for a list cell. + +``` swift +public static func cell() -> ListContentConfiguration +``` + +### `subtitleCell()` + +Creates the default configuration for a list cell with subtitle text. + +``` swift +public static func subtitleCell() -> ListContentConfiguration +``` + +### `valueCell()` + +Creates the default configuration for a list cell with side-by-side value +text. + +``` swift +public static func valueCell() -> ListContentConfiguration +``` + +### `plainHeader()` + +Creates the default configuration for a plain list header. + +``` swift +public static func plainHeader() -> ListContentConfiguration +``` + +### `plainFooter()` + +Creates the default configuration for a plain list footer. + +``` swift +public static func plainFooter() -> ListContentConfiguration +``` + +### `groupedHeader()` + +Creates the default configuration for a grouped list header. + +``` swift +public static func groupedHeader() -> ListContentConfiguration +``` + +### `groupedFooter()` + +Creates the default configuration for a grouped list footer. + +``` swift +public static func groupedFooter() -> ListContentConfiguration +``` + +### `sidebarCell()` + +Creates the default configuration for a sidebar list cell. + +``` swift +public static func sidebarCell() -> ListContentConfiguration +``` + +### `sidebarSubtitleCell()` + +Creates the default configuration for a sidebar list cell with subtitle +text. + +``` swift +public static func sidebarSubtitleCell() -> ListContentConfiguration +``` + +### `sidebarHeader()` + +Creates the default configuration for a sidebar list header. + +``` swift +public static func sidebarHeader() -> ListContentConfiguration +``` + +### `accompaniedSidebarCell()` + +Creates the default configuration for an accompanied sidebar list cell. + +``` swift +public static func accompaniedSidebarCell() -> ListContentConfiguration +``` + +### `accompaniedSidebarSubtitleCell()` + +Creates the default configuration for an accompanied sidebar list cell +with subtitle text. + +``` swift +public static func accompaniedSidebarSubtitleCell() + -> ListContentConfiguration +``` + +### `makeContentView()` + +Creates a new instance of the content view using this configuration. + +``` swift +public func makeContentView() -> View & ContentView +``` + +### `updated(for:)` + +Generates a configuration for the specified state by applying the +configuration's default values for that state to any properties that you +haven't customized. + +``` swift +public func updated(for state: ConfigurationState) -> ListContentConfiguration +``` + +### `hash(into:)` + +``` swift +public func hash(into hasher: inout Hasher) +``` + +## Operators + +### `==` + +``` swift +public static func ==(_ lhs: ListContentConfiguration, + _ rhs: ListContentConfiguration) -> Bool +``` diff --git a/SwiftWin32/ListContentConfiguration_ImageProperties.md b/SwiftWin32/ListContentConfiguration_ImageProperties.md new file mode 100644 index 00000000..af928d78 --- /dev/null +++ b/SwiftWin32/ListContentConfiguration_ImageProperties.md @@ -0,0 +1,130 @@ +--- +layout: default +title: ListContentConfiguration.ImageProperties +parent: SwiftWin32 +--- +# ListContentConfiguration.ImageProperties + +Properties that affect the list content configuration's image. + +``` swift +public struct ImageProperties +``` + +## Inheritance + +`CustomDebugStringConvertible`, `CustomReflectable`, `CustomStringConvertible`, `Hashable` + +## Properties + +### `preferredSymbolConfiguration` + +The symbol configuration to use. + +``` swift +public var preferredSymbolConfiguration: Image.SymbolConfiguration? +``` + +### `tintColor` + +The tint color to apply to the image view. + +``` swift +public var tintColor: Color? +``` + +### `tintColorTransformer` + +The color transformer for resolving the tint color. + +``` swift +public var tintColorTransformer: ConfigurationColorTransformer? +``` + +### `cornerRadius` + +The preferred corner radius, using a continuous corner curve, for the +image. + +``` swift +public var cornerRadius: Double +``` + +### `maximumSize` + +The maximum size for the image. + +``` swift +public var maximumSize: Size = .zero +``` + +### `reservedLayoutSize` + +The layout size that the system reserves for the image, and then centers +the image within. + +``` swift +public var reservedLayoutSize: Size = .zero +``` + +### `standardDimension` + +The system standard layout dimension for reserved layout size. + +``` swift +public static var standardDimension: Double +``` + +### `accessibilityIgnoresInvertColors` + +A boolean value that determines whether the image inverts its colors +when the user turns on the Invert Colors accessibility setting. + +``` swift +public var accessibilityIgnoresInvertColors: Bool = false +``` + +### `description` + +``` swift +public var description: String +``` + +### `debugDescription` + +``` swift +public var debugDescription: String +``` + +### `customMirror` + +``` swift +public var customMirror: Mirror +``` + +## Methods + +### `resolvedTintColor(for:)` + +Generates the resolved tint color for the specified tint color, using +the tint color and color transformer. + +``` swift +public func resolvedTintColor(for tintColor: Color) -> Color +``` + +### `hash(into:)` + +``` swift +public func hash(into hasher: inout Hasher) +``` + +## Operators + +### `==` + +``` swift +public static func ==(_ lhs: ListContentConfiguration.ImageProperties, + _ rhs: ListContentConfiguration.ImageProperties) + -> Bool +``` diff --git a/SwiftWin32/ListContentConfiguration_TextProperties.md b/SwiftWin32/ListContentConfiguration_TextProperties.md new file mode 100644 index 00000000..445e12c5 --- /dev/null +++ b/SwiftWin32/ListContentConfiguration_TextProperties.md @@ -0,0 +1,118 @@ +--- +layout: default +title: ListContentConfiguration.TextProperties +parent: SwiftWin32 +--- +# ListContentConfiguration.TextProperties + +Properties that affect the list content configuration's text. + +``` swift +public struct TextProperties +``` + +## Properties + +### `font` + +The font for the text. + +``` swift +public var font: Font +``` + +### `color` + +The color of the text. + +``` swift +public var color: Color +``` + +### `colorTransformer` + +The color transformer for resolving the text color. + +``` swift +public var colorTransformer: ConfigurationColorTransformer? +``` + +### `alignment` + +The alignment for the text. + +``` swift +public var alignment: TextProperties.TextAlignment +``` + +### `lineBreakMode` + +The line break mode to use for the text. + +``` swift +public var lineBreakMode: LineBreakMode +``` + +### `numberOfLines` + +The maximum number of lines for the text. + +``` swift +public var numberOfLines: Int +``` + +### `adjustsFontSizeToFitWidth` + +A boolean value that detemines whether the configuration automatically +adjusts the font size of the text when necessary to fit in the available +width. + +``` swift +public var adjustsFontSizeToFitWidth: Bool +``` + +### `minimumScaleFactor` + +The smallest multiplier for the font size that the configuration uses to +make the text fit. + +``` swift +public var minimumScaleFactor: Double +``` + +### `allowsDefaultTighteningForTruncation` + +A boolean value that detemines whether the configuration tightens the +text before truncating. + +``` swift +public var allowsDefaultTighteningForTruncation: Bool +``` + +### `adjustsFontForContentSizeCategory` + +A boolean value that detemines whether the configuration automatically +updates the font when the content size category changes. + +``` swift +public var adjustsFontForContentSizeCategory: Bool +``` + +### `transform` + +The transform to apply to the text. + +``` swift +public var transform: TextProperties.TextTransform +``` + +## Methods + +### `resolvedColor()` + +Generates the resolved color for the specified color, using the text +color and color transformer. + +``` swift +public func resolvedColor() -> Color +``` diff --git a/SwiftWin32/ListContentConfiguration_TextProperties_TextAlignment.md b/SwiftWin32/ListContentConfiguration_TextProperties_TextAlignment.md new file mode 100644 index 00000000..82cada7f --- /dev/null +++ b/SwiftWin32/ListContentConfiguration_TextProperties_TextAlignment.md @@ -0,0 +1,22 @@ +--- +layout: default +title: ListContentConfiguration.TextProperties.TextAlignment +parent: SwiftWin32 +--- +# Extensions on ListContentConfiguration.TextProperties.TextAlignment + +## Methods + +### `==` + +``` swift +public static func ==(_ lhs: ListContentConfiguration.TextProperties.TextAlignment, + _ rhs: ListContentConfiguration.TextProperties.TextAlignment) + -> Bool +``` + +### `hash(into:)` + +``` swift +public func hash(into hasher: inout Hasher) +``` diff --git a/SwiftWin32/ListContentConfiguration_TextProperties_TextTransform.md b/SwiftWin32/ListContentConfiguration_TextProperties_TextTransform.md new file mode 100644 index 00000000..4a99bdbd --- /dev/null +++ b/SwiftWin32/ListContentConfiguration_TextProperties_TextTransform.md @@ -0,0 +1,22 @@ +--- +layout: default +title: ListContentConfiguration.TextProperties.TextTransform +parent: SwiftWin32 +--- +# Extensions on ListContentConfiguration.TextProperties.TextTransform + +## Methods + +### `==` + +``` swift +public static func ==(_ lhs: ListContentConfiguration.TextProperties.TextTransform, + _ rhs: ListContentConfiguration.TextProperties.TextTransform) + -> Bool +``` + +### `hash(into:)` + +``` swift +public func hash(into hasher: inout Hasher) +``` diff --git a/SwiftWin32/Menu.md b/SwiftWin32/Menu.md new file mode 100644 index 00000000..1700ae47 --- /dev/null +++ b/SwiftWin32/Menu.md @@ -0,0 +1,81 @@ +--- +layout: default +title: Menu +parent: SwiftWin32 +--- +# Menu + +A container for grouping related menu elements in an application menu or +contextual menu. + +``` swift +open class Menu: MenuElement +``` + +## Inheritance + +[`MenuElement`](https://compnerd.github.io/swift-win32/SwiftWin32/MenuElement), `Equatable`, `Hashable` + +## Initializers + +### `init(title:image:identifier:options:children:)` + +Creates a new menu with the specified values. + +``` swift +public /*convenience*/ init(title: String = "", image: Image? = nil, + identifier: Menu.Identifier? = nil, + options: Menu.Options = [], + children: [MenuElement] = []) +``` + +## Properties + +### `children` + +The contents of the menu. + +``` swift +public internal(set) var children: [MenuElement] +``` + +### `identifier` + +The unique identifier for the current menu. + +``` swift +open private(set) var identifier: Menu.Identifier +``` + +### `options` + +The configuration options for the current menu. + +``` swift +open private(set) var options: Menu.Options +``` + +## Methods + +### `replacingChildren(_:)` + +Creates a new menu with the same configuration as the current menu, but +with a new set of child elements. + +``` swift +open func replacingChildren(_ newChildren: [MenuElement]) -> Menu +``` + +### `hash(into:)` + +``` swift +public func hash(into hasher: inout Hasher) +``` + +## Operators + +### `==` + +``` swift +public static func ==(_ lhs: Menu, _ rhs: Menu) -> Bool +``` diff --git a/SwiftWin32/MenuBuilder.md b/SwiftWin32/MenuBuilder.md new file mode 100644 index 00000000..29b05165 --- /dev/null +++ b/SwiftWin32/MenuBuilder.md @@ -0,0 +1,110 @@ +--- +layout: default +title: MenuBuilder +parent: SwiftWin32 +--- +# MenuBuilder + +An interface for adding and removing menus from a menu system. + +``` swift +public protocol MenuBuilder +``` + +## Requirements + +### system + +The menu system that the menu builder modifies. + +``` swift +var system: MenuSystem +``` + +### menu(for:​) + +Gets the menu for the specified menu identifier. + +``` swift +func menu(for identifier: Menu.Identifier) -> Menu? +``` + +### action(for:​) + +Gets the action for the specified action identifier. + +``` swift +func action(for identifier: Action.Identifier) -> Action? +``` + +### command(for:​propertyList:​) + +Gets the command for the specified selector and property list. + +``` swift +func command(for action: @escaping (_: AnyObject?) -> Void, + propertyList: Any?) -> Command? +``` + +### insertChild(\_:​atStartOfMenu:​) + +Adds a child menu as the first element of the specified parent menu. + +``` swift +func insertChild(_ childMenu: Menu, + atStartOfMenu parentIdentifier: Menu.Identifier) +``` + +### insertChild(\_:​atEndOfMenu:​) + +Adds a child menu as the last element of the specified parent menu. + +``` swift +func insertChild(_ childMenu: Menu, + atEndOfMenu parentIdentifier: Menu.Identifier) +``` + +### insertSibling(\_:​beforeMenu:​) + +Inserts a sibling menu before the specified menu. + +``` swift +func insertSibling(_ siblingMenu: Menu, + beforeMenu siblingIdentifier: Menu.Identifier) +``` + +### insertSibling(\_:​afterMenu:​) + +Inserts a sibling menu after the specified menu. + +``` swift +func insertSibling(_ siblingMenu: Menu, + afterMenu siblingIdentifier: Menu.Identifier) +``` + +### replace(menu:​with:​) + +Replaces the specified menu with a new menu. + +``` swift +func replace(menu replacedIdentifier: Menu.Identifier, + with replacementMenu: Menu) +``` + +### replaceChildren(ofMenu:​from:​) + +Replaces the elements in a menu with the elements returned by the +specified handler block. + +``` swift +func replaceChildren(ofMenu parentIdentifier: Menu.Identifier, + from childrenBlock: ([MenuElement]) -> [MenuElement]) +``` + +### remove(menu:​) + +Removes a menu from the menu system. + +``` swift +func remove(menu removedIdentifier: Menu.Identifier) +``` diff --git a/SwiftWin32/MenuElement.md b/SwiftWin32/MenuElement.md new file mode 100644 index 00000000..b6d50dfd --- /dev/null +++ b/SwiftWin32/MenuElement.md @@ -0,0 +1,41 @@ +--- +layout: default +title: MenuElement +parent: SwiftWin32 +--- +# MenuElement + +An object representing a menu, action, or command. + +``` swift +open class MenuElement +``` + +## Initializers + +### `init(title:image:)` + +Creates and returns a `MenuElement` initialized with the given title and +image. + +``` swift +public init(title: String, image: Image? = nil) +``` + +## Properties + +### `title` + +The title of the menu element. + +``` swift +open internal(set) var title: String +``` + +### `image` + +The image to display alongside the menu element's title. + +``` swift +open internal(set) var image: Image? +``` diff --git a/SwiftWin32/MenuElement_Attributes.md b/SwiftWin32/MenuElement_Attributes.md new file mode 100644 index 00000000..d0e31bb6 --- /dev/null +++ b/SwiftWin32/MenuElement_Attributes.md @@ -0,0 +1,64 @@ +--- +layout: default +title: MenuElement.Attributes +parent: SwiftWin32 +--- +# MenuElement.Attributes + +Attributes that determine the style of the menu element. + +``` swift +public struct Attributes: OptionSet +``` + +## Inheritance + +`OptionSet` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = Int +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `destructive` + +An attribute indicating the destructive style. + +``` swift +public static var destructive: MenuElement.Attributes +``` + +### `disabled` + +An attribute indicating the disabled style. + +``` swift +public static var disabled: MenuElement.Attributes +``` + +### `hidden` + +An attribute indicating the hidden style. + +``` swift +public static var hidden: MenuElement.Attributes +``` diff --git a/SwiftWin32/MenuElement_State.md b/SwiftWin32/MenuElement_State.md new file mode 100644 index 00000000..2897d4ec --- /dev/null +++ b/SwiftWin32/MenuElement_State.md @@ -0,0 +1,43 @@ +--- +layout: default +title: MenuElement.State +parent: SwiftWin32 +--- +# MenuElement.State + +Constants that indicate the state of an action-based or command-based +menu element. + +``` swift +public enum State: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `off` + +A constant indicating the menu element is in the "off" state. + +``` swift +case off +``` + +### `on` + +A constant indicating the menu element is in the "on" state. + +``` swift +case on +``` + +### `mixed` + +A constant indicating the menu element is in the "mixed" state. + +``` swift +case mixed +``` diff --git a/SwiftWin32/MenuSystem.md b/SwiftWin32/MenuSystem.md new file mode 100644 index 00000000..c89d2c71 --- /dev/null +++ b/SwiftWin32/MenuSystem.md @@ -0,0 +1,48 @@ +--- +layout: default +title: MenuSystem +parent: SwiftWin32 +--- +# MenuSystem + +An object representing a main or contextual menu system. + +``` swift +open class MenuSystem +``` + +## Properties + +### `main` + +The main menu system. + +``` swift +open class var main: MenuSystem +``` + +### `context` + +The context menu system. + +``` swift +open class var context: MenuSystem +``` + +## Methods + +### `setNeedsRebuild()` + +Tells the menu system to rebuild all of its menus. + +``` swift +open func setNeedsRebuild() +``` + +### `setNeedsRevalidate()` + +Tells the menu system to validate all of its menus. + +``` swift +open func setNeedsRevalidate() +``` diff --git a/SwiftWin32/Menu_Identifier.md b/SwiftWin32/Menu_Identifier.md new file mode 100644 index 00000000..b4705466 --- /dev/null +++ b/SwiftWin32/Menu_Identifier.md @@ -0,0 +1,376 @@ +--- +layout: default +title: Menu.Identifier +parent: SwiftWin32 +--- +# Menu.Identifier + +Constants for identifying an application's standard menus. + +``` swift +public struct Identifier: Equatable, Hashable, RawRepresentable +``` + +## Inheritance + +`Equatable`, `Hashable`, `RawRepresentable` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = String +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: String) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `root` + +The root menu. + +``` swift +public static var root: Menu.Identifier +``` + +### `application` + +The standard application menu. + +``` swift +public static var application: Menu.Identifier +``` + +### `file` + +The standard File menu. + +``` swift +public static var file: Menu.Identifier +``` + +### `edit` + +The standard Edit menu. + +``` swift +public static var edit: Menu.Identifier +``` + +### `view` + +The standard View menu. + +``` swift +public static var view: Menu.Identifier +``` + +### `window` + +The standard Window menu. + +``` swift +public static var window: Menu.Identifier +``` + +### `help` + +The standard Help menu. + +``` swift +public static var help: Menu.Identifier +``` + +### `about` + +The About menu. + +``` swift +public static var about: Menu.Identifier +``` + +### `preferences` + +The Preferences menu. + +``` swift +public static var preferences: Menu.Identifier +``` + +### `services` + +The Services menu. + +``` swift +public static var services: Menu.Identifier +``` + +### `hide` + +The Hide menu. + +``` swift +public static var hide: Menu.Identifier +``` + +### `quit` + +The Quit menu. + +``` swift +public static var quit: Menu.Identifier +``` + +### `newScene` + +The New Scene menu. + +``` swift +public static var newScene: Menu.Identifier +``` + +### `close` + +The Close menu. + +``` swift +public static var close: Menu.Identifier +``` + +### `print` + +The Print menu. + +``` swift +public static var print: Menu.Identifier +``` + +### `undoRedo` + +The Undo/Redo menu. + +``` swift +public static var undoRedo: Menu.Identifier +``` + +### `standardEdit` + +The standard Edit menu. + +``` swift +public static var standardEdit: Menu.Identifier +``` + +### `find` + +The Find menu. + +``` swift +public static var find: Menu.Identifier +``` + +### `replace` + +The Replace menu. + +``` swift +public static var replace: Menu.Identifier +``` + +### `share` + +The Share menu. + +``` swift +public static var share: Menu.Identifier +``` + +### `textStyle` + +The Text Style menu. + +``` swift +public static var textStyle: Menu.Identifier +``` + +### `spelling` + +The Spelling menu. + +``` swift +public static var spelling: Menu.Identifier +``` + +### `spellingPanel` + +The Spelling Panel menu. + +``` swift +public static var spellingPanel: Menu.Identifier +``` + +### `spellingOptions` + +The Spelling Options menu. + +``` swift +public static var spellingOptions: Menu.Identifier +``` + +### `subsitutions` + +The Subsitutions menu. + +``` swift +public static var subsitutions: Menu.Identifier +``` + +### `subsitutionsPanel` + +The Subsitutions Panel menu. + +``` swift +public static var subsitutionsPanel: Menu.Identifier +``` + +### `transformations` + +The Transformations menu. + +``` swift +public static var transformations: Menu.Identifier +``` + +### `speech` + +The Speech menu. + +``` swift +public static var speech: Menu.Identifier +``` + +### `lookup` + +The Lookup menu. + +``` swift +public static var lookup: Menu.Identifier +``` + +### `learn` + +The Learn menu. + +``` swift +public static var learn: Menu.Identifier +``` + +### `format` + +The Format menu. + +``` swift +public static var format: Menu.Identifier +``` + +### `font` + +The Font menu. + +``` swift +public static var font: Menu.Identifier +``` + +### `textSize` + +The Text Size menu. + +``` swift +public static var textSize: Menu.Identifier +``` + +### `textColor` + +The Text Color menu. + +``` swift +public static var textColor: Menu.Identifier +``` + +### `textStylePasteboard` + +The Text Style Pasteboard menu. + +``` swift +public static var textStylePasteboard: Menu.Identifier +``` + +### `text` + +The Text menu. + +``` swift +public static var text: Menu.Identifier +``` + +### `writingDirection` + +The Writing Direction menu. + +``` swift +public static var writingDirection: Menu.Identifier +``` + +### `alignment` + +The Alignment menu. + +``` swift +public static var alignment: Menu.Identifier +``` + +### `toolbar` + +The Toolbar menu group. + +``` swift +public static var toolbar: Menu.Identifier +``` + +### `fullscreen` + +The Fullscreen menu. + +``` swift +public static var fullscreen: Menu.Identifier +``` + +### `bringAllToFront` + +The Bring All to Front menu. + +``` swift +public static var bringAllToFront: Menu.Identifier +``` + +### `minimizeAndZoom` + +The Minimize and Zoom menu. + +``` swift +public static var minimizeAndZoom: Menu.Identifier +``` diff --git a/SwiftWin32/Menu_Options.md b/SwiftWin32/Menu_Options.md new file mode 100644 index 00000000..42c0f3ea --- /dev/null +++ b/SwiftWin32/Menu_Options.md @@ -0,0 +1,58 @@ +--- +layout: default +title: Menu.Options +parent: SwiftWin32 +--- +# Menu.Options + +Options for configuring a menu's appearance. + +``` swift +public struct Options: OptionSet +``` + +## Inheritance + +`OptionSet` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = UInt +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `displayInline` + +An option indicating the menu displays inline with its parent menu instead +of displaying as a submenu. + +``` swift +public static var displayInline: Menu.Options +``` + +### `destructive` + +An Option indicating the menu's appearance represents a destructive +action. + +``` swift +public static var destructive: Menu.Options +``` diff --git a/SwiftWin32/ModalPresentationStyle.md b/SwiftWin32/ModalPresentationStyle.md new file mode 100644 index 00000000..58ca6f07 --- /dev/null +++ b/SwiftWin32/ModalPresentationStyle.md @@ -0,0 +1,110 @@ +--- +layout: default +title: ModalPresentationStyle +parent: SwiftWin32 +--- +# ModalPresentationStyle + +Modal presentation styles available when presenting view controllers. + +``` swift +public enum ModalPresentationStyle: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `automatic` + +The default presentation style chosen by the system. + +``` swift +case automatic +``` + +### `none` + +A presentation style that indicates no adaptations should be made. + +``` swift +case none +``` + +### `fullScreen` + +A presentation style in which the presented view covers the screen. + +``` swift +case fullScreen +``` + +### `pageSheet` + +A presentation style that partially covers the underlying content. + +``` swift +case pageSheet +``` + +### `formSheet` + +A presentation style that displays the content centered in the screen. + +``` swift +case formSheet +``` + +### `currentContext` + +A presentation style where the content is displayed over another view +controller's content. + +``` swift +case currentContext +``` + +### `custom` + +A custom view presentation style that is managed by a custom presentation +controller and one or more custom animator objects. + +``` swift +case custom +``` + +### `overFullScreen` + +A view presentation style in which the presented view covers the screen. + +``` swift +case overFullScreen +``` + +### `overCurrentContext` + +A presentation style where the content is displayed over another view +controller's content. + +``` swift +case overCurrentContext +``` + +### `popover` + +A presentation style where the content is displayed in a popover view. + +``` swift +case popover +``` + +### `blurOverFullScreen` + +A presentation style that blurs the underlying content before displaying new +content in a full-screen presentation. + +``` swift +case blurOverFullScreen +``` diff --git a/SwiftWin32/ModalTransitionStyle.md b/SwiftWin32/ModalTransitionStyle.md new file mode 100644 index 00000000..a88b5abe --- /dev/null +++ b/SwiftWin32/ModalTransitionStyle.md @@ -0,0 +1,67 @@ +--- +layout: default +title: ModalTransitionStyle +parent: SwiftWin32 +--- +# ModalTransitionStyle + +Transition styles available when presenting view controllers. + +``` swift +public enum ModalTransitionStyle: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `coverVertical` + +When the view controller is presented, its view slides up from the bottom +of the screen. On dismissal, the view slides back down. This is the +default transition style. + +``` swift +case coverVertical +``` + +### `flipHorizontal` + +When the view controller is presented, the current view initiates a +horizontal 3D flip from right-to-left, resulting in the revealing of the +new view as if it were on the back of the previous view. On dismissal, the +flip occurs from left-to-right, returning to the original view. + +``` swift +case flipHorizontal +``` + +### `crossDissolve` + +When the view controller is presented, the current view fades out while +the new view fades in at the same time. On dismissal, a similar type of +cross-fade is used to return to the original view. + +``` swift +case crossDissolve +``` + +### `partialCurl` + +When the view controller is presented, one corner of the current view +curls up to reveal the presented view underneath. On dismissal, the curled +up page unfurls itself back on top of the presented view. A view +controller presented using this transition is itself prevented from +presenting any additional view controllers. + +``` swift +case partialCurl +``` + +This transition style is supported only if the parent view controller is +presenting a full-screen view and you use the +`ModalPresentationStyle.fullScreen` modal presentation style. Attempting +to use a different form factor for the parent view or a different +presentation style triggers an exception. diff --git a/SwiftWin32/Offset.md b/SwiftWin32/Offset.md new file mode 100644 index 00000000..f108abcf --- /dev/null +++ b/SwiftWin32/Offset.md @@ -0,0 +1,81 @@ +--- +layout: default +title: Offset +parent: SwiftWin32 +--- +# Offset + +A structure that specifies an amount to offset a position. + +``` swift +public struct Offset +``` + +## Inheritance + +`Equatable` + +## Initializers + +### `init()` + +``` swift +public init() +``` + +### `init(horizontal:vertical:)` + +``` swift +public init(horizontal: Double, vertical: Double) +``` + +## Properties + +### `horizontal` + +``` swift +public private(set) var horizontal: Double +``` + +### `vertical` + +``` swift +public private(set) var vertical: Double +``` + +### `zero` + +A `Offset` struct whose horizontal and vertical fields are set to the +value 0. + +``` swift +public static var zero: Offset +``` + +## Methods + +### `string(for:)` + +Returns a string formatted to contain the data from an offset structure. + +``` swift +public static func string(for offset: Offset) -> String +``` + +### `offset(for:)` + +Returns an `Offset` structure corresponding to the data in a given string. + +``` swift +public static func offset(for string: String) -> Offset +``` + +In general, you should use this function only to convert strings that were + +## Operators + +### `==` + +``` swift +public static func ==(_ lhs: Offset, _ rhs: Offset) -> Bool +``` diff --git a/SwiftWin32/PickerView.md b/SwiftWin32/PickerView.md new file mode 100644 index 00000000..f6e66b31 --- /dev/null +++ b/SwiftWin32/PickerView.md @@ -0,0 +1,109 @@ +--- +layout: default +title: PickerView +parent: SwiftWin32 +--- +# PickerView + +A view that shows one or more sets of values. + +``` swift +public class PickerView: View +``` + +## Inheritance + +[`View`](https://compnerd.github.io/swift-win32/SwiftWin32/View) + +## Initializers + +### `init(frame:)` + +``` swift +public init(frame: Rect = .zero) +``` + +## Properties + +### `dataSource` + +The data source for the picker view. + +``` swift +public weak var dataSource: PickerViewDataSource? +``` + +### `delegate` + +The delegate for the picker view. + +``` swift +public weak var delegate: PickerViewDelegate? +``` + +### `numberOfComponents` + +Gets the number of components for the picker view. + +``` swift +public var numberOfComponents: Int +``` + +## Methods + +### `numberOfRows(inComponent:)` + +Returns the number of rows for a component. + +``` swift +public func numberOfRows(inComponent component: Int) -> Int +``` + +### `rowSize(forComponent:)` + +Returns the size of a row for a component. + +``` swift +public func rowSize(forComponent component: Int) -> Size +``` + +### `reloadAllComponents()` + +Reloads all components of the picker view. + +``` swift +public func reloadAllComponents() +``` + +### `reloadComponent(_:)` + +Reloads a particular component of the picker view. + +``` swift +public func reloadComponent(_ component: Int) +``` + +### `selectRow(_:inComponent:animated:)` + +Selects a row ina specified component of the picker view. + +``` swift +public func selectRow(_ row: Int, inComponent component: Int, animated: Bool) +``` + +### `selectedRow(inComponent:)` + +Returns the index of the selected row in a given component. + +``` swift +public func selectedRow(inComponent component: Int) -> Int +``` + +### `view(forRow:forComponent:reusing:)` + +Returns the view used by the picker view for a given row and component. + +``` swift +public func view(forRow row: Int, forComponent component: Int, + reusing view: View?) -> View? +``` diff --git a/SwiftWin32/PickerViewDataSource.md b/SwiftWin32/PickerViewDataSource.md new file mode 100644 index 00000000..77d27b00 --- /dev/null +++ b/SwiftWin32/PickerViewDataSource.md @@ -0,0 +1,37 @@ +--- +layout: default +title: PickerViewDataSource +parent: SwiftWin32 +--- +# PickerViewDataSource + +Mediates between a `PickerView` object and your application's data model for +that picker view. + +``` swift +public protocol PickerViewDataSource: AnyObject +``` + +## Inheritance + +`AnyObject` + +## Requirements + +### numberOfComponents(in:​) + +Called by the picker view when it needs the number of components. + +``` swift +func numberOfComponents(in pickerView: PickerView) -> Int +``` + +### pickerView(\_:​numberOfRowsInComponent:​) + +Called by the picker view when it needs the number of rows for a specified +component. + +``` swift +func pickerView(_ pickerView: PickerView, + numberOfRowsInComponent component: Int) -> Int +``` diff --git a/SwiftWin32/PickerViewDelegate.md b/SwiftWin32/PickerViewDelegate.md new file mode 100644 index 00000000..dcbf0ddb --- /dev/null +++ b/SwiftWin32/PickerViewDelegate.md @@ -0,0 +1,125 @@ +--- +layout: default +title: PickerViewDelegate +parent: SwiftWin32 +--- +# PickerViewDelegate + +The delegate of a `PickerView` object must adopt this protocol and implement +at least some of its methods to provide the picker view with the data it +needs to construct itself. + +``` swift +public protocol PickerViewDelegate: AnyObject +``` + +## Inheritance + +`AnyObject` + +## Default Implementations + +### `pickerView(_:rowHeightForComponent:)` + +``` swift +public func pickerView(_ pickerView: PickerView, + rowHeightForComponent component: Int) -> Double +``` + +### `pickerView(_:widthForComponent:)` + +``` swift +public func pickerView(_ pickerView: PickerView, + widthForComponent component: Int) -> Double +``` + +### `pickerView(_:titleForRow:forComponent:)` + +``` swift +public func pickerView(_ pickerView: PickerView, titleForRow row: Int, + forComponent component: Int) -> String? +``` + +### `pickerView(_:attributedTitleForRow:forComponent:)` + +``` swift +public func pickerView(_ pickerView: PickerView, + attributedTitleForRow row: Int, + forComponent component: Int) -> NSAttributedString? +``` + +### `pickerView(_:viewForRow:forComponent:reusing:)` + +``` swift +public func pickerView(_ pickerView: PickerView, viewForRow row: Int, + forComponent component: Int, reusing view: View?) + -> View +``` + +### `pickerView(_:didSelectRow:inComponent:)` + +``` swift +public func pickerView(_ pickerView: PickerView, didSelectRow row: Int, + inComponent component: Int) +``` + +## Requirements + +### pickerView(\_:​rowHeightForComponent:​) + +Called by the picker view when it needs the row height to use for drawing +row content. + +``` swift +func pickerView(_ pickerView: PickerView, + rowHeightForComponent component: Int) -> Double +``` + +### pickerView(\_:​widthForComponent:​) + +Called by the picker view when it needs the row width to use for drawing +row content. + +``` swift +func pickerView(_ pickerView: PickerView, + widthForComponent component: Int) -> Double +``` + +### pickerView(\_:​titleForRow:​forComponent:​) + +Called by the picker view when it needs the title to use for a given row +in a given component. + +``` swift +func pickerView(_ pickerView: PickerView, titleForRow row: Int, + forComponent component: Int) -> String? +``` + +### pickerView(\_:​attributedTitleForRow:​forComponent:​) + +Called by the picker view when it needs the styled title to use for a +given row in a given component. + +``` swift +func pickerView(_ pickerView: PickerView, attributedTitleForRow row: Int, + forComponent component: Int) -> NSAttributedString? +``` + +### pickerView(\_:​viewForRow:​forComponent:​reusing:​) + +Called by the picker view when it needs the view to use for a given row in +a given component. + +``` swift +func pickerView(_ pickerView: PickerView, viewForRow row: Int, + forComponent component: Int, reusing view: View?) -> View +``` + +### pickerView(\_:​didSelectRow:​inComponent:​) + +Called by the picker view when the user selects a row in a component. + +``` swift +func pickerView(_ pickerView: PickerView, didSelectRow row: Int, + inComponent component: Int) +``` diff --git a/SwiftWin32/Point.md b/SwiftWin32/Point.md new file mode 100644 index 00000000..fbc9dd3c --- /dev/null +++ b/SwiftWin32/Point.md @@ -0,0 +1,85 @@ +--- +layout: default +title: Point +parent: SwiftWin32 +--- +# Point + +A structure that contains a point in a two-dimensional coordinate system. + +``` swift +public struct Point +``` + +## Inheritance + +`CustomDebugStringConvertible` + +## Initializers + +### `init(x:y:)` + +Creates a point with coordinates specified as floating-point values. + +``` swift +public init(x: Double, y: Double) +``` + +### `init(x:y:)` + +Creates a point with coordinates specified as integer values. + +``` swift +public init(x: Int, y: Int) +``` + +### `init()` + +Creates a point with location (0,0). + +``` swift +public init() +``` + +## Properties + +### `zero` + +The point with location (0,0). + +``` swift +public static var zero: Point +``` + +### `x` + +The x-coordinate of the point. + +``` swift +public var x: Double +``` + +### `y` + +The y-coordinate of the point. + +``` swift +public var y: Double +``` + +### `debugDescription` + +``` swift +public var debugDescription: String +``` + +## Methods + +### `applying(_:)` + +Returns the point resulting from an affine transformation of an existing +point. + +``` swift +public func applying(_ transform: AffineTransform) -> Point +``` diff --git a/SwiftWin32/PointerEffect.md b/SwiftWin32/PointerEffect.md new file mode 100644 index 00000000..807bb6b3 --- /dev/null +++ b/SwiftWin32/PointerEffect.md @@ -0,0 +1,63 @@ +--- +layout: default +title: PointerEffect +parent: SwiftWin32 +--- +# PointerEffect + +An effect that alters a view's appearance when a pointer enters the current +region. + +``` swift +public enum PointerEffect +``` + +## Enumeration Cases + +### `automatic` + +A pointer content effect with the given preview's view. + +``` swift +case automatic(TargetedPreview) +``` + +### `highlight` + +An effect where the pointer slides under the given view and morphs into +the view's shape. + +``` swift +case highlight(TargetedPreview) +``` + +### `hover` + +An effect where visual changes are applied to the view and the pointer +retains its default shape. + +``` swift +case hover(TargetedPreview, + preferredTintMode: PointerEffect.TintMode = .overlay, + prefersShadow: Bool = false, + prefersScaledContent: Bool = true) +``` + +### `lift` + +An effect where the pointer slides under the given view and disappears as +the view scales up and gains a shadow. + +``` swift +case lift(TargetedPreview) +``` + +## Properties + +### `preview` + +A preview of the view used during an interaction's animations. + +``` swift +public var preview: TargetedPreview +``` diff --git a/SwiftWin32/PointerEffect_TintMode.md b/SwiftWin32/PointerEffect_TintMode.md new file mode 100644 index 00000000..c3b133c6 --- /dev/null +++ b/SwiftWin32/PointerEffect_TintMode.md @@ -0,0 +1,43 @@ +--- +layout: default +title: PointerEffect.TintMode +parent: SwiftWin32 +--- +# PointerEffect.TintMode + +An effect that defines how to apply a tint to a view during a pointer +interaction. + +``` swift +public enum TintMode: Hashable +``` + +## Inheritance + +`Hashable` + +## Enumeration Cases + +### `none` + +The view has no tint applied. + +``` swift +case none +``` + +### `overlay` + +The view has a tint overlay. + +``` swift +case overlay +``` + +### `underlay` + +The view has a tint underlay. + +``` swift +case underlay +``` diff --git a/SwiftWin32/PointerInteraction.md b/SwiftWin32/PointerInteraction.md new file mode 100644 index 00000000..4422003e --- /dev/null +++ b/SwiftWin32/PointerInteraction.md @@ -0,0 +1,73 @@ +--- +layout: default +title: PointerInteraction +parent: SwiftWin32 +--- +# PointerInteraction + +An interaction that enables support for effects on a view or customizes the +pointer's appearance within a region of an app. + +``` swift +public class PointerInteraction +``` + +## Inheritance + +[`Interaction`](https://compnerd.github.io/swift-win32/SwiftWin32/Interaction) + +## Initializers + +### `init(delegate:)` + +Initializes a pointer interaction object with a specified delegate object. + +``` swift +public init(delegate: PointerInteractionDelegate?) +``` + +## Properties + +### `delegate` + +An object that responds to pointer movements. + +``` swift +public private(set) weak var delegate: PointerInteractionDelegate? +``` + +### `isEnabled` + +A boolean value that indicates whether the pointer interaction is enabled. + +``` swift +public var isEnabled: Bool = true +``` + +### `view` + +``` swift +public private(set) weak var view: View? +``` + +## Methods + +### `invalidate()` + +Causes the interaction to update the pointer in response to an event. + +``` swift +public func invalidate() +``` + +### `didMove(to:)` + +``` swift +public func didMove(to view: View?) +``` + +### `willMove(to:)` + +``` swift +public func willMove(to view: View?) +``` diff --git a/SwiftWin32/PointerInteractionAnimating.md b/SwiftWin32/PointerInteractionAnimating.md new file mode 100644 index 00000000..c4f37415 --- /dev/null +++ b/SwiftWin32/PointerInteractionAnimating.md @@ -0,0 +1,31 @@ +--- +layout: default +title: PointerInteractionAnimating +parent: SwiftWin32 +--- +# PointerInteractionAnimating + +An interface for modifying an interaction animation in coordination with the +pointer effect animations. + +``` swift +public protocol PointerInteractionAnimating +``` + +## Requirements + +### addAnimations(\_:​) + +Adds the specified animation block to the animator. + +``` swift +func addAnimations(_ animations: @escaping () -> Void) +``` + +### addCompletion(\_:​) + +Adds the specified completion block to the animator. + +``` swift +func addCompletion(_ completion: @escaping (Bool) -> Void) +``` diff --git a/SwiftWin32/PointerInteractionDelegate.md b/SwiftWin32/PointerInteractionDelegate.md new file mode 100644 index 00000000..02596c38 --- /dev/null +++ b/SwiftWin32/PointerInteractionDelegate.md @@ -0,0 +1,94 @@ +--- +layout: default +title: PointerInteractionDelegate +parent: SwiftWin32 +--- +# PointerInteractionDelegate + +An interface for handling pointer movements within the interaction's view. + +``` swift +public protocol PointerInteractionDelegate: AnyObject +``` + +## Inheritance + +`AnyObject` + +## Default Implementations + +### `pointerInteraction(_:regionFor:defaultRegion:)` + +``` swift +public func pointerInteraction(_ interaction: PointerInteraction, + regionFor request: PointerRegionRequest, + defaultRegion: PointerRegion) + -> PointerRegion? +``` + +### `pointerInteraction(_:styleFor:)` + +``` swift +public func pointerInteraction(_ interaction: PointerInteraction, + styleFor region: PointerRegion) + -> PointerStyle? +``` + +### `pointerInteraction(_:willEnter:animator:)` + +``` swift +public func pointerInteraction(_ interaction: PointerInteraction, + willEnter region: PointerRegion, + animator: PointerInteractionAnimating) +``` + +### `pointerInteraction(_:willExit:animator:)` + +``` swift +public func pointerInteraction(_ interaction: PointerInteraction, + willExit region: PointerRegion, + animator: PointerInteractionAnimating) +``` + +## Requirements + +### pointerInteraction(\_:​regionFor:​defaultRegion:​) + +Asks the delegate for a region as the pointer moves within the +interaction's view. + +``` swift +func pointerInteraction(_ interaction: PointerInteraction, + regionFor request: PointerRegionRequest, + defaultRegion: PointerRegion) -> PointerRegion? +``` + +### pointerInteraction(\_:​styleFor:​) + +Asks the delegate for a pointer style after an interaction receives a new +region. + +``` swift +func pointerInteraction(_ interaction: PointerInteraction, + styleFor region: PointerRegion) -> PointerStyle? +``` + +### pointerInteraction(\_:​willEnter:​animator:​) + +Informs the delegate when the pointer enters a given region. + +``` swift +func pointerInteraction(_ interaction: PointerInteraction, + willEnter region: PointerRegion, + animator: PointerInteractionAnimating) +``` + +### pointerInteraction(\_:​willExit:​animator:​) + +Informs the delegate when the pointer exits a given region. + +``` swift +func pointerInteraction(_ interaction: PointerInteraction, + willExit region: PointerRegion, + animator: PointerInteractionAnimating) +``` diff --git a/SwiftWin32/PointerRegion.md b/SwiftWin32/PointerRegion.md new file mode 100644 index 00000000..d5459a5c --- /dev/null +++ b/SwiftWin32/PointerRegion.md @@ -0,0 +1,34 @@ +--- +layout: default +title: PointerRegion +parent: SwiftWin32 +--- +# PointerRegion + +``` swift +public class PointerRegion +``` + +## Initializers + +### `init(rect:identifier:)` + +``` swift +public /*convenience*/ init(rect: Rect, identifier: AnyHashable? = nil) +``` + +## Properties + +### `rect` + +The rectangle bounds of the region. + +``` swift +public private(set) var rect: Rect +``` + +### `identifier` + +``` swift +public private(set) var identifier: AnyHashable? +``` diff --git a/SwiftWin32/PointerRegionRequest.md b/SwiftWin32/PointerRegionRequest.md new file mode 100644 index 00000000..722de89c --- /dev/null +++ b/SwiftWin32/PointerRegionRequest.md @@ -0,0 +1,31 @@ +--- +layout: default +title: PointerRegionRequest +parent: SwiftWin32 +--- +# PointerRegionRequest + +An object to describe the pointer's location in the interaction's view. + +``` swift +public class PointerRegionRequest +``` + +## Properties + +### `location` + +The location of the pointer in the interaction's view's coordinate space. + +``` swift +public private(set) var location: Point +``` + +### `modifiers` + +Key modifier flags representing keyboard keys pressed by the user at the +time of this request. + +``` swift +public private(set) var modifiers: KeyModifierFlags +``` diff --git a/SwiftWin32/PointerShape.md b/SwiftWin32/PointerShape.md new file mode 100644 index 00000000..70fcc931 --- /dev/null +++ b/SwiftWin32/PointerShape.md @@ -0,0 +1,57 @@ +--- +layout: default +title: PointerShape +parent: SwiftWin32 +--- +# PointerShape + +An object that defines the shape of custom pointers. + +``` swift +public enum PointerShape +``` + +## Enumeration Cases + +### `horizontalBeam` + +The pointer morphs into a horizontal beam using the specified length. + +``` swift +case horizontalBeam(length: Double) +``` + +### `verticalBeam` + +The pointer morphs into a vertical beam using the specified length. + +``` swift +case verticalBeam(length: Double) +``` + +### `path` + +The pointer morphs into the given Bézier path. + +``` swift +case path(BezierPath) +``` + +### `roundedRect` + +The pointer morphs into a rounded rectangle using the provided corner +radius. + +``` swift +case roundedRect(Rect, radius: Double = PointerShape.defaultCornerRadius) +``` + +## Properties + +### `defaultCornerRadius` + +The default corner radius for a pointer using a rounded rectangle. + +``` swift +public static var defaultCornerRadius: Double +``` diff --git a/SwiftWin32/PointerStyle.md b/SwiftWin32/PointerStyle.md new file mode 100644 index 00000000..7338b53d --- /dev/null +++ b/SwiftWin32/PointerStyle.md @@ -0,0 +1,42 @@ +--- +layout: default +title: PointerStyle +parent: SwiftWin32 +--- +# PointerStyle + +An object that defines the pointer shape and effect. + +``` swift +public class PointerStyle +``` + +## Initializers + +### `init(effect:shape:)` + +Applies the provided content effect and pointer shape to the current +region. + +``` swift +public convenience init(effect: PointerEffect, shape: PointerShape? = nil) +``` + +### `init(shape:constrainedAxes:)` + +Morphs the pointer into the provided shape when hovering over the current +region. + +``` swift +public convenience init(shape: PointerShape, constrainedAxes: Axis = []) +``` + +## Methods + +### `hidden()` + +Hides the pointer when it moves over the current region. + +``` swift +public class func hidden() -> Self +``` diff --git a/SwiftWin32/PresentationController.md b/SwiftWin32/PresentationController.md new file mode 100644 index 00000000..c51e8717 --- /dev/null +++ b/SwiftWin32/PresentationController.md @@ -0,0 +1,368 @@ +--- +layout: default +title: PresentationController +parent: SwiftWin32 +--- +# PresentationController + +An object that manages the transition animations and the presentation of +view controllers onscreen. + +``` swift +open class PresentationController +``` + +## Initializers + +### `init(presentedViewController:presenting:)` + +Initializes and returns a presentation controller for transitioning +between the specified view controllers + +``` swift +public init(presentedViewController: ViewController, + presenting presentingViewController: ViewController?) +``` + +This method is the designated initializer for the presentation controller. +You must call it from any custom initialization methods you define for +your presentation controller subclasses. + +## Properties + +### `delegate` + +The delegate object for managing adaptive presentations. + +``` swift +open weak var delegate: AdaptivePresentationControllerDelegate? +``` + +When the application's size changes, the presentation controller works +with this delegate object to determine an appropriate response. View +controllers presented using the `ModalPresentationStyle.formSheet`, +`ModalPresentationStyle.popover`, or `ModalPresentationStyle.custom` style +must change to use one of the full-screen presentation styles instead. The +delegate can also opt to change the presented view controller entirely. + +The object you assign to this property must conform to the +`AdaptivePresentationControllerDelegate` protocol. + +### `presentingViewController` + +The view controller that is the starting point for the presentation. + +``` swift +open private(set) var presentingViewController: ViewController +``` + +The object in this property could be the root view controller of the +window, a parent view controller that is marked as defining the current +context, or the last view controller that was presented onscreen. This +view controller may or may not be the same one whose +`present(_:animated:completion:)` method was called to initiate the +presentation process. It may also not be the view controller used to +initialize your presentation controller. + +### `presentedViewController` + +The view controller being presented. + +``` swift +open private(set) var presentedViewController: ViewController +``` + +This object corresponds to the one passed as the first parameter of the +`present(_:animated:completion:)` method. The successful conclusion of the +presentation process causes this view controller's content to be displayed +onscreen. + +### `containerView` + +The view in which the presentation occurs. + +``` swift +open private(set) var containerView: View? +``` + +The framework sets the value of this property shortly after receiving the +presentation controller from your transitioning delegate. The container +view is always an ancestor of the presented view controller's view. During +transition animations, the container view also contains the presenting +view controller's view. When adding custom views to a presentation, add +them to the container view. + +If your transition also employs custom animator objects, those objects can +get this container view from the `containerView` property of the context +object provided by the framework. + +### `presentedView` + +The view to be animated by the animator objects during a transition. + +``` swift +open private(set) var presentedView: View? +``` + +The default implementation of this method returns the presented view +controller's view. If you want to animate a different view, you may +override this method and return that view. The view you specify must +either be the presented view controller's view or must be one of its +ancestors. + +The view returned by this method is given to the animator objects, which +are responsible for animating it onscreen. The animator objects retrieve +the view using the `view(forKey:)` method of the context object provided +by the framework. + +The framework calls this method multiple times during the course of a +presentation, so your implementation should return the appropriate view as +quickly as possible. Do not use this method to actually configure your +view hierarchy. If you intend to return a custom view, configure your view +hierarchy in the `presentationTransitionWillBegin()` method. + +### `frameOfPresentedViewInContainerView` + +The frame rectangle to assign to the presented view at the end of the +animations. + +``` swift +open var frameOfPresentedViewInContainerView: Rect +``` + +The default implementation of this method returns the frame rectangle of +the container view, which results in the presented view controller's +content occupying the entire presentation space. You can override this +method and return a different frame rectangle as needed. For example, you +might specify a smaller frame rectangle if you want some of the underlying +content to show around the edges of the presented view. + +The framework calls this method multiple times during the course of a +presentation, so your implementation should return the same frame +rectangle each time. Do not use this method to make changes to your view +hierarchy or perform other one-time tasks. + +### `overrideTraitCollection` + +Interface traits for the presented view controller, to use in place of +traits from the current device environment. + +``` swift +open var overrideTraitCollection: TraitCollection? +``` + +Use this property to provide an interface trait collection for the +presented view controller, overriding one or more values in the current +device trait environment. + +Each value you place in the `overrideTraitCollection` property overrides +the corresponding value in the current device trait environment. For +example, the following code snippet shows how to override the display +scale for the presented view controller, leaving other traits as they are +provided by the system. Place such code, typically, in the implementation +file for the presenting view controller: + +``` swift +viewController.presentationController.overrideTraitCollection = TraitCollection(traitsFrom: [.current, .init(displayScale: 1.5)]) +self.present(viewController, animated: false, completion: nil) +``` + +The presenting view controller is not affected by use of this property. + +The default value of the `overrideTraitCollection` property is `nil`, +which results in the full current device trait environment being used by +the presented view controller. + +### `presentationStyle` + +The presentation style of the presented view controller. + +``` swift +open private(set) var presentationStyle: ModalPresentationStyle +``` + +This property is set to the presentation style of the presented view +controller. The presentation controller uses this style to determine the +initial appearance of the presented content. + +### `adaptivePresentationStyle` + +Returns the presentation style to use when the presented view controller +becomes horizontally compact. + +``` swift +@available(*, unavailable) + open var adaptivePresentationStyle: ModalPresentationStyle = .none +``` + +After the content managed by the presentation controller is onscreen, this +method returns the presentation style to use when transitioning to a +horizontally compact environment. This method is not meant to be +overridden. The implementation consults its delegate object and returns +the value provided by that object's `adaptivePresentationStyle(for:)` +method. Some system-supplied presentation controllers may also provide a +new style that is more suited for a compact environment. For example, +presentation controllers that manage popovers and form sheets return the +`ModalPresentationStyle.fullScreen` value. + +This method only returns the presentation style to use in a horizontally +compact environment. It does not initiate a transition to the new style. +The system initiates the transition to the new style when the size class +actually changes. When transitioning to a new style, the actual +presentation controller object may change. As a result, do not cache the +presentation controller object in your code. Always retrieve it from your +view controller's presentationController property. + +Use `adaptivePresentationStyle(for:)` instead. + +### `shouldPresentInFullscreen` + +A boolean value indicating whether the presentation covers the entire +screen. + +``` swift +open private(set) var shouldPresentInFullscreen: Bool = true +``` + +The default implementation of this method returns `true`, indicating that +the presentation covers the entire screen. You can override this method +and return `false` to force the presentation to display only in the +current context. + +If you override this method, do not call `super`. + +### `shouldRemovePresentersView` + +A boolean value indicating whether the presenting view controller's view +should be removed when the presentation animations finish. + +``` swift +open private(set) var shouldRemovePresentersView: Bool = false +``` + +The default implementation of this method returns `false`. If you +implement a presentation that does not cover the presenting view +controller's content entirely, override this method and return `false`. + +If you override this method, do not call `super`. + +## Methods + +### `containerViewWillLayoutSubviews()` + +Notifies the presentation controller that layout is about to begin on the +views of the container view. + +``` swift +open func containerViewWillLayoutSubviews() +``` + +The framework calls this method before adjusting the layout of the views +in the container view. Use this method and the +`containerViewDidLayoutSubviews()` method to update any custom views +managed by your presentation controller. + +### `containerViewDidLayoutSubviews()` + +Called to notify the presentation controller that layout ended on the +views of the container view. + +``` swift +open func containerViewDidLayoutSubviews() +``` + +The framework calls this method after adjusting the layout of the views in +the container view. Use this method to make any additional changes to the +view hierarchy. + +### `presentationTransitionWillBegin()` + +Notifies the presentation controller that the presentation animations are +about to start. + +``` swift +open func presentationTransitionWillBegin() +``` + +The default implementation of this method does nothing. Subclasses can +override it and use it to add custom views to the view hierarchy and to +create any animations associated with those views. To perform your +animations, get the transition coordinator of the presented view +controller and call its `animate(alongsideTransition:completion:)` or +`animateAlongsideTransition(in:animation:completion:)` method. Calling +those methods ensures that your animations are executed at the same time +as any other transition animations. + +### `presentationTransitionDidEnd(_:)` + +Notifies the presentation controller that the presentation animations +finished. + +``` swift +open func presentationTransitionDidEnd(_ completed: Bool) +``` + +The default implementation of this method does nothing. Subclasses can +override this method and use it to perform any required cleanup. For +example, if the `completed` parameter is `false`, you would use this +method to remove your presentation's custom views from the view hierarchy. + +### `dismissalTransitionWillBegin()` + +Notifies the presentation controller that the dismissal animations are +about to start. + +``` swift +open func dismissalTransitionWillBegin() +``` + +The default implementation of this method does nothing. Subclasses can +override this method and use it to configure any animations associated +with your presentation's custom views. To perform your animations, get +the transition coordinator of the presented view controller and call +its `animate(alongsideTransition:completion:)` or +`animateAlongsideTransition(in:animation:completion:)` method. Calling +those methods ensures that your animations are executed at the same time +as any other transition animations. + +Do not use this method to remove your views from the view hierarchy. +Remove your views in the `dismissalTransitionDidEnd(_:)` method instead. + +### `dismissalTransitionDidEnd(_:)` + +Notifies the presentation controller that the dismissal animations +finished. + +``` swift +open func dismissalTransitionDidEnd(_ completed: Bool) +``` + +The default implementation of this method does nothing. Subclasses can +override this method and use it to remove any custom views that the +presentation controller added to the view hierarchy. Remove your views +only if the `completed` parameter is `true`. + +### `adaptivePresentationStyle(for:)` + +Returns the presentation style to use for the specified set of traits. + +``` swift +open func adaptivePresentationStyle(for traitCollection: TraitCollection) + -> ModalPresentationStyle +``` + +After the content managed by the presentation controller is onscreen, this +method returns the presentation style to use for the specified set of +traits. The default implementation of this method consults its delegate +object and returns the value returned by that object’s +`adaptivePresentationStyle(for:traitCollection:)` method. Some +system-supplied presentation controllers may also provide a new style that +is more suited to the new set of traits. + +This method returns the presentation style for the new traits, but does +not initiate a transition to the new style. The system initiates the +transition to the new style when the traits actually change. When +transitioning to new traits, the actual presentation controller object may +change. As a result, do not cache the presentation controller object in +your code. Always retrieve it from your view controller's +`presentationController` property. diff --git a/SwiftWin32/Press.md b/SwiftWin32/Press.md new file mode 100644 index 00000000..ceb7cdb3 --- /dev/null +++ b/SwiftWin32/Press.md @@ -0,0 +1,104 @@ +--- +layout: default +title: Press +parent: SwiftWin32 +--- +# Press + +An object that represents the presence or movement of a button press on the +screen for a particular event. + +``` swift +open class Press +``` + +## Inheritance + +`Equatable`, `Hashable` + +## Properties + +### `force` + +The force of the button press. + +``` swift +open private(set) var force: Double +``` + +### `gestureRecognizers` + +The gesture recognizers that are receiving the press. + +``` swift +open private(set) var gestureRecognizers: [GestureRecognizer]? +``` + +### `responder` + +A `Responder` object. + +``` swift +open private(set) var responder: Responder? +``` + +### `window` + +The window in which the press initially occurred. + +``` swift +open private(set) var window: Window? +``` + +### `key` + +
+
false
+
+ +``` swift +open private(set) var key: Key? +``` + +
+
+ +### `type` + +The type of the specified press. + +``` swift +open private(set) var type: Press.PressType +``` + +### `phase` + +The current press phase of the object. + +``` swift +open private(set) var phase: Press.Phase +``` + +### `timestamp` + +The time when the press occurred or when it was last mutated. + +``` swift +open private(set) var timestamp: TimeInterval +``` + +## Methods + +### `hash(into:)` + +``` swift +public func hash(into hasher: inout Hasher) +``` + +## Operators + +### `==` + +``` swift +public static func ==(_ lhs: Press, _ rhs: Press) -> Bool +``` diff --git a/SwiftWin32/Press_Phase.md b/SwiftWin32/Press_Phase.md new file mode 100644 index 00000000..7ecf0948 --- /dev/null +++ b/SwiftWin32/Press_Phase.md @@ -0,0 +1,58 @@ +--- +layout: default +title: Press.Phase +parent: SwiftWin32 +--- +# Press.Phase + +The phases of a button press. + +``` swift +public enum Phase: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `began` + +A physical button was pressed. + +``` swift +case began +``` + +### `changed` + +A button moved, or the `force` property changed. + +``` swift +case changed +``` + +### `stationary` + +A button was pressed but hasn’t moved since the previous event. + +``` swift +case stationary +``` + +### `ended` + +A button was released. + +``` swift +case ended +``` + +### `cancelled` + +The system canceled tracking for the button. + +``` swift +case cancelled +``` diff --git a/SwiftWin32/Press_PressType.md b/SwiftWin32/Press_PressType.md new file mode 100644 index 00000000..cac8f5b2 --- /dev/null +++ b/SwiftWin32/Press_PressType.md @@ -0,0 +1,90 @@ +--- +layout: default +title: Press.PressType +parent: SwiftWin32 +--- +# Press.PressType + +Constants that represent buttons that a user can press. + +``` swift +public enum PressType: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `upArrow` + +A constant that represents the up arrow button. + +``` swift +case upArrow = 0 +``` + +### `downArrow` + +A constant that represents the down arrow button. + +``` swift +case downArrow = 1 +``` + +### `leftArrow` + +A constant that represents the left arrow button. + +``` swift +case leftArrow = 2 +``` + +### `rightArrow` + +A constant that represents the right arrow button. + +``` swift +case rightArrow = 3 +``` + +### `pageDown` + +A constant that represents the page down button. + +``` swift +case pageDown = 30 +``` + +### `pageUp` + +A constant that represents the page up button. + +``` swift +case pageUp = 31 +``` + +### `playPause` + +A constant that represents the play/pause button. + +``` swift +case playPause = 4 +``` + +### `select` + +A constant that represents the select button. + +``` swift +case select = 5 +``` + +### `menu` + +A constant that represents the menu button. + +``` swift +case menu = 6 +``` diff --git a/SwiftWin32/PressesEvent.md b/SwiftWin32/PressesEvent.md new file mode 100644 index 00000000..866b24ae --- /dev/null +++ b/SwiftWin32/PressesEvent.md @@ -0,0 +1,39 @@ +--- +layout: default +title: PressesEvent +parent: SwiftWin32 +--- +# PressesEvent + +An event that describes the state of a set of physical buttons that are +available to the device, such as those on an associated remote or game +controller. + +``` swift +open class PressesEvent: Event +``` + +## Inheritance + +[`Event`](https://compnerd.github.io/swift-win32/SwiftWin32/Event) + +## Properties + +### `allPresses` + +Returns the state of all physical buttons in the event. + +``` swift +open private(set) var allPresses: Set +``` + +## Methods + +### `presses(for:)` + +Returns the state of all physical buttons in the event that are associated +with a particular gesture recognizer. + +``` swift +open func presses(for guesture: GestureRecognizer) -> Set +``` diff --git a/SwiftWin32/PreviewParameters.md b/SwiftWin32/PreviewParameters.md new file mode 100644 index 00000000..23c65ce8 --- /dev/null +++ b/SwiftWin32/PreviewParameters.md @@ -0,0 +1,57 @@ +--- +layout: default +title: PreviewParameters +parent: SwiftWin32 +--- +# PreviewParameters + +Additional parameters to use when animating a preview interface. + +``` swift +public class PreviewParameters +``` + +## Initializers + +### `init()` + +Creating Preview Parameters +Creates a default set of preview parameters. + +``` swift +public init() +``` + +### `init(textLineRects:)` + +Creates a preview paramters object with information about the text you +want to preview. + +``` swift +public init(textLineRects: [NSValue]) +``` + +## Properties + +### `backgroundColor` + +Configuring the Preview Attributes +The background color to display behind the preview. + +``` swift +public var backgroundColor: Color! +``` + +### `visiblePath` + +The portion of the view to show in the preview. + +``` swift +public var visiblePath: BezierPath? +``` + +### `shadowPath` + +``` swift +public var shadowPath: BezierPath? +``` diff --git a/SwiftWin32/PreviewTarget.md b/SwiftWin32/PreviewTarget.md new file mode 100644 index 00000000..8ff3e496 --- /dev/null +++ b/SwiftWin32/PreviewTarget.md @@ -0,0 +1,61 @@ +--- +layout: default +title: PreviewTarget +parent: SwiftWin32 +--- +# PreviewTarget + +An object that specifies the container view to use for animations. + +``` swift +public class PreviewTarget +``` + +## Initializers + +### `init(container:center:transform:)` + +Creating a Preview Target Object +Creates a preview target object using the specified container view and +configuration details. + +``` swift +public init(container: View, center: Point, transform: AffineTransform) +``` + +### `init(container:center:)` + +Creates a preview target object using the specified container view and +center point. + +``` swift +public convenience init(container: View, center: Point) +``` + +## Properties + +### `container` + +Getting the Target Attributes +The container for the view being animated. + +``` swift +public let container: View +``` + +### `center` + +The point in the containing view at which to place the center of the view +being animated. + +``` swift +public let center: Point +``` + +### `transform` + +An affine transform to apply to the view being animated. + +``` swift +public let transform: AffineTransform +``` diff --git a/SwiftWin32/ProgressView.md b/SwiftWin32/ProgressView.md new file mode 100644 index 00000000..2ac5a182 --- /dev/null +++ b/SwiftWin32/ProgressView.md @@ -0,0 +1,30 @@ +--- +layout: default +title: ProgressView +parent: SwiftWin32 +--- +# ProgressView + +``` swift +public class ProgressView: Control +``` + +## Inheritance + +[`Control`](https://compnerd.github.io/swift-win32/SwiftWin32/Control) + +## Initializers + +### `init(frame:)` + +``` swift +public init(frame: Rect) +``` + +## Methods + +### `setProgress(_:animated:)` + +``` swift +public func setProgress(_ progress: Float, animated: Bool) +``` diff --git a/SwiftWin32/Rect.md b/SwiftWin32/Rect.md new file mode 100644 index 00000000..f52bba4c --- /dev/null +++ b/SwiftWin32/Rect.md @@ -0,0 +1,282 @@ +--- +layout: default +title: Rect +parent: SwiftWin32 +--- +# Rect + +A structure that contains the location and dimensions of a rectangle. + +``` swift +public struct Rect +``` + +## Inheritance + +`CustomDebugStringConvertible`, `Equatable` + +## Initializers + +### `init(origin:size:)` + +Creates a rectangle with the specified origin and size. + +``` swift +public init(origin: Point, size: Size) +``` + +### `init(x:y:width:height:)` + +Creates a rectangle with coordinates and dimensions specified as +floating-point values. + +``` swift +public init(x: Double, y: Double, width: Double, height: Double) +``` + +### `init(x:y:width:height:)` + +Creates a rectangle with coordinates and dimensions specified as integer +values. + +``` swift +public init(x: Int, y: Int, width: Int, height: Int) +``` + +### `init()` + +Creates a rectangle with origin (0,0) and size (0,0). + +``` swift +public init() +``` + +## Properties + +### `infinite` + +A rectangle that has infinite extent. + +``` swift +public static var infinite: Rect +``` + +### `null` + +The null rectangle, representing an invalid value. + +``` swift +public static var null: Rect +``` + +### `zero` + +The rectangle whose origin and size are both zero. + +``` swift +public static var zero: Rect +``` + +### `origin` + +A point that specifies the coordinates of the rectangle’s origin. + +``` swift +public var origin: Point +``` + +### `size` + +A size that specifies the height and width of the rectangle. + +``` swift +public var size: Size +``` + +### `height` + +Returns the height of a rectangle. + +``` swift +public var height: Double +``` + +### `width` + +Returns the width of a rectangle. + +``` swift +public var width: Double +``` + +### `minX` + +Returns the smallest value for the x-coordinate of the rectangle. + +``` swift +public var minX: Double +``` + +### `midX` + +Returns the x-coordinate that establishes the center of a rectangle. + +``` swift +public var midX: Double +``` + +### `maxX` + +Returns the largest value of the x-coordinate for the rectangle. + +``` swift +public var maxX: Double +``` + +### `minY` + +Returns the smallest value for the y-coordinate of the rectangle. + +``` swift +public var minY: Double +``` + +### `midY` + +Returns the y-coordinate that establishes the center of the rectangle. + +``` swift +public var midY: Double +``` + +### `maxY` + +Returns the largest value for the y-coordinate of the rectangle. + +``` swift +public var maxY: Double +``` + +### `standardized` + +Returns a rectangle with a positive width and height. + +``` swift +public var standardized: Rect +``` + +### `integral` + +Returns the smallest rectangle that results from converting the source +rectangle values to integers. + +``` swift +public var integral: Rect +``` + +### `isEmpty` + +Returns whether a rectangle has zero width or height, or is a null +rectangle. + +``` swift +public var isEmpty: Bool +``` + +### `isInfinite` + +Returns whether a rectangle is infinite. + +``` swift +public var isInfinite: Bool +``` + +### `isNull` + +Returns whether the rectangle is equal to the null rectangle. + +``` swift +public var isNull: Bool +``` + +### `debugDescription` + +``` swift +public var debugDescription: String +``` + +## Methods + +### `applying(_:)` + +Applies an affine transform to a rectangle. + +``` swift +public func applying(_ transform: AffineTransform) -> Rect +``` + +### `insetBy(dx:dy:)` + +Returns a rectangle that is smaller or larger than the source rectangle, +with the same center point. + +``` swift +public func insetBy(dx: Double, dy: Double) -> Rect +``` + +### `offsetBy(dx:dy:)` + +Returns a rectangle with an origin that is offset from that of the source +rectangle. + +``` swift +public func offsetBy(dx: Double, dy: Double) -> Rect +``` + +### `union(_:)` + +Returns the smallest rectangle that contains the two source rectangles. + +``` swift +public func union(_ rect: Rect) -> Rect +``` + +### `intersection(_:)` + +Returns the intersection of two rectangles. + +``` swift +public func intersection(_ rect: Rect) -> Rect +``` + +### `intersects(_:)` + +Returns whether two rectangles intersect. + +``` swift +public func intersects(_ rect: Rect) -> Bool +``` + +### `contains(_:)` + +Returns whether a rectangle contains a specified point. + +``` swift +public func contains(_ point: Point) -> Bool +``` + +### `contains(_:)` + +Returns whether the first rectangle contains the second rectangle. + +``` swift +public func contains(_ rect2: Rect) -> Bool +``` + +## Operators + +### `==` + +``` swift +public static func == (lhs: Rect, rhs: Rect) -> Bool +``` diff --git a/SwiftWin32/RectEdge.md b/SwiftWin32/RectEdge.md new file mode 100644 index 00000000..cc9d50f5 --- /dev/null +++ b/SwiftWin32/RectEdge.md @@ -0,0 +1,80 @@ +--- +layout: default +title: RectEdge +parent: SwiftWin32 +--- +# RectEdge + +Constants that specify the edges of a rectangle. + +``` swift +public struct RectEdge: OptionSet +``` + +## Inheritance + +`OptionSet` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = UInt +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `top` + +The top edge of the rectangle. + +``` swift +public static var top: RectEdge +``` + +### `left` + +The left edge of the rectangle. + +``` swift +public static var left: RectEdge +``` + +### `bottom` + +The bottom edge of the rectangle. + +``` swift +public static var bottom: RectEdge +``` + +### `right` + +The right edge of the rectangle. + +``` swift +public static var right: RectEdge +``` + +### `all` + +All edges of the rectangle. + +``` swift +public static var all: RectEdge +``` diff --git a/SwiftWin32/Rect_Edge.md b/SwiftWin32/Rect_Edge.md new file mode 100644 index 00000000..ed29887b --- /dev/null +++ b/SwiftWin32/Rect_Edge.md @@ -0,0 +1,55 @@ +--- +layout: default +title: Rect.Edge +parent: SwiftWin32 +--- +# Rect.Edge + +Coordinates that establish the edges of a rectangle. + +``` swift +@frozen + public enum Edge: UInt32 +``` + +## Inheritance + +`UInt32` + +## Enumeration Cases + +### `minXEdge` + +The minimum value for the x-coordinate of the rectangle. In the default +coordinate space, this is the left edge of the rectangle. + +``` swift +case minXEdge +``` + +### `minYEdge` + +The minimum value for the y-coordinate of the rectangle. In the default +coordinate space, this is the top edge of the rectangle. + +``` swift +case minYEdge +``` + +### `maxXEdge` + +The maximum value for the x-coordinate of the rectangle. In the default +coordinate space, this is the right edge of the rectangle. + +``` swift +case maxXEdge +``` + +### `maxYEdge` + +The maximum value for the y-coordinate of the rectangle. In the default +coordinate space, this is the bottom edge of the rectangle. + +``` swift +case maxYEdge +``` diff --git a/SwiftWin32/Responder.md b/SwiftWin32/Responder.md new file mode 100644 index 00000000..3c51b160 --- /dev/null +++ b/SwiftWin32/Responder.md @@ -0,0 +1,347 @@ +--- +layout: default +title: Responder +parent: SwiftWin32 +--- +# Responder + +``` swift +open class Responder +``` + +## Properties + +### `next` + +Returns the next responder in the responder chain, or `nil` if there is no +next responder. + +``` swift +open var next: Responder? +``` + +### `isFirstResponder` + +Indicates whether this object is the first responder. + +``` swift +open var isFirstResponder: Bool +``` + +### `canBecomeFirstResponder` + +Indiciates whether ths object can become the first responder. + +``` swift +open var canBecomeFirstResponder: Bool +``` + +### `canResignFirstResponder` + +Indicates whether this object is willing to relinquish first-responder +status. + +``` swift +open var canResignFirstResponder: Bool +``` + +### `inputView` + +The custom input view to display when the receiver becomes the first +responder. + +``` swift +open private(set) var inputView: View? +``` + +### `inputViewController` + +The custom input view controller to use when the receiver becomes the +first responder. + +``` swift +open private(set) var inputViewController: InputViewController? +``` + +### `inputAccessoryView` + +The custom input accessory view to display when the receiver becomes the +first responder. + +``` swift +open private(set) var inputAccessoryView: View? +``` + +### `inputAccessoryViewController` + +The custom input accessory view controller to display when the receiver +becomes the first responder. + +``` swift +open private(set) var inputAccessoryViewController: InputViewController? +``` + +### `keyboardAnimationCurveUserInfoKey` + +A user info key to retrieve the animation curve that the system uses to +animate the keyboard onto or off the screen. + +``` swift +public class var keyboardAnimationCurveUserInfoKey: String +``` + +### `keyboardAnimationDurationUserInfoKey` + +A user info key to retrieve the duration of the keyboard animation in +seconds. + +``` swift +public class var keyboardAnimationDurationUserInfoKey: String +``` + +### `keyboardFrameBeginUserInfoKey` + +A user info key to retrieve the keyboard’s frame at the beginning of its +animation. + +``` swift +public class var keyboardFrameBeginUserInfoKey: String +``` + +### `keyboardFrameEndUserInfoKey` + +A user info key to retrieve the keyboard’s frame at the end of its +animation. + +``` swift +public class var keyboardFrameEndUserInfoKey: String +``` + +### `keyboardIsLocalUserInfoKey` + +A user info key to retrieve a boolean value that indicates whether the +keyboard belongs to the current app. + +``` swift +public class var keyboardIsLocalUserInfoKey: String +``` + +### `keyboardDidChangeFrameNotification` + +Posted immediately after a change in the keyboard’s frame. + +``` swift +public class var keyboardDidChangeFrameNotification: NSNotification.Name +``` + +### `keyboardDidHideNotification` + +Posted immediately after the dismissal of the keyboard. + +``` swift +public class var keyboardDidHideNotification: NSNotification.Name +``` + +### `keyboardDidShowNotification` + +Posted immediately after the display of the keyboard. + +``` swift +public class var keyboardDidShowNotification: NSNotification.Name +``` + +### `keyboardWillChangeFrameNotification` + +Posted immediately prior to a change in the keyboard’s frame. + +``` swift +public class var keyboardWillChangeFrameNotification: NSNotification.Name +``` + +### `keyboardWillHideNotification` + +Posted immediately prior to the dismissal of the keyboard. + +``` swift +public class var keyboardWillHideNotification: NSNotification.Name +``` + +### `keyboardWillShowNotification` + +Posted immediately prior to the display of the keyboard. + +``` swift +public class var keyboardWillShowNotification: NSNotification.Name +``` + +## Methods + +### `becomeFirstResponder()` + +Results to make this object the first responder in its window. + +``` swift +open func becomeFirstResponder() -> Bool +``` + +### `resignFirstResponder()` + +Notifies the object that it has been asked to relinquish its status as +first responder in its window. + +``` swift +open func resignFirstResponder() -> Bool +``` + +### `touchesBegan(_:with:)` + +Informs the responder that one or more new touches occurrd in a view or a +window. + +``` swift +open func touchesBegan(_ touches: Set, with event: Event?) +``` + +### `touchesMoved(_:with:)` + +Informs the responder when one or more touches associated with an event +changed. + +``` swift +open func touchesMoved(_ touches: Set, with event: Event?) +``` + +### `touchesEnded(_:with:)` + +Informs the responder when one or more fingers are raised from a view or a +window. + +``` swift +open func touchesEnded(_ touches: Set, with event: Event?) +``` + +### `touchesCancelled(_:with:)` + +Informs the responder when a system event (such as a system alert) cancels +a touch sequence. + +``` swift +open func touchesCancelled(_ touches: Set, with event: Event?) +``` + +### `touchesEstimatedPropertiesUpdated(_:)` + +Tells the responder that updated values were received for previously +estimated properties or that an update is no longer expected. + +``` swift +open func touchesEstimatedPropertiesUpdated(_ touches: Set) +``` + +### `motionBegan(_:with:)` + +Tells the receiver that a motion event has begun. + +``` swift +open func motionBegan(_ motion: Event.EventSubtype, with event: Event?) +``` + +### `motionEnded(_:with:)` + +Tells the receiver that a motion event has ended. + +``` swift +open func motionEnded(_ motion: Event.EventSubtype, with event: Event?) +``` + +### `motionCancelled(_:with:)` + +Tells the receiver that a motion event has been cancelled. + +``` swift +open func motionCancelled(_ motion: Event.EventSubtype, with event: Event?) +``` + +### `pressesBegan(_:with:)` + +NOTE:​ Generally, responders that handle press events should override all +four of these methods. +Tells this object when a physical button is first pressed. + +``` swift +open func pressesBegan(_ presses: Set, with event: PressesEvent?) +``` + +### `pressesChanged(_:with:)` + +Tells this object when a value associated with a press has changed. + +``` swift +open func pressesChanged(_ presses: Set, with event: PressesEvent?) +``` + +### `pressesEnded(_:with:)` + +Tells the object when a button is released. + +``` swift +open func pressesEnded(_ presses: Set, with event: PressesEvent?) +``` + +### `pressesCancelled(_:with:)` + +Tells this object when a system event (such as a low-memory warning) cancels a press event. + +``` swift +open func pressesCancelled(_ presses: Set, with event: PressesEvent?) +``` + +### `remoteControlReceived(with:)` + +Tells the object when a remote-control event is received. + +``` swift +open func remoteControlReceived(with event: Event?) +``` + +### `reloadInputViews()` + +Updates the custom input and accessory views when the object is the first +responder. + +``` swift +open func reloadInputViews() +``` + +### `buildMenu(with:)` + +Asks the receiving responder to add and remove items from a menu system. + +``` swift +open func buildMenu(with builder: MenuBuilder) +``` + +### `validate(_:)` + +Asks the receiving responder to validate the command. + +``` swift +public func validate(_ command: Command) +``` + +### `canPerformAction(_:withSender:)` + +Requests the receiving responder to enable or disable the specified +command in the user interface. + +``` swift +open func canPerformAction(_ action: (AnyObject) -> (_: Action, _: Any?) -> Void, + withSender sender: Any?) -> Bool +``` + +### `target(forAction:withSender:)` + +``` swift +open func target(forAction action: (AnyObject) -> (_: Action, _: Any?) -> Void, + withSender sender: Any?) -> Any? +``` diff --git a/SwiftWin32/Scene.md b/SwiftWin32/Scene.md new file mode 100644 index 00000000..ad9c93c8 --- /dev/null +++ b/SwiftWin32/Scene.md @@ -0,0 +1,115 @@ +--- +layout: default +title: Scene +parent: SwiftWin32 +--- +# Scene + +``` swift +public class Scene: Responder +``` + +## Inheritance + +[`Responder`](https://compnerd.github.io/swift-win32/SwiftWin32/Responder), `Hashable` + +## Initializers + +### `init(session:connectionOptions:)` + +Creating a Scene Object +Creates a scene object using the specified session and connection +information. + +``` swift +public required init(session: SceneSession, + connectionOptions: Scene.ConnectionOptions) +``` + +## Properties + +### `delegate` + +Managing the Life Cycle of a Scene +The object you use to recieve life-cycle events associated with the scene. + +``` swift +public var delegate: SceneDelegate? +``` + +### `session` + +Getting the Scene's Session +The session associated with the scene. + +``` swift +public let session: SceneSession +``` + +### `willConnectNotification` + +A notification indicating that a scene was added to the application. + +``` swift +public class var willConnectNotification: NSNotification.Name +``` + +### `didDisconnectNotification` + +A notification indicating that a scene was removed from the application. + +``` swift +public class var didDisconnectNotification: NSNotification.Name +``` + +### `willEnterForegroundNotification` + +A notification indicating that a scene is about to begin running in the +foreground and become visible to the user. + +``` swift +public class var willEnterForegroundNotification: NSNotification.Name +``` + +### `didActivateNotification` + +A notification indicating that the scene is now onscreen and reponding to +user events. + +``` swift +public class var didActivateNotification: NSNotification.Name +``` + +### `willDeactivateNotification` + +A notification indicating that the scene is about to resign the active +state and stop responding to user events. + +``` swift +public class var willDeactivateNotification: NSNotification.Name +``` + +### `didEnterBackgroundNotification` + +A notification indicating that the scene is running in the background and +is no longer onscreen. + +``` swift +public class var didEnterBackgroundNotification: NSNotification.Name +``` + +## Methods + +### `hash(into:)` + +``` swift +public func hash(into hasher: inout Hasher) +``` + +## Operators + +### `==` + +``` swift +public static func == (lhs: Scene, rhs: Scene) -> Bool +``` diff --git a/SwiftWin32/SceneConfiguration.md b/SwiftWin32/SceneConfiguration.md new file mode 100644 index 00000000..17fae14e --- /dev/null +++ b/SwiftWin32/SceneConfiguration.md @@ -0,0 +1,79 @@ +--- +layout: default +title: SceneConfiguration +parent: SwiftWin32 +--- +# SceneConfiguration + +``` swift +public class SceneConfiguration +``` + +## Inheritance + +`Hashable` + +## Initializers + +### `init(name:sessionRole:)` + +Creating a Configuration Object +Creates a scene-configuration object with the specified role and +application-specific name. + +``` swift +public init(name: String?, sessionRole: SceneSession.Role) +``` + +## Properties + +### `sceneClass` + +Specifying the Scene Creation Details +The class of the scene object you want to create. + +``` swift +public var sceneClass: AnyClass? +``` + +### `delegateClass` + +The class of the delegate object you want to create. + +``` swift +public var delegateClass: AnyClass? +``` + +### `name` + +Getting the Configuration Attributes +The application-specific name assigned to the scene configuration. + +``` swift +public private(set) var name: String? +``` + +### `role` + +The role assigned to the scene configuration. + +``` swift +public let role: SceneSession.Role +``` + +## Methods + +### `hash(into:)` + +``` swift +public func hash(into hasher: inout Hasher) +``` + +## Operators + +### `==` + +``` swift +public static func == (lhs: SceneConfiguration, rhs: SceneConfiguration) + -> Bool +``` diff --git a/SwiftWin32/SceneDelegate.md b/SwiftWin32/SceneDelegate.md new file mode 100644 index 00000000..fa024ec3 --- /dev/null +++ b/SwiftWin32/SceneDelegate.md @@ -0,0 +1,108 @@ +--- +layout: default +title: SceneDelegate +parent: SwiftWin32 +--- +# SceneDelegate + +``` swift +public protocol SceneDelegate: _TriviallyConstructible +``` + +## Inheritance + +[`_TriviallyConstructible`](https://compnerd.github.io/swift-win32/SwiftWin32/_TriviallyConstructible) + +## Default Implementations + +### `scene(_:willConnectTo:options:)` + +``` swift +public func scene(_ scene: Scene, willConnectTo: SceneSession, + options: Scene.ConnectionOptions) +``` + +### `sceneDidDisconnect(_:)` + +``` swift +public func sceneDidDisconnect(_ scene: Scene) +``` + +### `sceneWillEnterForeground(_:)` + +``` swift +public func sceneWillEnterForeground(_ scene: Scene) +``` + +### `sceneDidBecomeActive(_:)` + +``` swift +public func sceneDidBecomeActive(_ scene: Scene) +``` + +### `sceneWillResignActive(_:)` + +``` swift +public func sceneWillResignActive(_ scene: Scene) +``` + +### `sceneDidEnterBackground(_:)` + +``` swift +public func sceneDidEnterBackground(_ scene: Scene) +``` + +## Requirements + +### scene(\_:​willConnectTo:​options:​) + +Informs the delegate about the addition of a scene to the application. + +``` swift +func scene(_ scene: Scene, willConnectTo: SceneSession, + options: Scene.ConnectionOptions) +``` + +### sceneDidDisconnect(\_:​) + +Informs the delegate that a scene was removed from the application. + +``` swift +func sceneDidDisconnect(_ scene: Scene) +``` + +### sceneWillEnterForeground(\_:​) + +Informs the delegate that the scene is about to begin running in the +foreground and become visible to the user. + +``` swift +func sceneWillEnterForeground(_ scene: Scene) +``` + +### sceneDidBecomeActive(\_:​) + +Informs the delegate that the scene became active and is now responding to +user events. + +``` swift +func sceneDidBecomeActive(_ scene: Scene) +``` + +### sceneWillResignActive(\_:​) + +Informs the delegate that the scene is about to resign the active state +and stop responding to user events. + +``` swift +func sceneWillResignActive(_ scene: Scene) +``` + +### sceneDidEnterBackground(\_:​) + +Informs the delegate that the scene is running in the background and is no +longer onscreen. + +``` swift +func sceneDidEnterBackground(_ scene: Scene) +``` diff --git a/SwiftWin32/SceneSession.md b/SwiftWin32/SceneSession.md new file mode 100644 index 00000000..5ef3e1b9 --- /dev/null +++ b/SwiftWin32/SceneSession.md @@ -0,0 +1,64 @@ +--- +layout: default +title: SceneSession +parent: SwiftWin32 +--- +# SceneSession + +``` swift +public class SceneSession +``` + +## Inheritance + +`Hashable` + +## Properties + +### `scene` + +The scene associated with the current session. + +``` swift +public internal(set) weak var scene: Scene? +``` + +### `role` + +The role played by the scene's content. + +``` swift +public let role: SceneSession.Role +``` + +### `configuration` + +The configuration data for creating the secene. + +``` swift +public internal(set) var configuration: SceneConfiguration +``` + +### `persistentIdentifier` + +A unique identifier that persists for the lifetime of the session + +``` swift +public let persistentIdentifier: String +``` + +## Methods + +### `hash(into:)` + +``` swift +public func hash(into hasher: inout Hasher) +``` + +## Operators + +### `==` + +``` swift +public static func == (lhs: SceneSession, rhs: SceneSession) -> Bool +``` diff --git a/SwiftWin32/SceneSession_Role.md b/SwiftWin32/SceneSession_Role.md new file mode 100644 index 00000000..a0f7a45f --- /dev/null +++ b/SwiftWin32/SceneSession_Role.md @@ -0,0 +1,57 @@ +--- +layout: default +title: SceneSession.Role +parent: SwiftWin32 +--- +# SceneSession.Role + +Constants that indicate the possible roles for a scene. + +``` swift +public struct Role: Equatable, Hashable, RawRepresentable +``` + +## Inheritance + +`Equatable`, `Hashable`, `RawRepresentable` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = String +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `windowApplication` + +The scene displays noninteractive windows on an externally connected +screen. + +``` swift +public static var windowApplication: SceneSession.Role +``` + +### `windowExternalDisplay` + +The scene displays interactive content on the device's main screen. + +``` swift +public static var windowExternalDisplay: SceneSession.Role +``` diff --git a/SwiftWin32/SceneSizeRestrictions.md b/SwiftWin32/SceneSizeRestrictions.md new file mode 100644 index 00000000..81470346 --- /dev/null +++ b/SwiftWin32/SceneSizeRestrictions.md @@ -0,0 +1,29 @@ +--- +layout: default +title: SceneSizeRestrictions +parent: SwiftWin32 +--- +# SceneSizeRestrictions + +``` swift +public class SceneSizeRestrictions +``` + +## Properties + +### `minimumSize` + +Setting the Size Restrictions +The minimum width and height supported by your application's windows. + +``` swift +public var minimumSize: Size +``` + +### `maximumSize` + +The maximum width and height supported by your application's windows. + +``` swift +public var maximumSize: Size +``` diff --git a/SwiftWin32/Scene_ConnectionOptions.md b/SwiftWin32/Scene_ConnectionOptions.md new file mode 100644 index 00000000..cb4f269b --- /dev/null +++ b/SwiftWin32/Scene_ConnectionOptions.md @@ -0,0 +1,10 @@ +--- +layout: default +title: Scene.ConnectionOptions +parent: SwiftWin32 +--- +# Scene.ConnectionOptions + +``` swift +public class ConnectionOptions +``` diff --git a/SwiftWin32/Screen.md b/SwiftWin32/Screen.md new file mode 100644 index 00000000..4baa43af --- /dev/null +++ b/SwiftWin32/Screen.md @@ -0,0 +1,84 @@ +--- +layout: default +title: Screen +parent: SwiftWin32 +--- +# Screen + +``` swift +public final class Screen +``` + +## Inheritance + +`CustomDebugStringConvertible`, [`TraitEnvironment`](https://compnerd.github.io/swift-win32/SwiftWin32/TraitEnvironment) + +## Properties + +### `main` + +Returns the screen object representing the device's screen. + +``` swift +public static var main: Screen +``` + +### `screens` + +Returns an array containing all the screens attached to the device. + +``` swift +public static var screens: [Screen] +``` + +### `mirrored` + +The screen being mirrored by an external display. + +``` swift +public var mirrored: Screen? +``` + +### `bounds` + +The bounding rectangle of the screen, measured in points. + +``` swift +public let bounds: Rect +``` + +### `nativeBounds` + +The bounding rectangle of the physical screen, measured in pixels. + +``` swift +public let nativeBounds: Rect +``` + +### `nativeScale` + +The native scale factor for the physical screen. + +``` swift +public let nativeScale: Double +``` + +### `traitCollection` + +``` swift +public private(set) var traitCollection: TraitCollection +``` + +### `debugDescription` + +``` swift +public var debugDescription: String +``` + +## Methods + +### `traitCollectionDidChange(_:)` + +``` swift +public func traitCollectionDidChange(_ previousTraitCollection: TraitCollection?) +``` diff --git a/SwiftWin32/Size.md b/SwiftWin32/Size.md new file mode 100644 index 00000000..aec3c02d --- /dev/null +++ b/SwiftWin32/Size.md @@ -0,0 +1,72 @@ +--- +layout: default +title: Size +parent: SwiftWin32 +--- +# Size + +A structure that contains width and height values. + +``` swift +public struct Size +``` + +## Inheritance + +`CustomDebugStringConvertible` + +## Initializers + +### `init()` + +Creates a size with zero width and height. + +``` swift +public init() +``` + +### `init(width:height:)` + +Creates a size with dimensions specified as floating-point values. + +``` swift +public init(width: Double, height: Double) +``` + +### `init(width:height:)` + +``` swift +public init(width: Int, height: Int) +``` + +## Properties + +### `width` + +A width value. + +``` swift +public var width: Double +``` + +### `height` + +A height value. + +``` swift +public var height: Double +``` + +### `zero` + +The size whose width and height are both zero. + +``` swift +public static var zero: Size +``` + +### `debugDescription` + +``` swift +public var debugDescription: String +``` diff --git a/SwiftWin32/Slider.md b/SwiftWin32/Slider.md new file mode 100644 index 00000000..be73e802 --- /dev/null +++ b/SwiftWin32/Slider.md @@ -0,0 +1,50 @@ +--- +layout: default +title: Slider +parent: SwiftWin32 +--- +# Slider + +A control for selecting a single value from a continuous range of values. + +``` swift +public class Slider: Control +``` + +## Inheritance + +[`Control`](https://compnerd.github.io/swift-win32/SwiftWin32/Control) + +## Initializers + +### `init(frame:)` + +``` swift +public init(frame: Rect) +``` + +## Properties + +### `value` + +The slider’s current value. + +``` swift +public var value: Float +``` + +### `minimumValue` + +The minimum value of the slider. + +``` swift +public var minimumValue: Float +``` + +### `maximumValue` + +The maximum value of the slider. + +``` swift +public var maximumValue: Float +``` diff --git a/SwiftWin32/SpringLoadedInteractionContext.md b/SwiftWin32/SpringLoadedInteractionContext.md new file mode 100644 index 00000000..bf9883ce --- /dev/null +++ b/SwiftWin32/SpringLoadedInteractionContext.md @@ -0,0 +1,41 @@ +--- +layout: default +title: SpringLoadedInteractionContext +parent: SwiftWin32 +--- +# SpringLoadedInteractionContext + +The interface an object implements to provide information about a +spring-loaded interaction. + +``` swift +public protocol SpringLoadedInteractionContext +``` + +## Requirements + +### state + +The current view style for the string-loaded interaction. + +``` swift +var state: SpringLoadedInteractionEffectState +``` + +### targetItem + +The specific subview, or associated model object, of the target view to +use for the spring-loaded interaction. + +``` swift +var targetItem: Any? +``` + +### targetView + +The view to which the current spring-loaded interaction view style is +applied. + +``` swift +var targetView: View? +``` diff --git a/SwiftWin32/SpringLoadedInteractionEffectState.md b/SwiftWin32/SpringLoadedInteractionEffectState.md new file mode 100644 index 00000000..af80c417 --- /dev/null +++ b/SwiftWin32/SpringLoadedInteractionEffectState.md @@ -0,0 +1,51 @@ +--- +layout: default +title: SpringLoadedInteractionEffectState +parent: SwiftWin32 +--- +# SpringLoadedInteractionEffectState + +The spring-loaded interaction states that determine the style of the +interaction view. + +``` swift +public enum SpringLoadedInteractionEffectState: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `activated` + +An interaction state that indicates that the view was spring loaded. + +``` swift +case activated +``` + +### `activating` + +An interaction state that indicates that spring loading is about to start. + +``` swift +case activating +``` + +### `inactive` + +An interaction state that indicates that spring loading is not engaged. + +``` swift +case inactive +``` + +### `possible` + +An interaction state that indicates that spring loading is available. + +``` swift +case possible +``` diff --git a/SwiftWin32/SpringTimingParameters.md b/SwiftWin32/SpringTimingParameters.md new file mode 100644 index 00000000..594e04f9 --- /dev/null +++ b/SwiftWin32/SpringTimingParameters.md @@ -0,0 +1,68 @@ +--- +layout: default +title: SpringTimingParameters +parent: SwiftWin32 +--- +# SpringTimingParameters + +The timing information for animations that mimics the behavior of a spring. + +``` swift +public class SpringTimingParameters +``` + +## Initializers + +### `init()` + +Creates a default timing parameters object. + +``` swift +public init() +``` + +This method sets the initial velocity of any animated properties to 0.0 +and sets the damping ratio to 4.56. + +### `init(dampingRatio:)` + +Creates a timing parameters object with the specified damping ratio. + +``` swift +public convenience init(dampingRatio ratio: Double) +``` + +This method sets the initial velocity of any animated properties to 0.0. + +### `init(dampingRatio:initialVelocity:)` + +Creates a timing parameters object with the specified damping ratio and +initial velocity. + +``` swift +public init(dampingRatio ratio: Double, initialVelocity velocity: Vector) +``` + +### `init(mass:stiffness:damping:initialVelocity:)` + +Creates a timing parameters object with the specified spring stiffness, +mass, damping coefficient, and initial velocity. + +``` swift +public init(mass: Double, stiffness: Double, damping: Double, + initialVelocity velocity: Vector) +``` + +The damping ratio for the spring is computed from the formula: +`damping / (2 * sqrt (stiffness * mass))`. + +## Properties + +### `initialVelocity` + +The target property’s rate of change at the start of a spring animation, +enabling a smooth transition into the animation. + +``` swift +public private(set) var initialVelocity: Vector +``` diff --git a/SwiftWin32/Stepper.md b/SwiftWin32/Stepper.md new file mode 100644 index 00000000..8321f416 --- /dev/null +++ b/SwiftWin32/Stepper.md @@ -0,0 +1,85 @@ +--- +layout: default +title: Stepper +parent: SwiftWin32 +--- +# Stepper + +A control for incrementing or decrementing a value. + +``` swift +public class Stepper: Control +``` + +## Inheritance + +[`Control`](https://compnerd.github.io/swift-win32/SwiftWin32/Control) + +## Initializers + +### `init(frame:)` + +``` swift +public init(frame: Rect) +``` + +## Properties + +### `isContinuous` + +A boolean value that determines whether to send value changes during user +interaction or after user interaction ends. + +``` swift +public var isContinuous: Bool = true +``` + +### `autorepeat` + +A boolean value that determines whether to repeatedly change the stepper's +value as the user presses and holds a stepper button. + +``` swift +public var autorepeat: Bool = true +``` + +### `wraps` + +A boolean value that determines whether the stepper can wrap its value to +the minimum or maximum value when incrementing and decrementing the value. + +``` swift +public var wraps: Bool +``` + +### `minimumValue` + +The lowest possible numeric value for the stepper. + +``` swift +public var minimumValue: Double +``` + +### `maximumValue` + +The highest possible numeric value for the stepper. + +``` swift +public var maximumValue: Double +``` + +### `stepValue` + +The step, or increment, value for the stepper. + +``` swift +public var stepValue: Double +``` + +### `value` + +The numeric value of the stepper. + +``` swift +public var value: Double +``` diff --git a/SwiftWin32/String.md b/SwiftWin32/String.md new file mode 100644 index 00000000..0f9a612d --- /dev/null +++ b/SwiftWin32/String.md @@ -0,0 +1,14 @@ +--- +layout: default +title: String +parent: SwiftWin32 +--- +# Extensions on String + +## Properties + +### `wide` + +``` swift +public var wide: [UInt16] +``` diff --git a/SwiftWin32/SwipeActionsConfiguration.md b/SwiftWin32/SwipeActionsConfiguration.md new file mode 100644 index 00000000..54dc75ec --- /dev/null +++ b/SwiftWin32/SwipeActionsConfiguration.md @@ -0,0 +1,42 @@ +--- +layout: default +title: SwipeActionsConfiguration +parent: SwiftWin32 +--- +# SwipeActionsConfiguration + +The set of actions to perform when swiping on rows of a table. + +``` swift +public class SwipeActionsConfiguration +``` + +## Initializers + +### `init(actions:)` + +Creates a swipe action configuration object with the specified set of +actions. + +``` swift +public init(actions: [ContextualAction]) +``` + +## Properties + +### `actions` + +The swipe actions. + +``` swift +public private(set) var actions: [ContextualAction] +``` + +### `performsFirstActionWithFullSwipe` + +A boolean value indicating whether a full swipe automatically performs the +first action. + +``` swift +public var performsFirstActionWithFullSwipe: Bool = true +``` diff --git a/SwiftWin32/Switch.md b/SwiftWin32/Switch.md new file mode 100644 index 00000000..3b1d61bb --- /dev/null +++ b/SwiftWin32/Switch.md @@ -0,0 +1,72 @@ +--- +layout: default +title: Switch +parent: SwiftWin32 +--- +# Switch + +A control that offers a binary choice, such as on/off. + +``` swift +public class Switch: Control +``` + +## Inheritance + +[`Control`](https://compnerd.github.io/swift-win32/SwiftWin32/Control) + +## Initializers + +### `init(frame:)` + +Returns an initialized switch object. + +``` swift +public init(frame: Rect) +``` + +## Properties + +### `isOn` + +A Boolean value that determines the off/on state of the switch. + +``` swift +public var isOn: Bool +``` + +### `preferredStyle` + +The preferred display style for the switch. + +``` swift +public var preferredStyle: Switch.Style = .automatic +``` + +### `style` + +The display style for the switch. + +``` swift +public private(set) var style: Switch.Style = .checkbox +``` + +### `title` + +The title displayed next to a checkbox-style switch. + +``` swift +@_Win32WindowText + public var title: String? +``` + +## Methods + +### `setOn(_:animated:)` + +Set the state of the switch to On or Off, optionally animating the +transition. + +``` swift +public func setOn(_ on: Bool, animated: Bool) +``` diff --git a/SwiftWin32/Switch_Style.md b/SwiftWin32/Switch_Style.md new file mode 100644 index 00000000..dc9c025d --- /dev/null +++ b/SwiftWin32/Switch_Style.md @@ -0,0 +1,43 @@ +--- +layout: default +title: Switch.Style +parent: SwiftWin32 +--- +# Switch.Style + +Styles that determine the appearance of the switch. + +``` swift +public enum Style: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `automatic` + +A style indicating that the system chooses the appearance of the switch +according to the current user interface idiom. + +``` swift +case automatic +``` + +### `checkbox` + +A style indicating that the switch appears as a checkbox. + +``` swift +case checkbox +``` + +### `sliding` + +A style indicating that the switch appears as an on/off slider. + +``` swift +case sliding +``` diff --git a/SwiftWin32/TableView.md b/SwiftWin32/TableView.md new file mode 100644 index 00000000..9f82ff69 --- /dev/null +++ b/SwiftWin32/TableView.md @@ -0,0 +1,63 @@ +--- +layout: default +title: TableView +parent: SwiftWin32 +--- +# TableView + +A view that presents data using rows arranged in a single column. + +``` swift +public class TableView: View +``` + +## Inheritance + +[`View`](https://compnerd.github.io/swift-win32/SwiftWin32/View) + +## Initializers + +### `init(frame:style:)` + +Initializes and returns a table view having the given frame and style. + +``` swift +public init(frame: Rect, style: TableView.Style) +``` + +## Properties + +### `dataSource` + +The object that acts as the data source of the table view. + +``` swift +public weak var dataSource: TableViewDataSource? +``` + +### `style` + +The style of the table view. + +``` swift +public let style: TableView.Style +``` + +### `allowsMultipleSelection` + +A boolean value that determines whether users can select more than one row +outside of editing mode. + +``` swift +public var allowsMultipleSelection: Bool +``` + +## Methods + +### `reloadData()` + +Reloads the rows and sections of the table view. + +``` swift +public func reloadData() +``` diff --git a/SwiftWin32/TableViewCell.md b/SwiftWin32/TableViewCell.md new file mode 100644 index 00000000..04156de7 --- /dev/null +++ b/SwiftWin32/TableViewCell.md @@ -0,0 +1,95 @@ +--- +layout: default +title: TableViewCell +parent: SwiftWin32 +--- +# TableViewCell + +The visual representation of a single row in a table view. + +``` swift +public class TableViewCell: View +``` + +## Inheritance + +[`View`](https://compnerd.github.io/swift-win32/SwiftWin32/View) + +## Initializers + +### `init(style:reuseIdentifier:)` + +Initializes a table cell with a style and a reuse identifier and returns it +to the caller. + +``` swift +public init(style: TableViewCell.CellStyle, reuseIdentifier: String?) +``` + +## Properties + +### `reuseIdentifier` + +A string used to identify a cell that is reusable. + +``` swift +public let reuseIdentifier: String? +``` + +### `isEditing` + +A boolean value that indicates whether the cell is in an editable state. + +``` swift +public var isEditing: Bool = false +``` + +### `editingStyle` + +The editing style of the cell. + +``` swift +public private(set) var editingStyle: TableViewCell.EditingStyle = .none +``` + +### `showingDeleteConfirmation` + +A boolean value that indicates whether the cell is currently showing the +delete-confirmation button. + +``` swift +public private(set) var showingDeleteConfirmation: Bool = false +``` + +### `showsReorderControl` + +A boolean value that determines whether the cell shows the reordering +control. + +``` swift +public var showsReorderControl: Bool = false +``` + +## Methods + +### `sizeThatFits(_:)` + +``` swift +public override func sizeThatFits(_ size: Size) -> Size +``` + +### `prepareForReuse()` + +Prepares a reusable cell for reuse by the table view's delegate. + +``` swift +public func prepareForReuse() +``` + +### `setEditing(_:animated:)` + +Toggles the receiver into and out of editing mode. + +``` swift +public func setEditing(_ editing: Bool, animated: Bool) +``` diff --git a/SwiftWin32/TableViewCell_CellStyle.md b/SwiftWin32/TableViewCell_CellStyle.md new file mode 100644 index 00000000..a7e68b8f --- /dev/null +++ b/SwiftWin32/TableViewCell_CellStyle.md @@ -0,0 +1,54 @@ +--- +layout: default +title: TableViewCell.CellStyle +parent: SwiftWin32 +--- +# TableViewCell.CellStyle + +``` swift +public enum CellStyle: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `` `default` `` + +A simple style for a cell with a text label (black and left-aligned) and +an optional view. + +``` swift +case `default` +``` + +### `value1` + +A style for a cell with a label on the left side of the cell with a +left-aligned and black text; on the right side is a label that has smaller +blue text and is right aligned. + +``` swift +case value1 +``` + +### `value2` + +A style for a cell with a label on the left side of the cell with text +that is right-aligned and blue on the right side of the cell is another +label with smaller text that is left-aligned and black. + +``` swift +case value2 +``` + +### `subtitle` + +A style for a cell with a left-aligned label across the top and a +left-aliggned label below it in smaller gray text. + +``` swift +case subtitle +``` diff --git a/SwiftWin32/TableViewCell_EditingStyle.md b/SwiftWin32/TableViewCell_EditingStyle.md new file mode 100644 index 00000000..f3941746 --- /dev/null +++ b/SwiftWin32/TableViewCell_EditingStyle.md @@ -0,0 +1,44 @@ +--- +layout: default +title: TableViewCell.EditingStyle +parent: SwiftWin32 +--- +# TableViewCell.EditingStyle + +The editing control used by a cell. + +``` swift +public enum EditingStyle: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `none` + +The cell has no editing control. This is the default value. + +``` swift +case none +``` + +### `delete` + +The cell has the delete editing control; this control is a red circle +enclosing a minus sign. + +``` swift +case delete +``` + +### `insert` + +The cell has the insert editing control; this control is a green circle +enclosing a plus sign. + +``` swift +case insert +``` diff --git a/SwiftWin32/TableViewDataSource.md b/SwiftWin32/TableViewDataSource.md new file mode 100644 index 00000000..40fcc94b --- /dev/null +++ b/SwiftWin32/TableViewDataSource.md @@ -0,0 +1,86 @@ +--- +layout: default +title: TableViewDataSource +parent: SwiftWin32 +--- +# TableViewDataSource + +``` swift +public protocol TableViewDataSource: AnyObject +``` + +## Inheritance + +`AnyObject` + +## Default Implementations + +### `numberOfSections(in:)` + +``` swift +public func numberOfSections(in tableView: TableView) -> Int +``` + +### `tableView(_:titleForHeaderInSection:)` + +``` swift +public func tableView(_ tableView: TableView, + titleForHeaderInSection section: Int) -> String? +``` + +### `tableView(_:titleForFooterInSection:)` + +``` swift +public func tableView(_ tableView: TableView, + titleForFooterInSection section: Int) -> String? +``` + +## Requirements + +### tableView(\_:​numberOfRowsInSection:​) + +Informs the data source to return the number of rows in a given section of +a table view. + +``` swift +func tableView(_ tableView: TableView, numberOfRowsInSection section: Int) + -> Int +``` + +### numberOfSections(in:​) + +Asks the data source to return the number of sections in the table view. + +``` swift +func numberOfSections(in tableView: TableView) -> Int +``` + +### tableView(\_:​cellForRowAt:​) + +Asks the data source for a cell to insert in a particular location of the +table view. + +``` swift +func tableView(_ tableView: TableView, cellForRowAt indexPath: IndexPath) + -> TableViewCell +``` + +### tableView(\_:​titleForHeaderInSection:​) + +Asks the data source for the title of the header of the specified section +of the table view. + +``` swift +func tableView(_ tableView: TableView, titleForHeaderInSection section: Int) + -> String? +``` + +### tableView(\_:​titleForFooterInSection:​) + +Asks the data source for the title of the footer of the specified section +of the table view. + +``` swift +func tableView(_ tableView: TableView, titleForFooterInSection section: Int) + -> String? +``` diff --git a/SwiftWin32/TableViewDelegate.md b/SwiftWin32/TableViewDelegate.md new file mode 100644 index 00000000..7dea01fa --- /dev/null +++ b/SwiftWin32/TableViewDelegate.md @@ -0,0 +1,813 @@ +--- +layout: default +title: TableViewDelegate +parent: SwiftWin32 +--- +# TableViewDelegate + +Methods for managing selections, configuring section headers and footers, +deleting and reordering cells, and performing other actions in a table view. + +``` swift +public protocol TableViewDelegate: AnyObject +``` + +## Inheritance + +`AnyObject` + +## Default Implementations + +### `tableView(_:willDisplay:forRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, willDisplay cell: TableViewCell, + forRowAt indexPath: IndexPath) +``` + +### `tableView(_:indentationLevelForRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + indentationLevelForRowAt indexPath: IndexPath) -> Int +``` + +### `tableView(_:shouldSpringLoadRowAt:with:)` + +``` swift +public func tableView(_ tableView: TableView, + shouldSpringLoadRowAt indexPath: IndexPath, + with context: SpringLoadedInteractionContext) -> Bool +``` + +### `tableView(_:willSelectRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + willSelectRowAt indexPath: IndexPath) -> IndexPath? +``` + +### `tableView(_:didSelectRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + didSelectRowAt indexPath: IndexPath) +``` + +### `tableView(_:willDeselectRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + willDeselectRowAt indexPath: IndexPath) -> IndexPath? +``` + +### `tableView(_:didDeselectRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + didDeselectRowAt indexPath: IndexPath) +``` + +### `tableView(_:shouldBeginMultipleSelectionInteractionAt:)` + +``` swift +public func tableView(_ tableView: TableView, + shouldBeginMultipleSelectionInteractionAt indexPath: IndexPath) + -> Bool +``` + +### `tableView(_:didBeginMultipleSelectionInteractionAt:)` + +``` swift +public func tableView(_ tableView: TableView, + didBeginMultipleSelectionInteractionAt indexPath: IndexPath) +``` + +### `tableViewDidEndMultipleSelectionInteraction(_:)` + +``` swift +public func tableViewDidEndMultipleSelectionInteraction(_ tableView: TableView) +``` + +### `tableView(_:viewForHeaderInSection:)` + +``` swift +public func tableView(_ tableView: TableView, + viewForHeaderInSection section: Int) -> View? +``` + +### `tableView(_:viewForFooterInSection:)` + +``` swift +public func tableView(_ tableView: TableView, + viewForFooterInSection section: Int) -> View? +``` + +### `tableView(_:willDisplayHeaderView:forSection:)` + +``` swift +public func tableView(_ tableView: TableView, + willDisplayHeaderView view: View, + forSection section: Int) +``` + +### `tableView(_:willDisplayFooterView:forSection:)` + +``` swift +public func tableView(_ tableView: TableView, + willDisplayFooterView view: View, + forSection section: Int) +``` + +### `tableView(_:heightForRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + heightForRowAt indexPath: IndexPath) -> Double +``` + +### `tableView(_:heightForHeaderInSection:)` + +``` swift +public func tableView(_ tableView: TableView, + heightForHeaderInSection section: Int) -> Double +``` + +### `tableView(_:heightForFooterInSection:)` + +``` swift +public func tableView(_ tableView: TableView, + heightForFooterInSection section: Int) -> Double +``` + +### `automaticDimension` + +``` swift +public static var automaticDimension: Double +``` + +### `tableView(_:estimatedHeightForRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + estimatedHeightForRowAt indexPath: IndexPath) -> Double +``` + +### `tableView(_:estimatedHeightForHeaderInSection:)` + +``` swift +public func tableView(_ tableView: TableView, + estimatedHeightForHeaderInSection section: Int) + -> Double +``` + +### `tableView(_:estimatedHeightForFooterInSection:)` + +``` swift +public func tableView(_ tableView: TableView, + estimatedHeightForFooterInSection section: Int) + -> Double +``` + +### `tableView(_:accessoryButtonTappedForRowWith:)` + +``` swift +public func tableView(_ tableView: TableView, + accessoryButtonTappedForRowWith indexPath: IndexPath) +``` + +### `tableView(_:contextMenuConfigurationForRowAt:point:)` + +``` swift +public func tableView(_ tableView: TableView, + contextMenuConfigurationForRowAt indexPath: IndexPath, + point: Point) -> ContextMenuConfiguration? +``` + +### `tableView(_:previewForDismissingContextMenuWithConfiguration:)` + +``` swift +public func tableView(_ tableView: TableView, + previewForDismissingContextMenuWithConfiguration configuration: ContextMenuConfiguration) + -> TargetedPreview? +``` + +### `tableView(_:previewForHighlightingContextMenuWithConfiguration:)` + +``` swift +public func tableView(_ tableView: TableView, + previewForHighlightingContextMenuWithConfiguration configuration: ContextMenuConfiguration) + -> TargetedPreview? +``` + +### `tableView(_:willDisplayContextMenu:animator:)` + +``` swift +public func tableView(_ tableView: TableView, + willDisplayContextMenu configuration: ContextMenuConfiguration, + animator: ContextMenuInteractionAnimating?) +``` + +### `tableView(_:willEndContextMenuInteraction:animator:)` + +``` swift +public func tableView(_ tableView: TableView, + willEndContextMenuInteraction configuration: ContextMenuConfiguration, + animator: ContextMenuInteractionAnimating?) +``` + +### `tableView(_:willPerformPreviewActionForMenuWith:animator:)` + +``` swift +public func tableView(_ tableView: TableView, + willPerformPreviewActionForMenuWith configuration: ContextMenuConfiguration, + animator: ContextMenuInteractionCommitAnimating) +``` + +### `tableView(_:leadingSwipeActionsConfigurationForRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + leadingSwipeActionsConfigurationForRowAt indexPath: IndexPath) + -> SwipeActionsConfiguration? +``` + +### `tableView(_:trailingSwipeActionsConfigurationForRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + trailingSwipeActionsConfigurationForRowAt indexPath: IndexPath) + -> SwipeActionsConfiguration? +``` + +### `tableView(_:shouldHighlightRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + shouldHighlightRowAt indexPath: IndexPath) -> Bool +``` + +### `tableView(_:didHighlightRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + didHighlightRowAt indexPath: IndexPath) +``` + +### `tableView(_:didUnhighlightRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + didUnhighlightRowAt indexPath: IndexPath) +``` + +### `tableView(_:willBeginEditingRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + willBeginEditingRowAt indexPath: IndexPath) +``` + +### `tableView(_:didEndEditingRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + didEndEditingRowAt indexPath: IndexPath?) +``` + +### `tableView(_:editingStyleForRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + editingStyleForRowAt indexPath: IndexPath) + -> TableViewCell.EditingStyle +``` + +### `tableView(_:titleForDeleteConfirmationButtonForRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + titleForDeleteConfirmationButtonForRowAt indexPath: IndexPath) + -> String? +``` + +### `tableView(_:shouldIndentWhileEditingRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + shouldIndentWhileEditingRowAt indexPath: IndexPath) + -> Bool +``` + +### `tableView(_:targetIndexPathForMoveFromRowAt:toProposedIndexPath:)` + +``` swift +public func tableView(_ tableView: TableView, + targetIndexPathForMoveFromRowAt sourceIndexPath: IndexPath, + toProposedIndexPath proposedDestinationIndexPath: IndexPath) + -> IndexPath +``` + +### `tableView(_:didEndDisplaying:forRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + didEndDisplaying cell: TableViewCell, + forRowAt indexPath: IndexPath) +``` + +### `tableView(_:didEndDisplayingHeaderView:forSection:)` + +``` swift +public func tableView(_ tableView: TableView, + didEndDisplayingHeaderView view: View, + forSection section: Int) +``` + +### `tableView(_:didEndDisplayingFooterView:forSection:)` + +``` swift +public func tableView(_ tableView: TableView, + didEndDisplayingFooterView view: View, + forSection section: Int) +``` + +### `tableView(_:canFocusRowAt:)` + +``` swift +public func tableView(_ tableView: TableView, + canFocusRowAt indexPath: IndexPath) -> Bool +``` + +### `tableView(_:shouldUpdateFocusIn:)` + +``` swift +public func tableView(_ tableView: TableView, + shouldUpdateFocusIn context: TableViewFocusUpdateContext) + -> Bool +``` + +### `tableView(_:didUpdateFocusIn:with:)` + +``` swift +public func tableView(_ tableView: TableView, + didUpdateFocusIn context: TableViewFocusUpdateContext, + with coordinator: FocusAnimationCoordinator) +``` + +### `indexPathForPreferredFocusedView(in:)` + +``` swift +public func indexPathForPreferredFocusedView(in tableView: TableView) + -> IndexPath? +``` + +## Requirements + +### tableView(\_:​willDisplay:​forRowAt:​) + +Informs the delegate the table view is about to draw a cell for a +particular row. + +``` swift +func tableView(_ tableView: TableView, willDisplay cell: TableViewCell, + forRowAt indexPath: IndexPath) +``` + +### tableView(\_:​indentationLevelForRowAt:​) + +Asks the delegate to return the level of indentation for a row in a given +section. + +``` swift +func tableView(_ tableView: TableView, + indentationLevelForRowAt indexPath: IndexPath) -> Int +``` + +### tableView(\_:​shouldSpringLoadRowAt:​with:​) + +Called to let you fine tune the spring-loading behavior of the rows in a +table. + +``` swift +func tableView(_ tableView: TableView, + shouldSpringLoadRowAt indexPath: IndexPath, + with context: SpringLoadedInteractionContext) -> Bool +``` + +### tableView(\_:​willSelectRowAt:​) + +Informs the delegate a row is about to be selected. + +``` swift +func tableView(_ tableView: TableView, willSelectRowAt indexPath: IndexPath) + -> IndexPath? +``` + +### tableView(\_:​didSelectRowAt:​) + +Informs the delegate a row is selected. + +``` swift +func tableView(_ tableView: TableView, didSelectRowAt indexPath: IndexPath) +``` + +### tableView(\_:​willDeselectRowAt:​) + +Informs the delegate that a specified row is about to be deselected. + +``` swift +func tableView(_ tableView: TableView, willDeselectRowAt indexPath: IndexPath) + -> IndexPath? +``` + +### tableView(\_:​didDeselectRowAt:​) + +Informs the delegate that the specified row is now deselected. + +``` swift +func tableView(_ tableView: TableView, didDeselectRowAt indexPath: IndexPath) +``` + +### tableView(\_:​shouldBeginMultipleSelectionInteractionAt:​) + +Asks the delegate whether the user can use a two-finger pan gesture to +select multiple items in a table view. + +``` swift +func tableView(_ tableView: TableView, + shouldBeginMultipleSelectionInteractionAt indexPath: IndexPath) + -> Bool +``` + +### tableView(\_:​didBeginMultipleSelectionInteractionAt:​) + +Informs the delegate when the user starts using a two-finger pan gesture +to select multiple rows in a table view. + +``` swift +func tableView(_ tableView: TableView, + didBeginMultipleSelectionInteractionAt indexPath: IndexPath) +``` + +### tableViewDidEndMultipleSelectionInteraction(\_:​) + +Informs the delegate when the user stops using a two-finger pan gesture to +select multiple rows in a table view. + +``` swift +func tableViewDidEndMultipleSelectionInteraction(_ tableView: TableView) +``` + +### tableView(\_:​viewForHeaderInSection:​) + +Asks the delegate for a view object to display in the header of the +specified section of the table view. + +``` swift +func tableView(_ tableView: TableView, viewForHeaderInSection section: Int) + -> View? +``` + +### tableView(\_:​viewForFooterInSection:​) + +Asks the delegate for a view object to display in the footer of the +specified section of the table view. + +``` swift +func tableView(_ tableView: TableView, viewForFooterInSection section: Int) + -> View? +``` + +### tableView(\_:​willDisplayHeaderView:​forSection:​) + +Informs the delegate that the table is about to display the header view +for the specified section. + +``` swift +func tableView(_ tableView: TableView, willDisplayHeaderView view: View, + forSection section: Int) +``` + +### tableView(\_:​willDisplayFooterView:​forSection:​) + +Informs the delegate that the table is about to display the footer view +for the specified section. + +``` swift +func tableView(_ tableView: TableView, willDisplayFooterView view: View, + forSection section: Int) +``` + +### tableView(\_:​heightForRowAt:​) + +Asks the delegate for the height to use for a row in a specified location. + +``` swift +func tableView(_ tableView: TableView, heightForRowAt indexPath: IndexPath) + -> Double +``` + +### tableView(\_:​heightForHeaderInSection:​) + +Asks the delegate for the height to use for the header of a particular +section. + +``` swift +func tableView(_ tableView: TableView, heightForHeaderInSection section: Int) + -> Double +``` + +### tableView(\_:​heightForFooterInSection:​) + +Asks the delegate for the height to use for the footer of a particular +section. + +``` swift +func tableView(_ tableView: TableView, heightForFooterInSection section: Int) + -> Double +``` + +### automaticDimension + +``` swift +static var automaticDimension: Double +``` + +### tableView(\_:​estimatedHeightForRowAt:​) + +Asks the delegate for the estimated height of a row in a specified +location. + +``` swift +func tableView(_ tableView: TableView, + estimatedHeightForRowAt indexPath: IndexPath) -> Double +``` + +### tableView(\_:​estimatedHeightForHeaderInSection:​) + +Asks the delegate for the estimated height of the header of a particular +section. + +``` swift +func tableView(_ tableView: TableView, + estimatedHeightForHeaderInSection section: Int) -> Double +``` + +### tableView(\_:​estimatedHeightForFooterInSection:​) + +Asks the delegate for the estimated height of the footer of a particular +section. + +``` swift +func tableView(_ tableView: TableView, + estimatedHeightForFooterInSection section: Int) -> Double +``` + +### tableView(\_:​accessoryButtonTappedForRowWith:​) + +Informs the delegate that the user tapped the detail button for the +specified row. + +``` swift +func tableView(_ tableView: TableView, + accessoryButtonTappedForRowWith indexPath: IndexPath) +``` + +### tableView(\_:​contextMenuConfigurationForRowAt:​point:​) + +Returns a context menu configuration for the row at a point. + +``` swift +func tableView(_ tableView: TableView, + contextMenuConfigurationForRowAt indexPath: IndexPath, + point: Point) -> ContextMenuConfiguration? +``` + +### tableView(\_:​previewForDismissingContextMenuWithConfiguration:​) + +Returns the destination view when dismissing a context menu. + +``` swift +func tableView(_ tableView: TableView, + previewForDismissingContextMenuWithConfiguration configuration: ContextMenuConfiguration) + -> TargetedPreview? +``` + +### tableView(\_:​previewForHighlightingContextMenuWithConfiguration:​) + +Returns a view to override the default preview the table view created. + +``` swift +func tableView(_ tableView: TableView, + previewForHighlightingContextMenuWithConfiguration configuration: ContextMenuConfiguration) + -> TargetedPreview? +``` + +### tableView(\_:​willDisplayContextMenu:​animator:​) + +Informs the delegate when a context menu will appear. + +``` swift +func tableView(_ tableView: TableView, + willDisplayContextMenu configuration: ContextMenuConfiguration, + animator: ContextMenuInteractionAnimating?) +``` + +### tableView(\_:​willEndContextMenuInteraction:​animator:​) + +Informs the delegate when a context menu will disappear. + +``` swift +func tableView(_ tableView: TableView, + willEndContextMenuInteraction configuration: ContextMenuConfiguration, + animator: ContextMenuInteractionAnimating?) +``` + +### tableView(\_:​willPerformPreviewActionForMenuWith:​animator:​) + +Informs the delegate when a user triggers a commit by tapping the preview. + +``` swift +func tableView(_ tableView: TableView, + willPerformPreviewActionForMenuWith configuration: ContextMenuConfiguration, + animator: ContextMenuInteractionCommitAnimating) +``` + +### tableView(\_:​leadingSwipeActionsConfigurationForRowAt:​) + +Returns the swipe actions to display on the leading edge of the row. + +``` swift +func tableView(_ tableView: TableView, + leadingSwipeActionsConfigurationForRowAt indexPath: IndexPath) + -> SwipeActionsConfiguration? +``` + +### tableView(\_:​trailingSwipeActionsConfigurationForRowAt:​) + +Returns the swipe actions to display on the trailing edge of the row. + +``` swift +func tableView(_ tableView: TableView, + trailingSwipeActionsConfigurationForRowAt indexPath: IndexPath) + -> SwipeActionsConfiguration? +``` + +### tableView(\_:​shouldHighlightRowAt:​) + +Asks the delegate if the specified row should be highlighted. + +``` swift +func tableView(_ tableView: TableView, + shouldHighlightRowAt indexPath: IndexPath) -> Bool +``` + +### tableView(\_:​didHighlightRowAt:​) + +Informs the delegate that the specified row was highlighted. + +``` swift +func tableView(_ tableView: TableView, didHighlightRowAt indexPath: IndexPath) +``` + +### tableView(\_:​didUnhighlightRowAt:​) + +Informs the delegate that the highlight was removed from the row at the +specified index path. + +``` swift +func tableView(_ tableView: TableView, + didUnhighlightRowAt indexPath: IndexPath) +``` + +### tableView(\_:​willBeginEditingRowAt:​) + +Informs the delegate that the table view is about to go into editing mode. + +``` swift +func tableView(_ tableView: TableView, + willBeginEditingRowAt indexPath: IndexPath) +``` + +### tableView(\_:​didEndEditingRowAt:​) + +Informs the delegate that the table view has left editing mode. + +``` swift +func tableView(_ tableView: TableView, + didEndEditingRowAt indexPath: IndexPath?) +``` + +### tableView(\_:​editingStyleForRowAt:​) + +Asks the delegate for the editing style of a row at a particular location +in a table view. + +``` swift +func tableView(_ tableView: TableView, + editingStyleForRowAt indexPath: IndexPath) + -> TableViewCell.EditingStyle +``` + +### tableView(\_:​titleForDeleteConfirmationButtonForRowAt:​) + +Changes the default title of the delete-confirmation button. + +``` swift +func tableView(_ tableView: TableView, + titleForDeleteConfirmationButtonForRowAt indexPath: IndexPath) + -> String? +``` + +### tableView(\_:​shouldIndentWhileEditingRowAt:​) + +Asks the delegate whether the background of the specified row should be +indented while the table view is in editing mode. + +``` swift +func tableView(_ tableView: TableView, + shouldIndentWhileEditingRowAt indexPath: IndexPath) -> Bool +``` + +### tableView(\_:​targetIndexPathForMoveFromRowAt:​toProposedIndexPath:​) + +Asks the delegate to return a new index path to retarget a proposed move +of a row. + +``` swift +func tableView(_ tableView: TableView, + targetIndexPathForMoveFromRowAt sourceIndexPath: IndexPath, + toProposedIndexPath proposedDestinationIndexPath: IndexPath) + -> IndexPath +``` + +### tableView(\_:​didEndDisplaying:​forRowAt:​) + +Informs the delegate that the specified cell was removed from the table. + +``` swift +func tableView(_ tableView: TableView, didEndDisplaying cell: TableViewCell, + forRowAt indexPath: IndexPath) +``` + +### tableView(\_:​didEndDisplayingHeaderView:​forSection:​) + +Informs the delegate that the specified header view was removed from the +table. + +``` swift +func tableView(_ tableView: TableView, didEndDisplayingHeaderView view: View, + forSection section: Int) +``` + +### tableView(\_:​didEndDisplayingFooterView:​forSection:​) + +Informs the delegate that the specified footer view was removed from the +table. + +``` swift +func tableView(_ tableView: TableView, didEndDisplayingFooterView view: View, + forSection section: Int) +``` + +### tableView(\_:​canFocusRowAt:​) + +Asks the delegate whether the cell at the specified index path is itself +focusable. + +``` swift +func tableView(_ tableView: TableView, canFocusRowAt indexPath: IndexPath) + -> Bool +``` + +### tableView(\_:​shouldUpdateFocusIn:​) + +Asks the delegate whether the focus update specified by the context is +allowed to occur. + +``` swift +func tableView(_ tableView: TableView, + shouldUpdateFocusIn context: TableViewFocusUpdateContext) + -> Bool +``` + +### tableView(\_:​didUpdateFocusIn:​with:​) + +Informs the delegate that a focus update specified by the context has just +occurred. + +``` swift +func tableView(_ tableView: TableView, + didUpdateFocusIn context: TableViewFocusUpdateContext, + with coordinator: FocusAnimationCoordinator) +``` + +### indexPathForPreferredFocusedView(in:​) + +Asks the delegate for the table view’s index path for the preferred +focused view. + +``` swift +func indexPathForPreferredFocusedView(in tableView: TableView) -> IndexPath? +``` diff --git a/SwiftWin32/TableViewFocusUpdateContext.md b/SwiftWin32/TableViewFocusUpdateContext.md new file mode 100644 index 00000000..606114a9 --- /dev/null +++ b/SwiftWin32/TableViewFocusUpdateContext.md @@ -0,0 +1,37 @@ +--- +layout: default +title: TableViewFocusUpdateContext +parent: SwiftWin32 +--- +# TableViewFocusUpdateContext + +A context object that provides information relevant to a specific focus +update from one view to another. + +``` swift +public class TableViewFocusUpdateContext: FocusUpdateContext +``` + +## Inheritance + +[`FocusUpdateContext`](https://compnerd.github.io/swift-win32/SwiftWin32/FocusUpdateContext) + +## Properties + +### `previouslyFocusedIndexPath` + +Returns the index path of the cell containing the context's previously +focused view. + +``` swift +public internal(set) var previouslyFocusedIndexPath: IndexPath? +``` + +### `nextFocusedIndexPath` + +Returns the index path of the cell containing the context's next focused +view. + +``` swift +public internal(set) var nextFocusedIndexPath: IndexPath? +``` diff --git a/SwiftWin32/TableViewHeaderFooterView.md b/SwiftWin32/TableViewHeaderFooterView.md new file mode 100644 index 00000000..48e5fb6e --- /dev/null +++ b/SwiftWin32/TableViewHeaderFooterView.md @@ -0,0 +1,129 @@ +--- +layout: default +title: TableViewHeaderFooterView +parent: SwiftWin32 +--- +# TableViewHeaderFooterView + +A reusable view that you place at the top or bottom of a table section to +display additional information for that section. + +``` swift +public class TableViewHeaderFooterView: View +``` + +## Inheritance + +[`View`](https://compnerd.github.io/swift-win32/SwiftWin32/View) + +## Initializers + +### `init(reuseIdentifier:)` + +Initializes a header/footer view with the specified reuse identifier. + +``` swift +public init(reuseIdentifier identifier: String?) +``` + +## Properties + +### `reuseIdentifier` + +A string used to identify a reusable header or footer. + +``` swift +public private(set) var reuseIdentifier: String? +``` + +### `backgroundConfiguration` + +The current background configuration of the view. + +``` swift +public var backgroundConfiguration: BackgroundConfiguration? +``` + +### `automaticallyUpdatesBackgroundConfiguration` + +A boolean value that determines whether the view automatically updates its +background configuration when its state changes. + +``` swift +public var automaticallyUpdatesBackgroundConfiguration: Bool = true +``` + +### `backgroundView` + +The background view of the header or footer. + +``` swift +public var backgroundView: View? +``` + +### `contentConfiguration` + +The current content configuration of the view. + +``` swift +public var contentConfiguration: ContentConfiguration? +``` + +### `automaticallyUpdatesContentConfiguration` + +A boolean value that determines whether the view automatically updates its +content configuration when its state changes. + +``` swift +public var automaticallyUpdatesContentConfiguration: Bool = true +``` + +### `contentView` + +The content view of the header or footer. + +``` swift +public private(set) var contentView: View +``` + +### `configurationState` + +The current configuration state of the view. + +``` swift +public private(set) var configurationState: ViewConfigurationState +``` + +## Methods + +### `prepareForReuse()` + +Prepares a reusable header or footer view for reuse by the table. + +``` swift +public func prepareForReuse() +``` + +### `defaultContentConfiguration()` + +Retrieves a default list content configuration for the view's style. + +``` swift +public func defaultContentConfiguration() -> ListContentConfiguration +``` + +### `setNeedsUpdateConfiguration()` + +Informs the view to update its configuration for its current state. + +``` swift +public func setNeedsUpdateConfiguration() +``` + +### `updateConfiguration(using:)` + +Updates the view's configuration using the current state. + +``` swift +public func updateConfiguration(using state: ViewConfigurationState) +``` diff --git a/SwiftWin32/TableView_Style.md b/SwiftWin32/TableView_Style.md new file mode 100644 index 00000000..cd8d7c77 --- /dev/null +++ b/SwiftWin32/TableView_Style.md @@ -0,0 +1,40 @@ +--- +layout: default +title: TableView.Style +parent: SwiftWin32 +--- +# TableView.Style + +``` swift +public enum Style: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `plain` + +A plain table view. + +``` swift +case plain +``` + +### `group` + +A table view where sections have distinct groups of rows. + +``` swift +case group +``` + +### `insetGrouped` + +A table view where the grouped sections are inset with rounded corners. + +``` swift +case insetGrouped +``` diff --git a/SwiftWin32/TapGestureRecognizer.md b/SwiftWin32/TapGestureRecognizer.md new file mode 100644 index 00000000..a73648e0 --- /dev/null +++ b/SwiftWin32/TapGestureRecognizer.md @@ -0,0 +1,42 @@ +--- +layout: default +title: TapGestureRecognizer +parent: SwiftWin32 +--- +# TapGestureRecognizer + +A discrete gesture recognizer that interprets single or multiple taps. + +``` swift +public class TapGestureRecognizer: GestureRecognizer +``` + +## Inheritance + +[`GestureRecognizer`](https://compnerd.github.io/swift-win32/SwiftWin32/GestureRecognizer) + +## Properties + +### `buttonMaskRequired` + +The bitmask of the buttons the user must press for gesture recognition. + +``` swift +public var buttonMaskRequired: Event.ButtonMask = [.primary] +``` + +### `numberOfTapsRequired` + +The number of taps necessary for gesture recognition. + +``` swift +public var numberOfTapsRequired: Int = 1 +``` + +### `numberOfTouchesRequired` + +The number of fingers that the user must tap for gesture recognition. + +``` swift +public var numberOfTouchesRequired: Int = 1 +``` diff --git a/SwiftWin32/TargetedPreview.md b/SwiftWin32/TargetedPreview.md new file mode 100644 index 00000000..1e83761d --- /dev/null +++ b/SwiftWin32/TargetedPreview.md @@ -0,0 +1,87 @@ +--- +layout: default +title: TargetedPreview +parent: SwiftWin32 +--- +# TargetedPreview + +``` swift +public class TargetedPreview +``` + +## Initializers + +### `init(view:parameters:target:)` + +Creting a Targeted Preview Object +Creates a targeted preview with the specified view, parameters, and target +container. + +``` swift +public init(view: View, parameters: PreviewParameters, target: PreviewTarget) +``` + +### `init(view:parameters:)` + +Creates a targeted preview for a view in the current window and including +the specified parameters. + +``` swift +public convenience init(view: View, parameters: PreviewParameters) +``` + +### `init(view:)` + +Creates a targeted preview for a view in the current window. + +``` swift +public convenience init(view: View) +``` + +## Properties + +### `view` + +Getting the Preview Attributes +The view that is the target of the animation + +``` swift +public let view: View +``` + +### `target` + +The view that is the container for the target view. + +``` swift +public let target: PreviewTarget +``` + +### `size` + +The size of the view. + +``` swift +public let size: Size +``` + +### `parameters` + +Additional parameters to use when configuring the animations. + +``` swift +public let parameters: PreviewParameters +``` + +## Methods + +### `retargetedPreview(with:)` + +Changing the Target's Container +Returns a targeted preview object with the same view and parameters, but +with a different target container. + +``` swift +public func retargetedPreview(with newTarget: PreviewTarget) + -> TargetedPreview +``` diff --git a/SwiftWin32/TextAlignment.md b/SwiftWin32/TextAlignment.md new file mode 100644 index 00000000..bea33f12 --- /dev/null +++ b/SwiftWin32/TextAlignment.md @@ -0,0 +1,46 @@ +--- +layout: default +title: TextAlignment +parent: SwiftWin32 +--- +# TextAlignment + +``` swift +public enum TextAlignment: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `natural` + +``` swift +case natural +``` + +### `left` + +``` swift +case left +``` + +### `right` + +``` swift +case right +``` + +### `center` + +``` swift +case center +``` + +### `justified` + +``` swift +case justified +``` diff --git a/SwiftWin32/TextField.md b/SwiftWin32/TextField.md new file mode 100644 index 00000000..74b9f0ce --- /dev/null +++ b/SwiftWin32/TextField.md @@ -0,0 +1,77 @@ +--- +layout: default +title: TextField +parent: SwiftWin32 +--- +# TextField + +``` swift +public class TextField: Control +``` + +## Inheritance + +[`Control`](https://compnerd.github.io/swift-win32/SwiftWin32/Control), [`TextInputTraits`](https://compnerd.github.io/swift-win32/SwiftWin32/TextInputTraits) + +## Initializers + +### `init(frame:)` + +``` swift +public init(frame: Rect) +``` + +## Properties + +### `delegate` + +``` swift +public weak var delegate: TextFieldDelegate? +``` + +### `text` + +Accessing the Text Attributes + +``` swift +@_Win32WindowText + public var text: String? +``` + +### `placeholder` + +``` swift +public var placeholder: String? +``` + +### `font` + +``` swift +public override var font: Font? +``` + +### `textAlignment` + +``` swift +public var textAlignment: TextAlignment +``` + +### `adjustsFontForContentSizeCategory` + +``` swift +public var adjustsFontForContentSizeCategory = false +``` + +### `isSecureTextEntry` + +``` swift +public var isSecureTextEntry: Bool +``` + +## Methods + +### `traitCollectionDidChange(_:)` + +``` swift +override public func traitCollectionDidChange(_ previousTraitCollection: TraitCollection?) +``` diff --git a/SwiftWin32/TextFieldDelegate.md b/SwiftWin32/TextFieldDelegate.md new file mode 100644 index 00000000..c9e8a0a0 --- /dev/null +++ b/SwiftWin32/TextFieldDelegate.md @@ -0,0 +1,14 @@ +--- +layout: default +title: TextFieldDelegate +parent: SwiftWin32 +--- +# TextFieldDelegate + +``` swift +public protocol TextFieldDelegate: AnyObject +``` + +## Inheritance + +`AnyObject` diff --git a/SwiftWin32/TextInputTraits.md b/SwiftWin32/TextInputTraits.md new file mode 100644 index 00000000..683ca66b --- /dev/null +++ b/SwiftWin32/TextInputTraits.md @@ -0,0 +1,28 @@ +--- +layout: default +title: TextInputTraits +parent: SwiftWin32 +--- +# TextInputTraits + +``` swift +public protocol TextInputTraits +``` + +## Default Implementations + +### `isSecureTextEntry` + +``` swift +public var isSecureTextEntry: Bool +``` + +## Requirements + +### isSecureTextEntry + +Managing the Keyboard Behaviour + +``` swift +var isSecureTextEntry: Bool +``` diff --git a/SwiftWin32/TextView.md b/SwiftWin32/TextView.md new file mode 100644 index 00000000..32898e27 --- /dev/null +++ b/SwiftWin32/TextView.md @@ -0,0 +1,63 @@ +--- +layout: default +title: TextView +parent: SwiftWin32 +--- +# TextView + +``` swift +public class TextView: View +``` + +## Inheritance + +[`View`](https://compnerd.github.io/swift-win32/SwiftWin32/View) + +## Initializers + +### `init(frame:)` + +``` swift +public init(frame: Rect) +``` + +## Properties + +### `editable` + +``` swift +public var editable: Bool +``` + +### `font` + +``` swift +public override var font: Font? +``` + +### `text` + +``` swift +@_Win32WindowText + public var text: String? +``` + +### `adjustsFontForContentSizeCategory` + +``` swift +public var adjustsFontForContentSizeCategory = false +``` + +## Methods + +### `scrollRangeToVisible(_:)` + +``` swift +public func scrollRangeToVisible(_ range: NSRange) +``` + +### `traitCollectionDidChange(_:)` + +``` swift +override public func traitCollectionDidChange(_ previousTraitCollection: TraitCollection?) +``` diff --git a/SwiftWin32/TimingCurveProvider.md b/SwiftWin32/TimingCurveProvider.md new file mode 100644 index 00000000..78d33607 --- /dev/null +++ b/SwiftWin32/TimingCurveProvider.md @@ -0,0 +1,39 @@ +--- +layout: default +title: TimingCurveProvider +parent: SwiftWin32 +--- +# TimingCurveProvider + +An interface for providing the timing information needed to perform +animations. + +``` swift +public protocol TimingCurveProvider +``` + +## Requirements + +### timingCurveType + +The type of timing information to use. + +``` swift +var timingCurveType: TimingCurveType +``` + +### cubicTimingParameters + +The cubic timing parameters to use. + +``` swift +var cubicTimingParameters: CubicTimingParameters? +``` + +### springTimingParameters + +The spring-based timing parameters to use. + +``` swift +var springTimingParameters: SpringTimingParameters? +``` diff --git a/SwiftWin32/TimingCurveType.md b/SwiftWin32/TimingCurveType.md new file mode 100644 index 00000000..83654a8b --- /dev/null +++ b/SwiftWin32/TimingCurveType.md @@ -0,0 +1,56 @@ +--- +layout: default +title: TimingCurveType +parent: SwiftWin32 +--- +# TimingCurveType + +Constants indicating the type of timing information to use. + +``` swift +public enum TimingCurveType: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `builtin` + +Use the built-in timing curves. Specify this value when you want to use +one of the constants in the `View.AnimationCurve` type. Specify the +desired curve using the `cubicTimingParameters` property. + +``` swift +case builtin +``` + +### `cubic` + +Use a custom cubic Bézier curve. Specify the curve information using the +`cubicTimingParameters` property. + +``` swift +case cubic +``` + +### `spring` + +Use a custom spring animation. Specify the desired curve using the +`springTimingParameters` property. + +``` swift +case spring +``` + +### `composed` + +Use a combination of timing parameters. This type of curve starts with the +curve defined by the `cubicTimingParameters` property and modifies it +using the spring information in the `springTimingParameters` property. + +``` swift +case composed +``` diff --git a/SwiftWin32/Touch.md b/SwiftWin32/Touch.md new file mode 100644 index 00000000..f1853fb9 --- /dev/null +++ b/SwiftWin32/Touch.md @@ -0,0 +1,53 @@ +--- +layout: default +title: Touch +parent: SwiftWin32 +--- +# Touch + +An object representing the location, size, movement, and force of a touch +occurring on the screen. + +``` swift +public class Touch +``` + +## Inheritance + +`Hashable` + +## Properties + +### `view` + +Getting the Location of a Touch +The view to which touches are being delivered, if any. + +``` swift +public let view: View? +``` + +### `timestamp` + +Getting Touch Attriutes +The time when the touch occurred or when it was last mutated. + +``` swift +public let timestamp: TimeInterval +``` + +## Methods + +### `hash(into:)` + +``` swift +public func hash(into hasher: inout Hasher) +``` + +## Operators + +### `==` + +``` swift +public static func ==(_ lhs: Touch, _ rhs: Touch) -> Bool +``` diff --git a/SwiftWin32/Touch_Phase.md b/SwiftWin32/Touch_Phase.md new file mode 100644 index 00000000..b624604b --- /dev/null +++ b/SwiftWin32/Touch_Phase.md @@ -0,0 +1,85 @@ +--- +layout: default +title: Touch.Phase +parent: SwiftWin32 +--- +# Touch.Phase + +The phase of a touch event. + +``` swift +public enum Phase: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `began` + +A touch for a given event has pressed down on the screen. + +``` swift +case began +``` + +### `moved` + +A touch for a given event has moved over the screen. + +``` swift +case moved +``` + +### `stationary` + +A touch for a given event is presseddown on the screen, but hasn't moved +since the previous event. + +``` swift +case stationary +``` + +### `ended` + +A touch for a given event has lifted from the screen. + +``` swift +case ended +``` + +### `cancelled` + +The system cancelled tracking for a touch, for example, when the user +moves the device against their face. + +``` swift +case cancelled +``` + +### `regionEntered` + +A touch for a given event has entered a window on the screen. + +``` swift +case regionEntered +``` + +### `regionMoved` + +A touch for the given event is within a window on the screen, but has not +yet pressed down. + +``` swift +case regionMoved +``` + +### `regionExited` + +A touch for given event has left a window on the screen. + +``` swift +case regionExited +``` diff --git a/SwiftWin32/Touch_TouchType.md b/SwiftWin32/Touch_TouchType.md new file mode 100644 index 00000000..22db5673 --- /dev/null +++ b/SwiftWin32/Touch_TouchType.md @@ -0,0 +1,42 @@ +--- +layout: default +title: Touch.TouchType +parent: SwiftWin32 +--- +# Touch.TouchType + +The type of touch received. + +``` swift +public enum TouchType: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `direct` + +A touch resulting from direct contact with the screen. + +``` swift +case direct +``` + +### `indirect` + +A touch that did not result from direct contact with the screen. + +``` swift +case indirect +``` + +### `pencil` + +A touch from a stylus. + +``` swift +case pencil +``` diff --git a/SwiftWin32/TraitCollection.md b/SwiftWin32/TraitCollection.md new file mode 100644 index 00000000..1dab7dc7 --- /dev/null +++ b/SwiftWin32/TraitCollection.md @@ -0,0 +1,383 @@ +--- +layout: default +title: TraitCollection +parent: SwiftWin32 +--- +# TraitCollection + +``` swift +public class TraitCollection +``` + +## Initializers + +### `init(traitsFrom:)` + +Creates a trait collection that consists of traits merged from a specified +array of trait collections. + +``` swift +public init(traitsFrom traits: [TraitCollection]) +``` + +This method takes an array of one or more trait collections and merges +them to create a new trait collection. If the array contains more than one +element, the highest-indexed element that contains a given trait is used +for that trait. For example, the following code snippet creates a trait +collection with a compact horizontal size class, because the second +element in the array overrides the first for that trait: + +``` swift +let collection1: TraitCollection = TraitCollection(horizontalSizeClass: .regular) +let collection2: TraitCollection = TraitCollection(horizontalSizeClass: .compact) +let collection3: TraitCollection = TraitCollection(traitsFrom: [collection1, collection2]) +``` + +### `init(userInterfaceIdiom:)` + +Creates a trait collection that contains only a specified interface idiom. + +``` swift +public init(userInterfaceIdiom: UserInterfaceIdiom) +``` + +### `init(horizontalSizeClass:)` + +Creates a trait collection that contains only a specified horizontal size +class. + +``` swift +public init(horizontalSizeClass: UserInterfaceSizeClass) +``` + +### `init(verticalSizeClass:)` + +Creates a trait collection that contains only a specified vertical size +class. + +``` swift +public init(verticalSizeClass: UserInterfaceSizeClass) +``` + +### `init(userInterfaceStyle:)` + +Creates a trait collection that contains only the specified user interface +style trait. + +``` swift +public init(userInterfaceStyle: UserInterfaceStyle) +``` + +### `init(accessibilityContrast:)` + +Creates a trait collection that contains only the specified accessibility +contrast trait. + +``` swift +public init(accessibilityContrast: AccessibilityContrast) +``` + +### `init(userInterfaceLevel:)` + +Creates a trait collection that contains only the specified user interface +level trait. + +``` swift +public init(userInterfaceLevel: UserInterfaceLevel) +``` + +### `init(legibilityWeight:)` + +Creates a trait collection that contains only the specified legibility +weight trait. + +``` swift +public init(legibilityWeight: LegibilityWeight) +``` + +### `init(forceTouchCapability:)` + +Creates a trait collection that contains only a specified force touch +capability trait. + +``` swift +public init(forceTouchCapability: ForceTouchCapability) +``` + +### `init(displayScale:)` + +Creates a trait collection that contains only a specified display scale. + +``` swift +public init(displayScale: Double) +``` + +### `init(displayGamut:)` + +Creates a trait collection that contains only the specified display gamut +trait. + +``` swift +public init(displayGamut: DisplayGamut) +``` + +### `init(layoutDirection:)` + +Creates a trait collection that contains only the specified layout +direction trait. + +``` swift +public init(layoutDirection: TraitEnvironmentLayoutDirection) +``` + +### `init(preferredContentSizeCategory:)` + +Creates a trait collection that contains only the specified content size +category trait. + +``` swift +public init(preferredContentSizeCategory: ContentSizeCategory) +``` + +### `init(activeAppearance:)` + +Creates a trait collection that contains only the specified active +appearance trait. + +``` swift +public init(activeAppearance: UserInterfaceActiveAppearance) +``` + +## Properties + +### `current` + +The complete set of traits for the current environment. + +``` swift +public private(set) static var current: TraitCollection +``` + +The framework updates the value of this property before calling several +well-known methods of `View`, `ViewController`, and +`PresentationController`. The trait collection contains a complete set of +trait values describing the current environment, and does not include +unspecified or unknown values. + +Changing the traits on a nonmain thread does not affect the current traits +on your applications's main thread. + +### `horizontalSizeClass` + +The horizontal size class of the trait collection. + +``` swift +public private(set) var horizontalSizeClass: UserInterfaceSizeClass = + .unspecified +``` + +### `verticalSizeClass` + +The vertical size class of the trait collection. + +``` swift +public private(set) var verticalSizeClass: UserInterfaceSizeClass = + .unspecified +``` + +### `displayScale` + +The display scale of the trait collection. + +``` swift +public private(set) var displayScale: Double = 0.0 +``` + +A value of 1.0 indicates a non-Retina display and a value of 2.0 indicates +a Retina display. The default display scale for a trait collection is 0.0 +(indicating unspecified). + +### `displayGamut` + +The gamut of the current display. + +``` swift +public private(set) var displayGamut: DisplayGamut = .unspecified +``` + +### `userInterfaceStyle` + +The style associated with the user interface. + +``` swift +public private(set) var userInterfaceStyle: UserInterfaceStyle = .unspecified +``` + +Use this trait to determine whether your interface should be configured +with a dark or light appearance. The default value of this trait is set to +the corresponding appearance setting on the user's device. + +### `userInterfaceIdiom` + +The user interface idiom of the trait collection. + +``` swift +public private(set) var userInterfaceIdiom: UserInterfaceIdiom = .unspecified +``` + +The default user interface idiom for a trait collection is +`UserInterfaceIdiom.unspecified`. + +### `userInterfaceLevel` + +The elevation level of the interface. + +``` swift +public private(set) var userInterfaceLevel: UserInterfaceLevel = .unspecified +``` + +Levels create a visual separation between different parts of your UI. +`Window` content typically appears at the `UserInterfaceLevel.base` level. +When you want parts of your UI to stand out from the underlying +background, assign the `UserInterfaceLevel.elevated` level to them. For +example, the system assigns the `UserInterfaceLevel.elevated` level to +alerts and popovers. + +### `layoutDirection` + +The layout direction associated with the current environment. + +``` swift +public private(set) var layoutDirection: TraitEnvironmentLayoutDirection = + .unspecified +``` + +Use this trait to determine whether the underlying environment uses a +left-to-right or right-to-left orientation. + +### `accessibilityContrast` + +The accessibility contrast associated with the current environment. + +``` swift +public private(set) var accessibilityContrast: AccessibilityContrast = + .unspecified +``` + +Use this trait to determine whether the user requested a high contrast +between foreground and background content. The user sets the contrast +level in Accessibility Settings. + +### `legibilityWeight` + +The font weight to apply to text. + +``` swift +public private(set) var legibilityWeight: LegibilityWeight = .unspecified +``` + +The legibility weight reflects the value of the Bold Text display setting. + +### `activeAppearance` + +A property that indicates whether the user interface has an active +appearance. + +``` swift +public private(set) var activeAppearance: UserInterfaceActiveAppearance = + .unspecified +``` + +The active appearance varies according to window activation state. + +### `forceTouchCapability` + +The force touch capability value of the trait collection. + +``` swift +public private(set) var forceTouchCapability: ForceTouchCapability = + .unspecified +``` + +Force Touch is available only on certain devices. On those devices, +availability is determined by the user's associated accessibility setting +in Settings. Check this property's value on app launch, and in your +implementation of the `traitCollectionDidChange(_:)` method. + +If this property does not contain a value, the meaning is equivalent to +the value `ForceTouchCapability.unknown`. + +### `preferredContentSizeCategory` + +The font sizing option preferred by the user. + +``` swift +public private(set) var preferredContentSizeCategory: ContentSizeCategory = + .unspecified +``` + +With dynamic text sizing, users can ask that apps display text using fonts +that are larger or smaller than the normal font size defined by the +system. For example, a user with a visual impairment might request a +larger default font size to make it easier to read text. Use the value of +this property to request a `Font` object that matches the user's requested +size. + +### `imageConfiguration` + +An image configuration object compatible with this trait collection. + +``` swift +public var imageConfiguration: Image.Configuration +``` + +The `Image.Configuration` object in this property contains the same traits +as the current trait collection. + +## Methods + +### `containsTraits(in:)` + +Queries whether a trait collection contains all of another trait +collection's values. + +``` swift +public func containsTraits(in trait: TraitCollection?) -> Bool +``` + +Use this method to compare two standalone trait collections, or to compare +the interface environment's trait collection to a standalone trait +collection. + +### `hasDifferentColorAppearance(comparedTo:)` + +Queries whether changing between the specified and current trait +collections would affect color values. + +``` swift +public func hasDifferentColorAppearance(comparedTo traitCollection: TraitCollection?) + -> Bool +``` + +Use this method to determine whether changing the traits of the current +environment would also change the colors in your interface. For example, +changing the `userInterfaceStyle` or `accessibilityContrast` property +usually changes the colors of your interface. + +### `performAsCurrent(_:)` + +Executes custom code using the traits of the current trait collection. + +``` swift +public func performAsCurrent(_ actions: () -> Void) +``` + +Use this method when you want to execute code using a set of traits that +differ from those in the current trait environment. For example, you might +use this method to draw part of a view's content with a different set of +traits. This method temporarily replaces the traits of the current +environment with the ones found in the current `TraitCollection`. After +the actions block finishes, the method restores the original traits to the +environment. + +You can call this method from any thread of your application. diff --git a/SwiftWin32/TraitEnvironment.md b/SwiftWin32/TraitEnvironment.md new file mode 100644 index 00000000..3f1ee57b --- /dev/null +++ b/SwiftWin32/TraitEnvironment.md @@ -0,0 +1,32 @@ +--- +layout: default +title: TraitEnvironment +parent: SwiftWin32 +--- +# TraitEnvironment + +A set of methods that makes the interface environment available to your +application. + +``` swift +public protocol TraitEnvironment +``` + +## Requirements + +### traitCollection + +The traits, such as the size class and scale factor, that describe the +current environment of the object. + +``` swift +var traitCollection: TraitCollection +``` + +### traitCollectionDidChange(\_:​) + +Called when the interface environment changes. + +``` swift +func traitCollectionDidChange(_ previousTraitCollection: TraitCollection?) +``` diff --git a/SwiftWin32/TraitEnvironmentLayoutDirection.md b/SwiftWin32/TraitEnvironmentLayoutDirection.md new file mode 100644 index 00000000..c557e2fc --- /dev/null +++ b/SwiftWin32/TraitEnvironmentLayoutDirection.md @@ -0,0 +1,43 @@ +--- +layout: default +title: TraitEnvironmentLayoutDirection +parent: SwiftWin32 +--- +# TraitEnvironmentLayoutDirection + +Constants that indicate the layout direction associated with the current +environment. + +``` swift +public enum TraitEnvironmentLayoutDirection: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `unspecified` + +An unknown layout direction. + +``` swift +case unspecified = -1 +``` + +### `leftToRight` + +A left-to-right layout direction. + +``` swift +case leftToRight +``` + +### `rightToLeft` + +A right-to-left layout direction. + +``` swift +case rightToLeft +``` diff --git a/SwiftWin32/Transform3D.md b/SwiftWin32/Transform3D.md new file mode 100644 index 00000000..ade1201f --- /dev/null +++ b/SwiftWin32/Transform3D.md @@ -0,0 +1,43 @@ +--- +layout: default +title: Transform3D +parent: SwiftWin32 +--- +# Transform3D + +The standard transform matrix. + +``` swift +public struct Transform3D +``` + +## Initializers + +### `init()` + +``` swift +public init() +``` + +### `init(m11:m12:m13:m14:m21:m22:m23:m24:m31:m32:m33:m34:m41:m42:m43:m44:)` + +``` swift +public init(m11: Double, m12: Double, m13: Double, m14: Double, + m21: Double, m22: Double, m23: Double, m24: Double, + m31: Double, m32: Double, m33: Double, m34: Double, + m41: Double, m42: Double, m43: Double, m44: Double) +``` + +## Properties + +### `identity` + +The identity transform. +\[1, 0, 0, 0\] +\[0, 1, 0, 0\] +\[0, 0, 1, 0\] +\[0, 0, 0, 1\] + +``` swift +public static var identity: Transform3D +``` diff --git a/SwiftWin32/TransitionContextViewControllerKey.md b/SwiftWin32/TransitionContextViewControllerKey.md new file mode 100644 index 00000000..6826b8e5 --- /dev/null +++ b/SwiftWin32/TransitionContextViewControllerKey.md @@ -0,0 +1,58 @@ +--- +layout: default +title: TransitionContextViewControllerKey +parent: SwiftWin32 +--- +# TransitionContextViewControllerKey + +The keys you use to identify the view controllers involved in a transition. + +``` swift +public struct TransitionContextViewControllerKey: Equatable, Hashable, RawRepresentable +``` + +## Inheritance + +`Equatable`, `Hashable`, `RawRepresentable` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = String +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `from` + +A key that identifies the view controller that is visible at the beginning +of the transition, or at the end of a canceled transition. + +``` swift +public static var from: TransitionContextViewControllerKey +``` + +### `to` + +A key that identifies the view controller that is visible at the end of a +completed transition. + +``` swift +public static var to: TransitionContextViewControllerKey +``` diff --git a/SwiftWin32/TransitionContextViewKey.md b/SwiftWin32/TransitionContextViewKey.md new file mode 100644 index 00000000..dc9974c9 --- /dev/null +++ b/SwiftWin32/TransitionContextViewKey.md @@ -0,0 +1,57 @@ +--- +layout: default +title: TransitionContextViewKey +parent: SwiftWin32 +--- +# TransitionContextViewKey + +The keys you use to identify the views involved in a transition. + +``` swift +public struct TransitionContextViewKey: Equatable, Hashable, RawRepresentable +``` + +## Inheritance + +`Equatable`, `Hashable`, `RawRepresentable` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = String +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `from` + +A key that identifies the view shown at the beginning of the transition, +or at the end of a canceled transition. + +``` swift +public static var from: TransitionContextViewKey +``` + +### `to` + +A key that identifies the view shown at the end of a completed transition. + +``` swift +public static var to: TransitionContextViewKey +``` diff --git a/SwiftWin32/UserInterfaceActiveAppearance.md b/SwiftWin32/UserInterfaceActiveAppearance.md new file mode 100644 index 00000000..03716891 --- /dev/null +++ b/SwiftWin32/UserInterfaceActiveAppearance.md @@ -0,0 +1,42 @@ +--- +layout: default +title: UserInterfaceActiveAppearance +parent: SwiftWin32 +--- +# UserInterfaceActiveAppearance + +Constants that indicate whether the user interface has an active appearance. + +``` swift +public enum UserInterfaceActiveAppearance: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `unspecified` + +The interface has an unspecified appearance. + +``` swift +case unspecified = -1 +``` + +### `inactive` + +The interface has an inactive appearance. + +``` swift +case inactive +``` + +### `active` + +The interface has an active appearance. + +``` swift +case active +``` diff --git a/SwiftWin32/UserInterfaceIdiom.md b/SwiftWin32/UserInterfaceIdiom.md new file mode 100644 index 00000000..745d713f --- /dev/null +++ b/SwiftWin32/UserInterfaceIdiom.md @@ -0,0 +1,96 @@ +--- +layout: default +title: UserInterfaceIdiom +parent: SwiftWin32 +--- +# UserInterfaceIdiom + +Constants that indicate the interface type for the device or an object that +has a trait environment, such as a view and view controller. + +``` swift +public enum UserInterfaceIdiom: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `unspecified` + +An unspecified idiom. + +``` swift +case unspecified = -1 +``` + +### `phone` + +An interface designed for a phone. + +``` swift +case phone +``` + +### `pad` + +``` swift +@available(*, deprecated, renamed: "UserInterfaceIdiom.tablet") + case pad +``` + +### `tv` + +An interface designed for a TV. + +``` swift +case tv +``` + +### `carPlay` + +``` swift +@available(*, deprecated, message: "Use UserInterfaceIdiom.car") + case carPlay +``` + +### `mac` + +``` swift +@available(*, deprecated, renamed: "UserInterfaceIdiom.desktop") + case mac +``` + +### `tablet` + +An interface designed for a tablet. + +``` swift +case tablet +``` + +### `car` + +An interface designed for a car display. + +``` swift +case car +``` + +### `desktop` + +An interface designed for a desktop or laptop. + +``` swift +case desktop +``` + +### `headset` + +An interface designed for a AR/VR device. + +``` swift +case headset +``` diff --git a/SwiftWin32/UserInterfaceLevel.md b/SwiftWin32/UserInterfaceLevel.md new file mode 100644 index 00000000..283a1050 --- /dev/null +++ b/SwiftWin32/UserInterfaceLevel.md @@ -0,0 +1,44 @@ +--- +layout: default +title: UserInterfaceLevel +parent: SwiftWin32 +--- +# UserInterfaceLevel + +Constants that indicate the visual level for content in the window. + +``` swift +public enum UserInterfaceLevel: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `unspecified` + +An unspecified interface level. + +``` swift +case unspecified = -1 +``` + +Choose this option when you want to follow the inherited level. + +### `base` + +The level for your window's main content. + +``` swift +case base +``` + +### `elevated` + +The level for content visually above your window's main content. + +``` swift +case elevated +``` diff --git a/SwiftWin32/UserInterfaceSizeClass.md b/SwiftWin32/UserInterfaceSizeClass.md new file mode 100644 index 00000000..3f4cfc5d --- /dev/null +++ b/SwiftWin32/UserInterfaceSizeClass.md @@ -0,0 +1,42 @@ +--- +layout: default +title: UserInterfaceSizeClass +parent: SwiftWin32 +--- +# UserInterfaceSizeClass + +Constants that indicate the size class of a view. + +``` swift +public enum UserInterfaceSizeClass: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `unspecified` + +Indicates the size class has not been specified. + +``` swift +case unspecified +``` + +### `compact` + +Indicates a compact size class. + +``` swift +case compact +``` + +### `regular` + +Indicates a regular size class. + +``` swift +case regular +``` diff --git a/SwiftWin32/UserInterfaceStyle.md b/SwiftWin32/UserInterfaceStyle.md new file mode 100644 index 00000000..4ec92f6e --- /dev/null +++ b/SwiftWin32/UserInterfaceStyle.md @@ -0,0 +1,42 @@ +--- +layout: default +title: UserInterfaceStyle +parent: SwiftWin32 +--- +# UserInterfaceStyle + +Constants that indicate the interface style for the application. + +``` swift +public enum UserInterfaceStyle: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `unspecified` + +An unspecified interface style. + +``` swift +case unspecified +``` + +### `light` + +The light interface style. + +``` swift +case light +``` + +### `dark` + +The dark interface style. + +``` swift +case dark +``` diff --git a/SwiftWin32/Vector.md b/SwiftWin32/Vector.md new file mode 100644 index 00000000..9135f94c --- /dev/null +++ b/SwiftWin32/Vector.md @@ -0,0 +1,82 @@ +--- +layout: default +title: Vector +parent: SwiftWin32 +--- +# Vector + +A structure that contains a two-dimensional vector. + +``` swift +public struct Vector +``` + +## Inheritance + +`CustomDebugStringConvertible` + +## Initializers + +### `init()` + +Creates a vector whose components are both zero. + +``` swift +public init() +``` + +### `init(dx:dy:)` + +Creates a vector with components specified as floating-point values. + +``` swift +public init(dx: Double, dy: Double) +``` + +### `init(dx:dy:)` + +Creates a vector with components specified as floating-point values. + +``` swift +public init(dx: Float, dy: Float) +``` + +### `init(dx:dy:)` + +Creates a vector with components specified as integer values. + +``` swift +public init(dx: Int, dy: Int) +``` + +## Properties + +### `zero` + +The vector whose components are both zero. + +``` swift +public static var zero: Vector +``` + +### `dx` + +The x component of the vector. + +``` swift +public var dx: Double +``` + +### `dy` + +The y component of the vector. + +``` swift +public var dy: Double +``` + +### `debugDescription` + +``` swift +public var debugDescription: String +``` diff --git a/SwiftWin32/View.md b/SwiftWin32/View.md new file mode 100644 index 00000000..80b38fb1 --- /dev/null +++ b/SwiftWin32/View.md @@ -0,0 +1,659 @@ +--- +layout: default +title: View +parent: SwiftWin32 +--- +# View + +An object that manages the content for a rectangular area on the screen. + +``` swift +public class View: Responder +``` + +## Inheritance + +[`Responder`](https://compnerd.github.io/swift-win32/SwiftWin32/Responder), `Equatable`, [`TraitEnvironment`](https://compnerd.github.io/swift-win32/SwiftWin32/TraitEnvironment) + +## Initializers + +### `init(frame:)` + +Initializes and returns a newly allocated view object with the specified +frame rectangle. + +``` swift +public convenience init(frame: Rect) +``` + +## Properties + +### `backgroundColor` + +The view's background color. + +``` swift +public var backgroundColor: Color? +``` + +### `isHidden` + +A boolean that determines if the view is hidden. + +``` swift +public var isHidden: Bool +``` + +### `isUserInteractionEnabled` + +A boolean value that determines whether user events are ignored and removed +from the event queue. + +``` swift +public var isUserInteractionEnabled: Bool +``` + +### `frame` + +The frame rectangle, which describes the view's location and size in it's +superview's coordinate system. + +``` swift +public var frame: Rect +``` + +### `bounds` + +The bounds rectangle, which describes the view's location and size in its +own coordinate system. + +``` swift +public var bounds: Rect +``` + +### `center` + +The center point of the view's frame rectangle + +``` swift +public var center: Point +``` + +### `transform` + +Specifies the transform applied to the view, relative to the center of its +bounds. + +``` swift +public var transform: AffineTransform = .identity +``` + +### `superview` + +The receiver's superview, or `nil` if it has none. + +``` swift +public private(set) weak var superview: View? +``` + +### `subviews` + +The receiver's immediate subviews. + +``` swift +public private(set) var subviews: [View] = [] +``` + +### `window` + +The receiver's window object, or `nil` if it has none. + +``` swift +public private(set) weak var window: Window? +``` + +### `directionalLayoutMargins` + +The default spacing to use when laying out content in a view, taking into +account the current language direction. + +``` swift +public var directionalLayoutMargins: DirectionalEdgeInsets +``` + +### `preservesSuperviewLayoutMargins` + +A boolean value indicating whether the current view also respects the +margins of its superview. + +``` swift +public var preservesSuperviewLayoutMargins: Bool = false +``` + +### `constraints` + +The constraints held by the view. + +``` swift +public private(set) var constraints: [LayoutConstraint] = [] +``` + +### `bottomAnchor` + +A layout anchor representing the bottom edge of the view's frame. + +``` swift +public var bottomAnchor: LayoutYAxisAnchor +``` + +### `centerXAnchor` + +A layout anchor representing the horizontal center of the view's frame. + +``` swift +public var centerXAnchor: LayoutXAxisAnchor +``` + +### `centerYAnchor` + +A layout anchor representing the vertical center of the view's frame. + +``` swift +public var centerYAnchor: LayoutYAxisAnchor +``` + +### `firstBaselineAnchor` + +A layout anchor representing the baseline for the topmost line of text in +the view. + +``` swift +public var firstBaselineAnchor: LayoutYAxisAnchor +``` + +### `heightAnchor` + +A layout anchor representing the height of the view's frame. + +``` swift +public var heightAnchor: LayoutDimension +``` + +### `lastBaselineAnchor` + +A layout anchor representing the baseline for the bottommost line of text +in the view. + +``` swift +public var lastBaselineAnchor: LayoutYAxisAnchor +``` + +### `leadingAnchor` + +A layout anchor representing the leading edge of the view's frame. + +``` swift +public var leadingAnchor: LayoutXAxisAnchor +``` + +### `leftAnchor` + +A layout anchor representing the left edge of the view's frame. + +``` swift +public var leftAnchor: LayoutXAxisAnchor +``` + +### `rightAnchor` + +A layout anchor representing the right edge of the view's frame. + +``` swift +public var rightAnchor: LayoutXAxisAnchor +``` + +### `topAnchor` + +A layout anchor representing the top edge of the view's frame. + +``` swift +public var topAnchor: LayoutYAxisAnchor +``` + +### `trailingAnchor` + +A layout anchor representing the top edge of the view's frame. + +``` swift +public var trailingAnchor: LayoutXAxisAnchor +``` + +### `widthAnchor` + +A layout anchor representing the trailing edge of the view's frame. + +``` swift +public var widthAnchor: LayoutDimension +``` + +### `contentMode` + +``` swift +public var contentMode: View.ContentMode = .scaleToFill +``` + +### `autoresizesSubviews` + +Determines whether the receiver automatically resizes its subviews when +its bounds changes. + +``` swift +public var autoresizesSubviews: Bool = true +``` + +### `autoresizingMask` + +A bitmask that determines how the receiver resizes itself when its +superview's bounds changes. + +``` swift +public var autoresizingMask: View.AutoresizingMask = .none +``` + +### `contentScaleFactor` + +The scale factor applied to the view. + +``` swift +public var contentScaleFactor: Float +``` + +### `requiresConstraintBasedLayout` + +A boolean value that indicates whether the receiver depends on the +constraint-based layout system. + +``` swift +public class var requiresConstraintBasedLayout: Bool +``` + +Custom views should override this to return true if they cannot layout +correctly using autoresizing. + +### `translatesAutoresizingMaskIntoConstraints` + +A boolean value that determines whether the view's autoresizing mask is +translated into Auto Layout constraints. + +``` swift +public var translatesAutoresizingMaskIntoConstraints: Bool = true +``` + +If this property's value is `true`, the system creates a set of +constraints that duplicate the behavior specified by the view's +autoresizing mask. This also lets you modify the view's size and location +using the view's `frame`, `bounds`, or `center` properties, allowing you +to create a static, frame-based layout within Auto Layout. + +Note that the autoresizing mask constraints fully specify the view's size +and position; therefore, you cannot add additional constraints to modify +this size or position without introducing conflicts. If you want to use +Auto Layout to dynamically calculate the size and position of your view, +you must set this property to `false`, and then provide a non ambiguous, +nonconflicting set of constraints for the view. + +By default, the property is set to `true`. + +### `interactions` + +The array of interactions for the view. + +``` swift +public var interactions: [Interaction] = [] +``` + +### `tag` + +An integer that you can use to identify view objects in your application. + +``` swift +public var tag: Int = 0 +``` + +### `next` + +``` swift +public override var next: Responder? +``` + +### `traitCollection` + +``` swift +public var traitCollection: TraitCollection +``` + +## Methods + +### `addSubview(_:)` + +Add a subview to the end of the reciever's list of subviews. + +``` swift +public func addSubview(_ view: View) +``` + +### `bringSubviewToFront(_:)` + +Moves the specified subview so that it appears on top of its siblings. + +``` swift +public func bringSubviewToFront(_ view: View) +``` + +### `sendSubviewToBack(_:)` + +Moves the specified subview so that it appears behind its siblings. + +``` swift +public func sendSubviewToBack(_ view: View) +``` + +### `removeFromSuperview()` + +Unlinks the view from its superview and its window, and removes it from +the responder chain. + +``` swift +public func removeFromSuperview() +``` + +### `insertSubview(_:at:)` + +Inserts a subview at the specified index. + +``` swift +public func insertSubview(_ view: View, at index: Int) +``` + +### `insertSubview(_:aboveSubview:)` + +Inserts a view above another view in the view hierarchy. + +``` swift +public func insertSubview(_ view: View, aboveSubview subview: View) +``` + +### `insertSubview(_:belowSubview:)` + +Inserts a view below another view in the view hierarchy. + +``` swift +public func insertSubview(_ view: View, belowSubview subview: View) +``` + +### `exchangeSubview(at:withSubviewAt:)` + +Exchanges the subviews at the specified indices. + +``` swift +public func exchangeSubview(at index1: Int, withSubviewAt index2: Int) +``` + +### `isDescendant(of:)` + +Returns a boolean value indicating whether the receiver is a subview of a +given view or identical to that view. + +``` swift +public func isDescendant(of view: View) -> Bool +``` + +### `didAddSubview(_:)` + +Informs the view that a subview was added. + +``` swift +public func didAddSubview(_ subview: View) +``` + +### `willRemoveSubview(_:)` + +Informs the view that a subview is about to be removed. + +``` swift +public func willRemoveSubview(_ subview: View) +``` + +### `willMove(toSuperview:)` + +Informs the view that its superview is about to change to the specified +superview. + +``` swift +public func willMove(toSuperview: View?) +``` + +### `didMoveToSuperview()` + +Informs the view that its superview changed. + +``` swift +public func didMoveToSuperview() +``` + +### `willMove(toWindow:)` + +Informs the view that its window object is about to change. + +``` swift +public func willMove(toWindow: Window?) +``` + +### `didMoveToWindow()` + +Informs the view that its window object changed. + +``` swift +public func didMoveToWindow() +``` + +### `layoutMarginsDidChange()` + +Informs the view that its layout margins changed. + +``` swift +public func layoutMarginsDidChange() +``` + +### `addConstraint(_:)` + +Adds a constraint on the layout of the receiving view or its subviews. + +``` swift +public func addConstraint(_ constraint: LayoutConstraint) +``` + +### `removeConstraint(_:)` + +Removes the specified constraint from the view. + +``` swift +public func removeConstraint(_ constraint: LayoutConstraint) +``` + +### `removeConstraints(_:)` + +Removes the specified constraints from the view. + +``` swift +public func removeConstraints(_ constraints: [LayoutConstraint]) +``` + +### `sizeThatFits(_:)` + +Asks the view to calculate and return the size that best fits the +specified size. + +``` swift +public func sizeThatFits(_ size: Size) -> Size +``` + +### `sizeToFit()` + +Resizes and moves the receiver view so it just encloses its subviews. + +``` swift +public func sizeToFit() +``` + +### `draw(_:)` + +Draws the receiver's image within the passed-in rectangle. + +``` swift +public func draw(_ rect: Rect) +``` + +### `setNeedsDisplay()` + +Mark the receiver's entire bounds rectangle as needing to be redrawn. + +``` swift +public func setNeedsDisplay() +``` + +### `setNeedsDisplay(_:)` + +Marks the specified rectangle of the receiver as needing to be redrawn. + +``` swift +public func setNeedsDisplay(_ rect: Rect) +``` + +### `layoutSubviews()` + +Lays out subviews. + +``` swift +public func layoutSubviews() +``` + +The default implementation uses any constraints you have set to determine +the size and position of any subviews. + +Subclasses can override this method as needed to perform more precise +layout of their subviews. You should override this method only if the +autoresizing and constraint-based behaviors of the subviews do not offer +the behavior you want. You can use your implementation to set the frame +rectangles of your subviews directly. + +You should not call this method directly. If you want to force a layout +update, call the `setNeedsLayout()` method instead to do so prior to the +next drawing update. If you want to update the layout of your views +immediately, call the `layoutIfNeeded()` method. + +### `setNeedsLayout()` + +Invalidates the current layout of the receiver and triggers a layout +update during the next update cycle. + +``` swift +public func setNeedsLayout() +``` + +Call this method on your application's main thread when you want to adjust +the layout of a view's subviews. This method makes a note of the request +and returns immediately. Because this method does not force an immediate +update, but instead waits for the next update cycle, you can use it to +invalidate the layout of multiple views before any of those views are +updated. This behavior allows you to consolidate all of your layout +updates to one update cycle, which is usually better for performance. + +### `layoutIfNeeded()` + +Lays out the subviews immediately, if layout updates are pending. + +``` swift +public func layoutIfNeeded() +``` + +Use this method to force the view to update its layout immediately. When +using Auto Layout, the layout engine updates the position of views as +needed to satisfy changes in constraints. Using the view that receives the +message as the root view, this method lays out the view subtree starting +at the root. If no layout updates are pending, this method exits without +modifying the layout or calling any layout-related callbacks. + +### `addInteraction(_:)` + +Adds an interaction to the view. + +``` swift +public func addInteraction(_ interaction: Interaction) +``` + +### `removeInteraction(_:)` + +Removes an interaction from the view. + +``` swift +public func removeInteraction(_ interaction: Interaction) +``` + +### `viewWithTag(_:)` + +Returns the view whose tag matches the specified value. + +``` swift +public func viewWithTag(_ tag: Int) -> View? +``` + +### `convert(_:to:)` + +Converts a point from the receiver’s coordinate system to that of the +specified view. + +``` swift +public func convert(_ point: Point, to view: View?) -> Point +``` + +### `convert(_:from:)` + +Converts a point from the coordinate system of a given view to that of the +receiver. + +``` swift +public func convert(_ point: Point, from view: View?) -> Point +``` + +### `convert(_:to:)` + +Converts a rectangle from the receiver’s coordinate system to that of +another view. + +``` swift +public func convert(_ rect: Rect, to view: View?) -> Rect +``` + +### `convert(_:from:)` + +Converts a rectangle from the coordinate system of another view to that of +the receiver. + +``` swift +public func convert(_ rect: Rect, from view: View?) -> Rect +``` + +### `traitCollectionDidChange(_:)` + +``` swift +public func traitCollectionDidChange(_ previousTraitCollection: TraitCollection?) +``` + +## Operators + +### `==` + +``` swift +public static func ==(_ lhs: View, _ rhs: View) -> Bool +``` diff --git a/SwiftWin32/ViewAnimating.md b/SwiftWin32/ViewAnimating.md new file mode 100644 index 00000000..d4313926 --- /dev/null +++ b/SwiftWin32/ViewAnimating.md @@ -0,0 +1,87 @@ +--- +layout: default +title: ViewAnimating +parent: SwiftWin32 +--- +# ViewAnimating + +An interface for implementing custom animator objects. + +``` swift +public protocol ViewAnimating +``` + +## Requirements + +### startAnimation() + +Starts the animation from its current position. + +``` swift +func startAnimation() +``` + +### startAnimation(afterDelay:​) + +Starts the animation after the specified delay. + +``` swift +func startAnimation(afterDelay delay: TimeInterval) +``` + +### pauseAnimation() + +Pauses a running animation at its current position. + +``` swift +func pauseAnimation() +``` + +### stopAnimation(\_:​) + +Stops the animations at their current positions. + +``` swift +func stopAnimation(_ withoutFinishing: Bool) +``` + +### finishAnimation(at:​) + +Finishes the animations and returns the animator to the inactive state. + +``` swift +func finishAnimation(at finalPositiong: ViewAnimatingPosition) +``` + +### fractionComplete + +The completion percentage of the animation. + +``` swift +var fractionComplete: Double +``` + +### isReversed + +A boolean value indicating whether the animation is running in the reverse +direction. + +``` swift +var isReversed: Bool +``` + +### state + +The current state of the animation. + +``` swift +var state: ViewAnimatingState +``` + +### isRunning + +A boolean value indicating whether the animation is currently running. + +``` swift +var isRunning: Bool +``` diff --git a/SwiftWin32/ViewAnimatingPosition.md b/SwiftWin32/ViewAnimatingPosition.md new file mode 100644 index 00000000..06803126 --- /dev/null +++ b/SwiftWin32/ViewAnimatingPosition.md @@ -0,0 +1,47 @@ +--- +layout: default +title: ViewAnimatingPosition +parent: SwiftWin32 +--- +# ViewAnimatingPosition + +Constants indicating positions within the animation. + +``` swift +public enum ViewAnimatingPosition: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `end` + +The end point of the animation. Use this constant when you want the final +values for any animatable properties — that is, you want to refer to the +values you specified in your animation blocks. + +``` swift +case end +``` + +### `start` + +The beginning of the animation. Use this constant when you want the +starting values for any animatable properties—that is, the values of the +properties before you applied any animations. + +``` swift +case start +``` + +### `current` + +The current position. Use this constant when you want the most recent +value set by an animator object. + +``` swift +case current +``` diff --git a/SwiftWin32/ViewAnimatingState.md b/SwiftWin32/ViewAnimatingState.md new file mode 100644 index 00000000..bb290f24 --- /dev/null +++ b/SwiftWin32/ViewAnimatingState.md @@ -0,0 +1,49 @@ +--- +layout: default +title: ViewAnimatingState +parent: SwiftWin32 +--- +# ViewAnimatingState + +Constants indicating the current state of the animation. + +``` swift +public enum ViewAnimatingState: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `inactive` + +The animations have not yet started executing. This is the initial state +of the animator object. + +``` swift +case inactive +``` + +### `active` + +The animator object is active and animations are either running or paused. +An animator moves to this state after the first call to `startAnimation()` +or `pauseAnimation()`. It stays in the active state until the animations +finish naturally or until you call the `stopAnimation(_:​)` method. + +``` swift +case active +``` + +### `stopped` + +The animation is stopped. Putting an animation into this state ends the +animation and leaves any animatable properties at their current values, +instead of updating them to their intended final values. An animation +cannot be started while in this state. + +``` swift +case stopped +``` diff --git a/SwiftWin32/ViewConfigurationState.md b/SwiftWin32/ViewConfigurationState.md new file mode 100644 index 00000000..c548b785 --- /dev/null +++ b/SwiftWin32/ViewConfigurationState.md @@ -0,0 +1,102 @@ +--- +layout: default +title: ViewConfigurationState +parent: SwiftWin32 +--- +# ViewConfigurationState + +A structure that encapsulates a view's state. + +``` swift +public struct ViewConfigurationState: ConfigurationState +``` + +## Inheritance + +[`ConfigurationState`](https://compnerd.github.io/swift-win32/SwiftWin32/ConfigurationState), `CustomDebugStringConvertible`, `CustomReflectable`, `CustomStringConvertible`, `Hashable` + +## Initializers + +### `init(traitCollection:)` + +``` swift +public init(traitCollection: TraitCollection) +``` + +## Properties + +### `traitCollection` + +The traits that describe the current layout environment of the view, such +as the user interface style and layout direction. + +``` swift +public var traitCollection: TraitCollection +``` + +### `isSelected` + +A boolean value that indicates whether the view is in a selected state. + +``` swift +public var isSelected: Bool +``` + +### `isHighlighted` + +A boolean value that indicates whether the view is in a highlighted state. + +``` swift +public var isHighlighted: Bool +``` + +### `isFocused` + +A boolean value that indicates whether the view is in a focused state. + +``` swift +public var isFocused: Bool +``` + +### `isDisabled` + +A boolean value that indicates whether the view is in a disabled state. + +``` swift +public var isDisabled: Bool +``` + +### `description` + +``` swift +public var description: String +``` + +### `debugDescription` + +``` swift +public var debugDescription: String +``` + +### `customMirror` + +``` swift +public var customMirror: Mirror +``` + +## Methods + +### `hash(into:)` + +``` swift +public func hash(into hasher: inout Hasher) +``` + +## Operators + +### `==` + +``` swift +public static func ==(_ lhs: ViewConfigurationState, + _ rhs: ViewConfigurationState) -> Bool +``` diff --git a/SwiftWin32/ViewController.md b/SwiftWin32/ViewController.md new file mode 100644 index 00000000..3afb83a9 --- /dev/null +++ b/SwiftWin32/ViewController.md @@ -0,0 +1,1170 @@ +--- +layout: default +title: ViewController +parent: SwiftWin32 +--- +# ViewController + +An object that manages a view hierarchy for your application. + +``` swift +public class ViewController: Responder +``` + +## Inheritance + +[`Responder`](https://compnerd.github.io/swift-win32/SwiftWin32/Responder), [`TraitEnvironment`](https://compnerd.github.io/swift-win32/SwiftWin32/TraitEnvironment), [`ContentContainer`](https://compnerd.github.io/swift-win32/SwiftWin32/ContentContainer), `Equatable` + +## Initializers + +### `init()` + +``` swift +override public init() +``` + +## Properties + +### `view` + +The view that the controller manages. + +``` swift +public var view: View! +``` + +This property represents the root view of the view controller's view +hierarchy. The default value of this property is `nil`. + +If you access this property when its value is `nil`, the view controller +automatically calls the `loadView()` method and returns the resulting +view. + +Each view controller is the sole owner of its view object. Don't associate +the same view object with multiple view controllers. The only exception is +that a container view controller implementation may add another view +controller's view object to its own view hierarchy. Before adding the +subview, the container must first call its `addChild(_:)` method to create +a parent-child relationship between the two view controller objects. + +Because accessing this property can cause the view to be loaded +automatically, you can use `isViewLoaded` to determine if the view is +currently in memory. Unlike this property, `isViewLoaded` doesn't force +the loading of the view if it's not currently in memory. + +### `viewIfLoaded` + +The controller's view or `nil` if the view is not yet loaded. + +``` swift +public private(set) var viewIfLoaded: View? +``` + +If the view controller's view has already been loaded, this property +contains that view. If the view has not yet been loaded, this property is +set to `nil`. + +### `isViewLoaded` + +Indicates if the view is loaded into memory. + +``` swift +public var isViewLoaded: Bool +``` + +The value of this property is `true` when the view is in memory or `false` +when it is not. Accessing this property does not attempt to load the view +if it is not currently in memory. + +### `title` + +A localized string that represents the view this controller manages. + +``` swift +public var title: String? +``` + +Set the title to a human-readable string that describes the view. If the +view controller has a valid navigation item or tab-bar item, assigning a +value to this property updates the title text of those objects. + +### `preferredContentSize` + +The preferred size for the view controller's view. + +``` swift +public var preferredContentSize: Size +``` + +The value in this property is used primarily when displaying the view +controller's content in a popover but may also be used in other +situations. Changing the value of this property while the view controller +is being displayed in a popover animates the size change; however, the +change is not animated if you specify a width or height of 0.0. + +### `isBeingDismissed` + +A boolean value indicating whether the view controller is being dismissed. + +``` swift +public private(set) var isBeingDismissed: Bool = false +``` + +### `isBeingPresented` + +A boolean value indicating whether the view controller is being presented. + +``` swift +public private(set) var isBeingPresented: Bool = false +``` + +### `isMovingFromParent` + +A boolean value indicating whether the view controller is being removed +from a parent view controller. + +``` swift +public private(set) var isMovingFromParent: Bool = false +``` + +### `isMovingToParent` + +A boolean value indicating whether the view controller is being moved to a +parent view controller. + +``` swift +public private(set) var isMovingToParent: Bool = false +``` + +### `additionalSafeAreaInsets` + +The inset distances for views. + +``` swift +public var additionalSafeAreaInsets: EdgeInsets = .zero +``` + +Use this property to adjust the safe area insets of this view controller's +views by the specified amount. The safe area defines the portion of your +view controller's visible area that is guaranteed to be unobscured by the +system status bar or by an ancestor-provided view such as the navigation +bar. + +You might use this property to extend the safe area to include custom +content in your interface. For example, a drawing app might use this +property to avoid displaying content underneath tool palettes. + +### `viewRespectsSystemMinimumLayoutMargins` + +A boolean value indicating whether the view controller's view uses the +system-defined minimum layout margins. + +``` swift +public var viewRespectsSystemMinimumLayoutMargins: Bool = true +``` + +When the value of this property is `true`, the root view's layout margins +are guaranteed to be no smaller than the values in the +`systemMinimumLayoutMargins` property. The default value of this property +is `true`. + +Changing this property to `false` causes the view to obtain its margins +solely from its `directionalLayoutMargins` property. Setting the margins +in that property to 0 allows you to eliminate the view's margins +altogether. + +### `systemMinimumLayoutMargins` + +The minimum layout margins for the view controller's root view. + +``` swift +public private(set) var systemMinimumLayoutMargins: DirectionalEdgeInsets = .zero +``` + +This property contains the minimum layout margins expected by the system +for the view controller's root view. Do not override this property. To +stop considering the system's minimum layout margins for the root view, +set the `viewRespectsSystemMinimumLayoutMargins` property to `false`. This +property does not affect the margins associated with subviews of the root +view. + +If you assign a custom value to the `directionalLayoutMargins` property of +the view controller's root view, the root view's actual margins are set to +either your custom values or the minimum values defined by this property, +whichever values are greater. For example, if the value for one system +minimum margin is 20 points and you specify a value of 10 for the same +margin on the view, the view uses the value 20 for the margin. + +### `edgesForExtendedLayout` + +The edges that you extend for your view controller. + +``` swift +public var edgesForExtendedLayout: RectEdge = .all +``` + +Instead of this property, use the safe area of your view to determine +which parts of your interface are occluded by other content. For more +information, see the `safeAreaLayoutGuide` and `safeAreaInsets` properties +of `View`. + +The default value of this property is `.all`, and it is recommended that +you do not change that value. + +If you remove an edge value from this property, the system does not lay +out your content underneath other bars on that same edge. In addition, the +system provides a default background so that translucent bars have an +appropriate appearance. The window’s root view controller does not react +to this property. + +### `extendedLayoutIncludesOpaqueBars` + +A boolean value indicating whether or not the extended layout includes +opaque bars. + +``` swift +public var extendedLayoutIncludesOpaqueBars: Bool = false +``` + +The default value of this property is `false`. + +### `shouldAutorotate` + +A boolean value that indicates whether the view controller's contents +should autorotate. + +``` swift +public private(set) var shouldAutorotate: Bool = true +``` + +### `supportedInterfaceOrientations` + +The interface orientations that the view controller supports. + +``` swift +public private(set) var supportedInterfaceOrientations: InterfaceOrientationMask = .allButUpsideDown +``` + +This property returns a bit mask that specifies which orientations the +view controller supports. For more information, see +`InterfaceOrientationMask`. + +When the device orientation changes, the system calls this method on the +root view controller or the topmost modal view controller that fills the +window. If the view controller supports the new orientation, the system +rotates the window and the view controller. The system only calls this +method if the view controller's `shouldAutorotate` method returns `true`. + +Override this method to declare which orientations the view controller +supports. The default value is `.all`. The value you return must not be 0. + +To determine whether to rotate, the system compares the view controller's +supported orientations with the app's supported orientations — as +determined by the `Info.plist` file or the app delegate's +`application(_:supportedInterfaceOrientationsFor:)` method — and the +device's supported orientations. + +If your app supports multitasking, the system doesn't call this method on +your view controller because multitasking apps must support all +orientations. You can opt out of multitasking by enablin by not declaring +support for all possible orientations within the `Info.plist` file. + +### `preferredInterfaceOrientationForPresentation` + +The interface orientation to use when presenting the view controller. + +``` swift +public private(set) var preferredInterfaceOrientationForPresentation: InterfaceOrientation = .portrait +``` + +The system calls this method when presenting the view controller full +screen. When your view controller supports two or more orientations but +the content appears best in one of those orientations, override this +method and return the preferred orientation. + +If your view controller implements this method, your view controller's +view is shown in the preferred orientation (although it can later be +rotated to another supported rotation). If you do not implement this +method, the system presents the view controller using the current +orientation of the status bar. + +### `modalPresentationStyle` + +The presentation style for modal view controllers. + +``` swift +public var modalPresentationStyle: ModalPresentationStyle = .automatic +``` + +Presentation style defines how the system presents a modal view +controller. The system uses this value only in regular-width size classes. +In compact-width size classes, some styles take on the behavior of other +styles. You can influence this behavior by implementing the +`adaptivePresentationStyle(for:traitCollection:)` method. + +Presentation style also impacts the content size of a modal view +controller. For example, `ModalPresentationStyle.pageSheet` uses an +explicit size that the system provides. By contrast, +`ModalPresentationStyle.formSheet` uses the view controller's +`preferredContentSize` property, which you can set. + +The default value is `ModalPresentationStyle.automatic`. For a list of +presentation styles and their compatibility with the various transition +styles, see `ModalPresentationStyle`. + +### `modalTransitionStyle` + +The transition style to use when presenting the view controller. + +``` swift +public var modalTransitionStyle: ModalTransitionStyle = .coverVertical +``` + +This property determines how the view controller's is animated onscreen +when it is presented using the `present(_:animated:completion:)` method. +To change the transition type, you must set this property before +presenting the view controller. The default value for this property is +`ModalTransitionStyle.coverVertical`. + +For a list of possible transition styles, and their compatibility with the +available presentation styles, see the `ModalTransitionStyle` constant +descriptions. + +### `isModalInPresentation` + +A boolean value indicating whether the view controller enforces a modal +behavior. + +``` swift +public var isModalInPresentation: Bool = false +``` + +The default value of this property is `false`. When you set it to `true`, +the framework ignores events outside the view controller's bounds and +prevents the interactive dismissal of the view controller while it is +onscreen. + +### `definesPresentationContext` + +A boolean value that indicates whether this view controller's view is +covered when the view controller or one of its descendants presents a view +controller. + +``` swift +public var definesPresentationContext: Bool = false +``` + +When using the `ModalPresentationStyle.currentContext` or +`ModalPresentationStyle.overCurrentContext` style to present a view +controller, this property controls which existing view controller in your +view controller hierarchy is actually covered by the new content. When a +context-based presentation occurs, the framework starts at the presenting +view controller and walks up the view controller hierarchy. If it finds a +view controller whose value for this property is `true`, it asks that view +controller to present the new view controller. If no view controller +defines the presentation context, the framework asks the window's root +view controller to handle the presentation. + +The default value for this property is `false`. Some system-provided view +controllers, such as `NavigationController`, change the default value to +`true`. + +### `providesPresentationContextTransitionStyle` + +A boolean value that indicates whether the view controller specifies the +transition style for view controllers it presents. + +``` swift +public var providesPresentationContextTransitionStyle: Bool = false +``` + +When a view controller's `definesPresentationContext` property is `true`, +it can replace the transition style of the presented view controller with +its own. When the value of this property to `true`, the current view +controller's transition style is used instead of the style associated with +the presented view controller. When the value of this property is `false`, +the framework uses the transition style of the presented view controller. +The default value of this property is `false`. + +### `showDetailTargetDidChangeNotification` + +Posted when a split view controller is expanded or collapsed. + +``` swift +public class var showDetailTargetDidChangeNotification: NSNotification.Name +``` + +When a view controller is using `show(_:sender:)` or +`showDetailViewController(_:sender:)`, it may need to know when a split +view controller higher in the view hierarchy has changed. This +notification is sent when a split view controller expands or collapses. +The object of this notification is the view controller that caused the +change. + +### `transitioningDelegate` + +The delegate object that provides transition animator, interactive +controller, and custom presentation controller objects. + +``` swift +public weak var transitioningDelegate: ViewControllerTransitioningDelegate? +``` + +When the view controller's `modalPresentationStyle` property is +`ModalPresentationStyle.custom`, the framework uses the object in this +property to facilitate transitions and presentations for the view +controller. The transitioning delegate object is a custom object that you +provide and that conforms to the `ViewControllerTransitioningDelegate` +protocol. Its job is to vend the animator objects used to animate this +view controller's view onscreen and an optional presentation controller +to provide any additional chrome and animations. + +### `transitionCoordinator` + +Returns the active transition coordinator object. + +``` swift +public private(set) var transitionCoordinator: ViewControllerTransitionCoordinator? +``` + +When a presentation or dismissal is in progress, this method returns the +transition coordinator object associated with that transition. If there is +no in-progress transition associated with the current view controller, +the framework checks the view controller's ancestors for a transition +coordinator object and returns that object if it exists. You can use this +object to create additional animations and synchronize them with the +transition animations. + +Container view controllers can override this method but in most cases +should not need to. If you do override this method, first call `super` to +see if there is an appropriate transition coordinator to return, and, if +there is, return it. + +For more information about the role of transition coordinators, see +`ViewControllerTransitionCoordinator`. + +### `presentationController` + +The presentation controller that's managing the current view controller. + +``` swift +public private(set) var presentationController: PresentationController? +``` + +If the view controller is managed by a presentation controller, this +property contains that object. This property is `nil` if the view +controller isn't managed by a presentation controller. + +If you've not yet presented the current view controller, accessing this +property creates a presentation controller based on the current value in +the `modalPresentationStyle` property. Always set the value of that +property before accessing any presentation controllers. + +### `popoverPresentationController` + +
+
false
+
+ +``` swift +public private(set) var popoverPresentationController: PopoverPresentationController? +``` + +
+
+ +### `restoresFocusAfterTransition` + +A boolean value that indicates whether an item that previously was focused +should again become focused when the item's view controller becomes +visible and focusable. + +``` swift +public var restoresFocusAfterTransition: Bool = true +``` + +When the value of this property is true, the item that was last focused +automatically becomes focused when its view controller becomes visible and +focusable. For example, if an item in the view controller is focused and a +second view controller is presented, the original item becomes focused +again when the second view controller is dismissed. The default value of +this property is `true`. + +### `children` + +An array of view controllers that are children of the current view +controller. + +``` swift +public private(set) var children: [ViewController] = [] +``` + +This property does not include any presented view controllers. This +property is only intended to be read by an implementation of a custom +container view controller. + +### `shouldAutomaticallyForwardAppearanceMethods` + +Returns a boolean value indicating whether appearance methods are +forwarded to child view controllers. + +``` swift +public private(set) var shouldAutomaticallyForwardAppearanceMethods: Bool = true +``` + +This method is called to determine whether to automatically forward +appearance-related containment callbacks to child view controllers. + +The default implementation returns true. Subclasses of the `ViewController` +class that implement containment logic may override this method to control +how these methods are forwarded. If you override this method and return +`false`, you are responsible for telling the child when its views are going +to appear or disappear. You do this by calling the child view controller's +`beginAppearanceTransition(_:animated:)` and `endAppearanceTransition()` +methods. + +### `hierarchyInconsistencyException` + +Raised if the view controller hierarchy is inconsistent with the view +hierarchy. + +``` swift +public class var hierarchyInconsistencyException: NSExceptionName +``` + +When a view controller's view is added to the view hierarchy, the system +walks up the view hierarchy to find the first parent view that has a view +controller. That view controller must be the parent of the view controller +whose view is being added. Otherwise, this exception is raised. This +consistency check is also performed when a view controller is added as a +child by calling the `addChild(_:)` method. + +It is also allowed for a view controller that has no parent to add its +view to the view hierarchy. This is generally not recommended, but is +useful in some special cases. + +### `presentingViewController` + +The view controller that presented this view controller. + +``` swift +public private(set) var presentingViewController: ViewController? +``` + +When you present a view controller modally (either explicitly or +implicitly) using the `present(_:animated:completion:)` method, the view +controller that was presented has this property set to the view controller +that presented it. If the view controller was not presented modally, but +one of its ancestors was, this property contains the view controller that +presented the ancestor. If neither the current view controller or any of +its ancestors were presented modally, the value in this property is `nil`. + +### `presentedViewController` + +The view controller that presented this view controller. + +``` swift +public private(set) var presentedViewController: ViewController? +``` + +When you present a view controller modally (either explicitly or +implicitly) using the `present(_:animated:completion:)` method, the view +controller that called the method has this property set to the view +controller that it presented. If the current view controller did not +present another view controller modally, the value in this property is +`nil`. + +### `parent` + +The view controller that presented this view controller. + +``` swift +public private(set) var parent: ViewController? +``` + +If the recipient is a child of a container view controller, this property +holds the view controller it is contained in. If the recipient has no +parent, the value in this property is `nil`. + +Use the `presentingViewController` property to access the presenting view +controller. + +### `next` + +``` swift +override public var next: Responder? +``` + +### `traitCollection` + +``` swift +public var traitCollection: TraitCollection +``` + +## Methods + +### `loadView()` + +Creates the view that the controller manages. + +``` swift +public func loadView() +``` + +You should never call this method directly. The view controller calls this +method when its view property is requested but is currently `nil`. This +method loads or creates a view and assigns it to the view property. + +You can override this method in order to create your views manually. If +you choose to do so, assign the root view of your view hierarchy to the +view property. The views you create should be unique instances and should +not be shared with any other view controller object. Your custom +implementation of this method should not call `super`. + +If you want to perform any additional initialization of your views, do so +in the `viewDidLoad()` method. + +### `viewDidLoad()` + +Called after the controller's view is loaded info memory. + +``` swift +public func viewDidLoad() +``` + +This method is called after the view controller has loaded its view +hierarchy into memory. + +### `loadViewIfNeeded()` + +Loads the controller's view if it has not yet been loaded. + +``` swift +public func loadViewIfNeeded() +``` + +Calling this method loads the view controller's, creating the view as +needed based on the established rules. + +### `viewWillAppear(_:)` + +Notifies the view controller that its view is about to be added to a view +hierarchy. + +``` swift +public func viewWillAppear(_ animated: Bool) +``` + +This method is called before the view controller's view is about to be +added to a view hierarchy and before any animations are configured for +showing the view. You can override this method to perform custom tasks +associated with displaying the view. For example, you might use this +method to change the orientation or style of the status bar to coordinate +with the orientation or style of the view being presented. If you override +this method, you must call `super` at some point in your implementation. + +### `viewDidAppear(_:)` + +Notifies the view controller that its view was added to a view hierarchy. + +``` swift +public func viewDidAppear(_ animated: Bool) +``` + +You can override this method to perform additional tasks associated with +presenting the view. If you override this method, you must call `super` at +some point in your implementation. + + - Note + If a view controller is presented by a view controller inside of a + popover, this method is not invoked on the presenting view controller + after the presented controller is dismissed. + +### `viewWillDisappear(_:)` + +Notifies the view controller that its view is about to be removed from a +view hierarchy. + +``` swift +public func viewWillDisappear(_ animated: Bool) +``` + +This method is called in response to a view being removed from a view +hierarchy. This method is called before the view is actually removed and +before any animations are configured. + +Subclasses can override this method and use it to commit editing changes, +resign the first responder status of the view, or perform other relevant +tasks. For example, you might use this method to revert changes to the +orientation or style of the status bar that were made in the +`viewDidAppear(_:)` method when the view was first presented. If you +override this method, you must call `super` at some point in your +implementation. + +### `viewDidDisappear(_:)` + +Notifies the view controller that its view was removed from a view +hierarchy. + +``` swift +public func viewDidDisappear(_ animated: Bool) +``` + +You can override this method to perform additional tasks associated with +dismissing or hiding the view. If you override this method, you must call +`super` at some point in your implementation. + +### `viewSafeAreaInsetsDidChange()` + +Notifies the view controller that the safe area insets of its root view +changed. + +``` swift +public func viewSafeAreaInsetsDidChange() +``` + +Use this method to update your interface to accommodate the new safe area. +The framework updates the safe area in response to size changes to system +bars or when you modify the additional safe area insets of your view +controller. The framework also calls this method immediately before your +view appears onscreen. + +### `viewLayoutMarginsDidChange()` + +Notifies the view controller that the layout margins of its root view +changed. + +``` swift +public func viewLayoutMarginsDidChange() +``` + +Use this method to update the position of content based on the new margin +values. + +### `viewWillLayoutSubviews()` + +Notifies the view controller that its view is about to layout its +subviews. + +``` swift +public func viewWillLayoutSubviews() +``` + +When a view's bounds change, the view adjusts the position of its +subviews. Your view controller can override this method to make changes +before the view lays out its subviews. The default implementation of this +method does nothing. + +### `viewDidLayoutSubviews()` + +Notifes the view controller that its view has just laid out its subviews. + +``` swift +public func viewDidLayoutSubviews() +``` + +When the bounds change for a view controller's view, the view adjusts the +positions of its subviews and then the system calls this method. However, +this method being called does not indicate that the individual layouts of +the view's subviews have been adjusted. Each subview is responsible for +adjusting its own layout. + +Your view controller can override this method to make changes after the +view lays out its subviews. The default implementation of this method does +nothing. + +### `updateViewConstraints()` + +Called when the view controller's view needs to update its constraints. + +``` swift +public func updateViewConstraints() +``` + +Override this method to optimize changes to your constraints. + + - Note + It is almost always cleaner and easier to update a constraint + immediately after the affecting change has occurred. For example, if you + want to change a constraint in response to a button tap, make that + change directly in the button's action method. + + You should only override this method when changing constraints in place + is too slow, or when a view is producing a number of redundant changes. + +To schedule a change, call `setNeedsUpdateConstraints()` on the view. The +system then calls your implementation of `updateViewConstraints()` before +the layout occurs. This lets you verify that all necessary constraints for +your content are in place at a time when your properties are not changing. + +Your implementation must be as efficient as possible. Do not deactivate +all your constraints, then reactivate the ones you need. Instead, your app +must have some way of tracking your constraints, and validating them +during each update pass. Only change items that need to be changed. During +each update pass, you must ensure that you have the appropriate +constraints for the app’s current state. + +Do not call `setNeedsUpdateConstraints()` inside your implementation. +Calling `setNeedsUpdateConstraints()` schedules another update pass, +creating a feedback loop. + + - Important + Call `super.updateViewConstraints()` as the final step in your + implementation. + +### `attemptRotationToDeviceOrientation()` + +Attempts to rotate all windows to the orientation of the device. + +``` swift +public class func attemptRotationToDeviceOrientation() +``` + +Some view controllers may want to use app-specific conditions to determine +what interface orientations are supported. If your view controller does +this, when those conditions change, your app should call this class +method. The system immediately attempts to rotate to the new orientation. + +### `show(_:sender:)` + +Presents a view controller in a primary context. + +``` swift +public func show(_ viewController: ViewController, sender: Any?) +``` + +You use this method to decouple the need to display a view controller from +the process of actually presenting that view controller onscreen. Using +this method, a view controller does not need to know whether it is +embedded inside a navigation controller or split-view controller. It calls +the same method for both. The `SplitViewController` and +`NavigationController` classes override this method and handle the +presentation according to their design. For example, a navigation +controller overrides this method and uses it to push a view controller +onto its navigation stack. + +The default implementation of this method calls the +`targetViewController(forAction:sender:)` method to locate an object in +the view controller hierarchy that overrides this method. It then calls +the method on that target object, which displays the view controller in an +appropriate way. If the `targetViewController(forAction:sender:)` method +returns `nil`, this method uses the window's root view controller to +present the view controller modally. + +You can override this method in custom view controllers to display the +view controller yourself. Use this method to display the view controller +in a primary context. For example, a container view controller might use +this method to replace its primary child. Your implementation should adapt +its behavior for both regular and compact environments. + +### `showDetailViewController(_:sender:)` + +Presents a view controller in a secondary (or detail) context. + +``` swift +public func showDetailViewController(_ viewController: ViewController, + sender: Any?) +``` + +You use this method to decouple the need to display a view controller from +the process of actually presenting that view controller onscreen. Using +this method, a view controller does not need to know whether it is +embedded inside a navigation controller or split-view controller. It calls +the same method for both. In a regular environment, the +`SplitViewController` class overrides this method and installs the view +controller as its detail view controller; in a compact environment, the +split view controller's implementation of this method calls +`show(_:sender:)` instead. + +The default implementation of this method calls the +`targetViewController(forAction:sender:)` method to locate an object in +the view controller hierarchy that overrides this method. It then calls +the method on that target object, which displays the view controller in an +appropriate way. If the `targetViewController(forAction:sender:)` method +returns `nil`, this method uses the window's root view controller to +present the view controller modally. + +You can override this method in custom view controllers to display the +view controller yourself. Use this method to display the view controller +in a secondary context. For example, a container view controller might use +this method to replace its secondary child. Your implementation should +adapt its behavior for both regular and compact environments. + +### `present(_:animated:completion:)` + +Presents a view controller modally. + +``` swift +public func present(_ viewController: ViewController, animated flag: Bool, + completion: (() -> Void)? = nil) +``` + +In a horizontally regular environment, the view controller is presented in +the style specified by the `modalPresentationStyle` property. In a +horizontally compact environment, the view controller is presented full +screen by default. If you associate an adaptive delegate with the +presentation controller associated with the object in +`viewControllerToPresent`, you can modify the presentation style +dynamically. + +The object on which you call this method may not always be the one that +handles the presentation. Each presentation style has different rules +governing its behavior. For example, a full-screen presentation must be +made by a view controller that itself covers the entire screen. If the +current view controller is unable to fulfill a request, it forwards the +request up the view controller hierarchy to its nearest parent, which can +then handle or forward the request. + +Before displaying the view controller, this method resizes the presented +view controller's view based on the presentation style. For most +presentation styles, the resulting view is then animated onscreen using +the transition style in the `modalTransitionStyle` property of the +presented view controller. For custom presentations, the view is animated +onscreen using the presented view controller's transitioning delegate. For +current context presentations, the view may be animated onscreen using the +current view controller's transition style. + +The completion handler is called after the `viewDidAppear(_:)` method is +called on the presented view controller. + +### `dismiss(animated:completion:)` + +Dismisses the view controller that was presented modally by the view +controller. + +``` swift +public func dismiss(animated flag: Bool, completion: (() -> Void)? = nil) +``` + +The presenting view controller is responsible for dismissing the view +controller it presented. If you call this method on the presented view +controller itself, the framework asks the presenting view controller to +handle the dismissal. + +If you present several view controllers in succession, thus building a +stack of presented view controllers, calling this method on a view +controller lower in the stack dismisses its immediate child view +controller and all view controllers above that child on the stack. When +this happens, only the top-most view is dismissed in an animated fashion; +any intermediate view controllers are simply removed from the stack. +The top-most view is dismissed using its modal transition style, which may +differ from the styles used by other view controllers lower in the stack. + +If you want to retain a reference to the view controller's presented view +controller, get the value in the `presentedViewController` property before +calling this method. + +The completion handler is called after the `viewDidDisappear(_:)` method +is called on the presented view controller. + +### `targetViewController(forAction:sender:)` + +Returns the view controller that responds to the action. + +``` swift +public func targetViewController(forAction action: (Target) -> () -> Void, + sender: Any?) -> ViewController? +``` + +This method returns the current view controller if that view controller +overrides the method indicated by the action parameter. If the current +view controller does not override that method, the framework walks up the +view hierarchy and returns the first view controller that does override +it. If no view controller handles the action, this method returns `nil`. + +A view controller can selectively respond to an action by returning an +appropriate value from its `canPerformAction(_:withSender:)` method. + +### `targetViewController(forAction:sender:)` + +``` swift +public func targetViewController(forAction action: (Target) -> (_: Any?) -> Void, + sender: Any?) -> ViewController? +``` + +### `willMove(toParent:)` + +Called just before the view controller is added or removed from a +container view controller. + +``` swift +public func willMove(toParent viewController: ViewController?) +``` + +### `didMove(toParent:)` + +Called after the view controller is added or removed from a container view +controller. + +``` swift +public func didMove(toParent viewController: ViewController?) +``` + +### `addChild(_:)` + +Adds the specified view controller as a child of the current view +controller. + +``` swift +public func addChild(_ controller: ViewController) +``` + +This method creates a parent-child relationship between the current view +controller and the object in the childController parameter. This +relationship is necessary when embedding the child view controller's view +into the current view controller's content. If the new child view +controller is already the child of a container view controller, it is +removed from that container before being added. + +This method is only intended to be called by an implementation of a custom +container view controller. If you override this method, you must call +`super` in your implementation. + +### `removeFromParent()` + +Removes the view controller from its parent. + +``` swift +public func removeFromParent() +``` + +This method is only intended to be called by an implementation of a custom +container view controller. If you override this method, you must call +`super` in your implementation. + +### `transition(from:to:duration:options:animations:completion:)` + +Transitions between two of the view controller's child view controllers. + +``` swift +public func transition(from source: ViewController, + to destination: ViewController, duration: TimeInterval, + options: View.AnimationOptions = [], + animations: (() -> Void)?, + completion: ((Bool) -> Void)? = nil) +``` + +This method adds the second view controller's view to the view hierarchy +and then performs the animations defined in your animations block. After +the animation completes, it removes the first view controller's view from +the view hierarchy. + +This method is only intended to be called by an implementation of a custom +container view controller. If you override this method, you must call +`super` in your implementation. + +### `beginAppearanceTransition(_:animated:)` + +Tells a child controller its appearance is about to change. + +``` swift +public func beginAppearanceTransition(_ isAppearing: Bool, animated: Bool) +``` + +If you are implementing a custom container controller, use this method to +tell the child that its views are about to appear or disappear. Do not +invoke `viewWillAppear(_:)`, `viewWillDisappear(_:)`, `viewDidAppear(_:)`, +or `viewDidDisappear(_:)` directly. + +### `endAppearanceTransition()` + +Tells a child controller its appearance has changed. + +``` swift +public func endAppearanceTransition() +``` + +If you are implementing a custom container controller, use this method to +tell the child that the view transition is complete. + +### `setOverrideTraitCollection(_:forChild:)` + +Changes the traits assigned to the specified child view controller. + +``` swift +public func setOverrideTraitCollection(_ collection: TraitCollection?, + forChild childViewController: ViewController) +``` + +Usually, traits are passed unmodified from the parent view controller to +its child view controllers. When implementing a custom container view +controller, you can use this method to change the traits of any embedded +child view controllers to something more appropriate for your layout. +Making such a change alters other view controller behaviors associated +with that child. For example, modal presentations behave differently in a +horizontally compact versus horizontally regular environment. You might +also make such a change to force the same set of traits on the child view +controller regardless of the actual trait environment. + +### `overrideTraitCollection(forChild:)` + +Retrieves the trait collection for a child view controller. + +``` swift +public func overrideTraitCollection(forChild childViewController: ViewController) + -> TraitCollection? +``` + +Use this method to retrieve the trait collection for a child view +controller. You can then modify the trait collection for the designated +child view controller and set it using the +`setOverrideTraitCollection(_:forChild:)` method. + +### `willTransition(to:with:)` + +Notifies the container that the size of its view is about to change. + +``` swift +public func willTransition(to: Size, + with coodinator: ViewControllerTransitionCoordinator) +``` + +### `willTransition(to:with:)` + +Notifies the container that its trait collection changed. + +``` swift +public func willTransition(to: TraitCollection, + with coordinator: ViewControllerTransitionCoordinator) +``` + +### `size(forChildContentContainer:withParentContainerSize:)` + +Returns the size of the specified child view controller’s content. + +``` swift +public func size(forChildContentContainer container: ContentContainer, + withParentContainerSize parentSize: Size) -> Size +``` + +### `preferredContentSizeDidChange(forChildContentContainer:)` + +Notifies an interested controller that the preferred content size of one +of its children changed. + +``` swift +public func preferredContentSizeDidChange(forChildContentContainer container: ContentContainer) +``` + +### `systemLayoutFittingSizeDidChange(forChildContentContainer:)` + +Notifies the container that a child view controller was resized using auto +layout. + +``` swift +public func systemLayoutFittingSizeDidChange(forChildContentContainer container: ContentContainer) +``` + +### `traitCollectionDidChange(_:)` + +``` swift +public func traitCollectionDidChange(_ previousTraitCollection: TraitCollection?) +``` + +## Operators + +### `==` + +``` swift +public static func ==(_ lhs: ViewController, _ rhs: ViewController) -> Bool +``` diff --git a/SwiftWin32/ViewControllerAnimatedTransitioning.md b/SwiftWin32/ViewControllerAnimatedTransitioning.md new file mode 100644 index 00000000..fadabdc0 --- /dev/null +++ b/SwiftWin32/ViewControllerAnimatedTransitioning.md @@ -0,0 +1,58 @@ +--- +layout: default +title: ViewControllerAnimatedTransitioning +parent: SwiftWin32 +--- +# ViewControllerAnimatedTransitioning + +A set of methods for implementing the animations for a custom view controller +transition. + +``` swift +public protocol ViewControllerAnimatedTransitioning +``` + +## Default Implementations + +### `animationEnded(_:)` + +``` swift +public func animationEnded(_ transitionCompleted: Bool) +``` + +## Requirements + +### animateTransition(using:​) + +Tells your animator object to perform the transition animations. + +``` swift +func animateTransition(using transitionContext: ViewControllerContextTransitioning) +``` + +### animationEnded(\_:​) + +Tells your animator object that the transition animations have finished. + +``` swift +func animationEnded(_ transitionCompleted: Bool) +``` + +### transitionDuration(using:​) + +Asks your animator object for the duration (in seconds) of the transition +animation. + +``` swift +func transitionDuration(using transitionContext: ViewControllerContextTransitioning?) + -> TimeInterval +``` + +### interruptibleAnimator(using:​) + +Returns the interruptible animator to use during the transition. + +``` swift +func interruptibleAnimator(using transitionContext: ViewControllerContextTransitioning) + -> ViewImplicitlyAnimating +``` diff --git a/SwiftWin32/ViewControllerContextTransitioning.md b/SwiftWin32/ViewControllerContextTransitioning.md new file mode 100644 index 00000000..656e7e3d --- /dev/null +++ b/SwiftWin32/ViewControllerContextTransitioning.md @@ -0,0 +1,142 @@ +--- +layout: default +title: ViewControllerContextTransitioning +parent: SwiftWin32 +--- +# ViewControllerContextTransitioning + +A set of methods that provide contextual information for transition +animations between view controllers. + +``` swift +public protocol ViewControllerContextTransitioning +``` + +## Requirements + +### containerView + +The view that acts as the superview for the views involved in the +transition. + +``` swift +var containerView: View +``` + +### viewController(forKey:​) + +Returns a view controller involved in the transition. + +``` swift +func viewController(forKey key: TransitionContextViewControllerKey) + -> ViewController? +``` + +### view(forKey:​) + +Returns the specified view involved in the transition. + +``` swift +func view(forKey key: TransitionContextViewKey) -> View? +``` + +### initialFrame(for:​) + +Returns the starting frame rectangle for the specified view controller's +view. + +``` swift +func initialFrame(for viewController: ViewController) -> Rect +``` + +### finalFrame(for:​) + +Returns the ending frame rectangle for the specified view controller's +view. + +``` swift +func finalFrame(for viewController: ViewController) -> Rect +``` + +### isAnimated + +A boolean value indicating whether the transition should be animated. + +``` swift +var isAnimated: Bool +``` + +### isInteractive + +A boolean value indicating whether the transition is currently +interactive. + +``` swift +var isInteractive: Bool +``` + +### presentationStyle + +Returns the presentation style for the view controller transition. + +``` swift +var presentationStyle: ModalPresentationStyle +``` + +### completeTransition(\_:​) + +Notifies the system that the transition animation is done. + +``` swift +func completeTransition(_ didComplete: Bool) +``` + +### updateInteractiveTransition(\_:​) + +Updates the completion percentage of the transition. + +``` swift +func updateInteractiveTransition(_ percentComplete: Double) +``` + +### pauseInteractiveTransition() + +Tells the system to pause the animations. + +``` swift +func pauseInteractiveTransition() +``` + +### finishInteractiveTransition() + +Notifies the system that user interactions signaled the completion of the +transition. + +``` swift +func finishInteractiveTransition() +``` + +### cancelInteractiveTransition() + +Notifies the system that user interactions canceled the transition. + +``` swift +func cancelInteractiveTransition() +``` + +### transitionWasCancelled + +Returns a boolean value indicating whether the transition was canceled. + +``` swift +var transitionWasCancelled: Bool +``` + +### targetTransform + +Returns a transform indicating the amount of rotation being applied during +the transition. + +``` swift +var targetTransform: AffineTransform +``` diff --git a/SwiftWin32/ViewControllerInteractiveTransitioning.md b/SwiftWin32/ViewControllerInteractiveTransitioning.md new file mode 100644 index 00000000..15fefc33 --- /dev/null +++ b/SwiftWin32/ViewControllerInteractiveTransitioning.md @@ -0,0 +1,78 @@ +--- +layout: default +title: ViewControllerInteractiveTransitioning +parent: SwiftWin32 +--- +# ViewControllerInteractiveTransitioning + +A set of methods that enable an object (such as a navigation controller) to +drive a view controller transition. + +``` swift +public protocol ViewControllerInteractiveTransitioning +``` + +## Default Implementations + +### `wantsInteractiveStart` + +``` swift +public var wantsInteractiveStart: Bool +``` + +### `completionCurve` + +``` swift +public var completionCurve: View.AnimationCurve +``` + +### `completionSpeed` + +``` swift +public var completionSpeed: Double +``` + +## Requirements + +### startInteractiveTransition(\_:​) + +Called when the system needs to set up the interactive portions of a view +controller transition and start the animations. + +``` swift +func startInteractiveTransition(_ transitionContext: ViewControllerContextTransitioning) +``` + +### wantsInteractiveStart + +A boolean value indicating whether the transition is interactive when it +starts. + +``` swift +var wantsInteractiveStart: Bool +``` + +The value of this property is `true` when the transition is interactive +from the moment it starts. The property is `false` when the transition +starts off as noninteractive. However, even a transition that starts off +as noninteractive may become interactive later if it implements the +`interruptibleAnimator(using:)` method of the +`ViewControllerAnimatedTransitioning` protocol. + +### completionCurve + +Called when the system needs the animation completion curve for an +interactive view controller transition. + +``` swift +var completionCurve: View.AnimationCurve +``` + +### completionSpeed + +Called when the system needs the speed at which to complete an interactive +transition, after the interactive portion is finished. + +``` swift +var completionSpeed: Double +``` diff --git a/SwiftWin32/ViewControllerTransitionCoordinator.md b/SwiftWin32/ViewControllerTransitionCoordinator.md new file mode 100644 index 00000000..06267832 --- /dev/null +++ b/SwiftWin32/ViewControllerTransitionCoordinator.md @@ -0,0 +1,41 @@ +--- +layout: default +title: ViewControllerTransitionCoordinator +parent: SwiftWin32 +--- +# ViewControllerTransitionCoordinator + +``` swift +public protocol ViewControllerTransitionCoordinator: ViewControllerTransitionCoordinatorContext +``` + +## Inheritance + +[`ViewControllerTransitionCoordinatorContext`](https://compnerd.github.io/swift-win32/SwiftWin32/ViewControllerTransitionCoordinatorContext) + +## Requirements + +### animate(alongsideTransition:​completion:​) + +Responding to View Controller Transition Progress + +``` swift +func animate(alongsideTransition animation: ((ViewControllerTransitionCoordinatorContext) -> Void)?, + completion: ((ViewControllerTransitionCoordinatorContext) -> Void)?) + -> Bool +``` + +### animateAlongsideTransition(in:​animation:​completion:​) + +``` swift +func animateAlongsideTransition(in view: View?, + animation: ((ViewControllerTransitionCoordinatorContext) -> Void)?, + completion: ((ViewControllerTransitionCoordinatorContext) -> Void)?) + -> Bool +``` + +### notifyWhenInteractionChanges(\_:​) + +``` swift +func notifyWhenInteractionChanges(_ handler: @escaping (ViewControllerTransitionCoordinatorContext) -> Void) +``` diff --git a/SwiftWin32/ViewControllerTransitionCoordinatorContext.md b/SwiftWin32/ViewControllerTransitionCoordinatorContext.md new file mode 100644 index 00000000..62a1caf6 --- /dev/null +++ b/SwiftWin32/ViewControllerTransitionCoordinatorContext.md @@ -0,0 +1,132 @@ +--- +layout: default +title: ViewControllerTransitionCoordinatorContext +parent: SwiftWin32 +--- +# ViewControllerTransitionCoordinatorContext + +A set of methods that provides information about an in-progress view +controller transition. + +``` swift +public protocol ViewControllerTransitionCoordinatorContext +``` + +## Requirements + +### viewController(forKey:​) + +Returns the view controllers involved in the transition. + +``` swift +func viewController(forKey key: TransitionContextViewControllerKey) + -> ViewController? +``` + +### view(forKey:​) + +Returns the specified view involved in the transition. + +``` swift +func view(forKey key: TransitionContextViewKey) -> View? +``` + +### containerView + +Returns the view in which the transition takes place. + +``` swift +var containerView: View +``` + +### presentationStyle + +Returns the presentation style being used for the transition. + +``` swift +var presentationStyle: ModalPresentationStyle +``` + +### transitionDuration + +Returns the noninteractive duration of a transition. + +``` swift +var transitionDuration: TimeInterval +``` + +### completionCurve + +Returns the completion curve associated with the transition. + +``` swift +var completionCurve: View.AnimationCurve +``` + +### completionVelocity + +Returns the starting velocity to use for any final animations. + +``` swift +var completionVelocity: Double +``` + +### percentComplete + +Returns the percentage of completion for an interactive transition when it +moves to its noninteractive phase. + +``` swift +var percentComplete: Double +``` + +### initiallyInteractive + +A Boolean value indicating whether the transition started as an +interactive transition. + +``` swift +var initiallyInteractive: Bool +``` + +### isInteractive + +A Boolean value indicating whether the transition is currently interactive. + +``` swift +var isInteractive: Bool +``` + +### isAnimated + +A Boolean value indicating whether the transition is explicitly animated. + +``` swift +var isAnimated: Bool +``` + +### isCancelled + +A Boolean value indicating whether an interactive transition was cancelled. + +``` swift +var isCancelled: Bool +``` + +### isInterruptible + +A Boolean value indicating whether the transition animations can be +interrupted. + +``` swift +var isInterruptible: Bool +``` + +### targetTransform + +Returns a transform indicating the amount of rotation being applied during +the transition. + +``` swift +var targetTransform: AffineTransform +``` diff --git a/SwiftWin32/ViewControllerTransitioningDelegate.md b/SwiftWin32/ViewControllerTransitioningDelegate.md new file mode 100644 index 00000000..911a07bb --- /dev/null +++ b/SwiftWin32/ViewControllerTransitioningDelegate.md @@ -0,0 +1,112 @@ +--- +layout: default +title: ViewControllerTransitioningDelegate +parent: SwiftWin32 +--- +# ViewControllerTransitioningDelegate + +A set of methods that vend objects used to manage a fixed-length or +interactive transition between view controllers. + +``` swift +public protocol ViewControllerTransitioningDelegate: AnyObject +``` + +## Inheritance + +`AnyObject` + +## Default Implementations + +### `animationController(forPresented:presenting:source:)` + +``` swift +public func animationController(forPresented presented: ViewController, + presenting: ViewController, source: ViewController) + -> ViewControllerAnimatedTransitioning? +``` + +### `animationController(forDismissed:)` + +``` swift +public func animationController(forDismissed dismissed: ViewController) + -> ViewControllerAnimatedTransitioning? +``` + +### `interactionControllerForPresentation(using:)` + +``` swift +public func interactionControllerForPresentation(using animator: ViewControllerAnimatedTransitioning) + -> ViewControllerInteractiveTransitioning? +``` + +### `interactionControllerForDismissal(using:)` + +``` swift +public func interactionControllerForDismissal(using animator: ViewControllerAnimatedTransitioning) + -> ViewControllerInteractiveTransitioning? +``` + +### `presentationController(forPresented:presenting:source:)` + +``` swift +public func presentationController(forPresented presented: ViewController, + presenting: ViewController?, + source: ViewController) + -> PresentationController? +``` + +## Requirements + +### animationController(forPresented:​presenting:​source:​) + +Asks your delegate for the transition animator object to use when +presenting a view controller. + +``` swift +func animationController(forPresented presented: ViewController, + presenting: ViewController, source: ViewController) + -> ViewControllerAnimatedTransitioning? +``` + +### animationController(forDismissed:​) + +Asks your delegate for the transition animator object to use when +dismissing a view controller. + +``` swift +func animationController(forDismissed dismissed: ViewController) + -> ViewControllerAnimatedTransitioning? +``` + +### interactionControllerForPresentation(using:​) + +Asks your delegate for the interactive animator object to use when +presenting a view controller. + +``` swift +func interactionControllerForPresentation(using animator: ViewControllerAnimatedTransitioning) + -> ViewControllerInteractiveTransitioning? +``` + +### interactionControllerForDismissal(using:​) + +Asks your delegate for the interactive animator object to use when +dismissing a view controller. + +``` swift +func interactionControllerForDismissal(using animator: ViewControllerAnimatedTransitioning) + -> ViewControllerInteractiveTransitioning? +``` + +### presentationController(forPresented:​presenting:​source:​) + +Asks your delegate for the custom presentation controller to use for +managing the view hierarchy when presenting a view controller. + +``` swift +func presentationController(forPresented presented: ViewController, + presenting: ViewController?, + source: ViewController) + -> PresentationController? +``` diff --git a/SwiftWin32/ViewImplicitlyAnimating.md b/SwiftWin32/ViewImplicitlyAnimating.md new file mode 100644 index 00000000..3dc4c8fe --- /dev/null +++ b/SwiftWin32/ViewImplicitlyAnimating.md @@ -0,0 +1,79 @@ +--- +layout: default +title: ViewImplicitlyAnimating +parent: SwiftWin32 +--- +# ViewImplicitlyAnimating + +An interface for modifying an animation while it is running. + +``` swift +public protocol ViewImplicitlyAnimating: ViewAnimating +``` + +## Inheritance + +[`ViewAnimating`](https://compnerd.github.io/swift-win32/SwiftWin32/ViewAnimating) + +## Default Implementations + +### `addAnimations(_:)` + +``` swift +public func addAnimations(_ animation: @escaping () -> Void) +``` + +### `addAnimations(_:delayFactor:)` + +``` swift +public func addAnimations(_ animation: @escaping () -> Void, + delayFactor: Double) +``` + +### `addCompletion(_:)` + +``` swift +public func addCompletion(_ completion: @escaping (ViewAnimatingPosition) -> Void) +``` + +### `continueAnimation(withTimingParameters:durationFactor:)` + +``` swift +public func continueAnimation(withTimingParameters paramters: TimingCurveProvider?, + durationFactor: Double) +``` + +## Requirements + +### addAnimations(\_:​) + +Adds the specified animation block to the animator. + +``` swift +func addAnimations(_ animation: @escaping () -> Void) +``` + +### addAnimations(\_:​delayFactor:​) + +Adds the specified animation block to the animator with a delay. + +``` swift +func addAnimations(_ animation: @escaping () -> Void, delayFactor: Double) +``` + +### addCompletion(\_:​) + +Adds the specified completion block to the animator. + +``` swift +func addCompletion(_ completion: @escaping (ViewAnimatingPosition) -> Void) +``` + +### continueAnimation(withTimingParameters:​durationFactor:​) + +Adjusts the final timing and duration of a paused animation. + +``` swift +func continueAnimation(withTimingParameters paramters: TimingCurveProvider?, + durationFactor: Double) +``` diff --git a/SwiftWin32/View_AnimationCurve.md b/SwiftWin32/View_AnimationCurve.md new file mode 100644 index 00000000..f0390149 --- /dev/null +++ b/SwiftWin32/View_AnimationCurve.md @@ -0,0 +1,55 @@ +--- +layout: default +title: View.AnimationCurve +parent: SwiftWin32 +--- +# View.AnimationCurve + +Specifies the supported animation curves. + +``` swift +public enum AnimationCurve: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `easeInOut` + +An ease-in ease-out curve causes the animation to begin slowly, +accelerate through the middle of its duration, and then slow again +before completing. This is the default curve for most animations. + +``` swift +case easeInOut +``` + +### `easeIn` + +An ease-in curve causes the animation to begin slowly, and then speed up +as it progresses. + +``` swift +case easeIn +``` + +### `easeOut` + +An ease-out curve causes the animation to begin quickly, and then slow +down as it completes. + +``` swift +case easeOut +``` + +### `linear` + +A linear animation curve causes an animation to occur evenly over its +duration. + +``` swift +case linear +``` diff --git a/SwiftWin32/View_AnimationOptions.md b/SwiftWin32/View_AnimationOptions.md new file mode 100644 index 00000000..66c5367a --- /dev/null +++ b/SwiftWin32/View_AnimationOptions.md @@ -0,0 +1,254 @@ +--- +layout: default +title: View.AnimationOptions +parent: SwiftWin32 +--- +# View.AnimationOptions + +Options for animating views using block objects. + +``` swift +public struct AnimationOptions: OptionSet +``` + +## Inheritance + +`OptionSet` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = UInt +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `layoutSubviews` + +Lay out subviews at commit time so that they are animated along with their +parent. + +``` swift +public static var layoutSubviews: View.AnimationOptions +``` + +### `allowUserInteraction` + +Allow the user to interact with views while they are being animated. + +``` swift +public static var allowUserInteraction: View.AnimationOptions +``` + +### `beginFromCurrentState` + +Start the animation from the current setting associated with an already +in-flight animation. + +``` swift +public static var beginFromCurrentState: View.AnimationOptions +``` + +If this key is not present, all in-flight animations are allowed to finish +before the new animation is started. If another animation is not in +flight, this key has no effect. + +### `` `repeat` `` + +Repeat the animation indefinitely. + +``` swift +public static var `repeat`: View.AnimationOptions +``` + +### `autoreverse` + +Run the animation backwards and forwards (must be combined with the repeat +option). + +``` swift +public static var autoreverse: View.AnimationOptions +``` + +### `overrideInheritedDuration` + +Force the animation to use the original duration value specified when the +animation was submitted. + +``` swift +public static var overrideInheritedDuration: View.AnimationOptions +``` + +### `overrideInheritedCurve` + +Force the animation to use the original curve value specified when the +animation was submitted. + +``` swift +public static var overrideInheritedCurve: View.AnimationOptions +``` + +If this key is not present, the animation inherits the curve of the +in-flight animation, if any. + +### `allowAnimatedContent` + +Animate the views by changing the property values dynamically and +redrawing the view. + +``` swift +public static var allowAnimatedContent: View.AnimationOptions +``` + +### `showHideTransitionViews` + +Hide or show views during a view transition. + +``` swift +public static var showHideTransitionViews: View.AnimationOptions +``` + +When present, this key causes views to be hidden or shown (instead of +removed or added) when performing a view transition. Both views must +already be present in the parent view's hierarchy when using this key. If +this key is not present, the to-view in a transition is added to, and the +from-view is removed from, the parent view's list of subviews. + +### `overrideInheritedOptions` + +The option to not inherit the animation type or any options. + +``` swift +public static var overrideInheritedOptions: View.AnimationOptions +``` + +### `curveEaseInOut` + +Specify an ease-in ease-out curve, which causes the animation to begin +slowly, accelerate through the middle of its duration, and then slow again +before completing. + +``` swift +public static var curveEaseInOut: View.AnimationOptions +``` + +### `curveEaseIn` + +An ease-in curve causes the animation to begin slowly, and then speed up +as it progresses. + +``` swift +public static var curveEaseIn: View.AnimationOptions +``` + +### `curveEaseOut` + +An ease-out curve causes the animation to begin quickly, and then slow as +it completes. + +``` swift +public static var curveEaseOut: View.AnimationOptions +``` + +### `curveLinear` + +A linear animation curve causes an animation to occur evenly over its +duration. + +``` swift +public static var curveLinear: View.AnimationOptions +``` + +### `transitionFlipFromLeft` + +A transition that flips a view around its vertical axis from left to right +(the left side of the view moves toward the front and right side toward +the back). + +``` swift +public static var transitionFlipFromLeft: View.AnimationOptions +``` + +### `transitionFlipFromRight` + +A transition that flips a view around its vertical axis from right to left +(the right side of the view moves toward the front and left side toward +the back). + +``` swift +public static var transitionFlipFromRight: View.AnimationOptions +``` + +### `transitionCurlUp` + +A transition that curls a view up from the bottom. + +``` swift +public static var transitionCurlUp: View.AnimationOptions +``` + +### `transitionCurlDown` + +A transition that curls a view down from the top. + +``` swift +public static var transitionCurlDown: View.AnimationOptions +``` + +### `transitionCrossDissolve` + +A transition that dissolves from one view to the next. + +``` swift +public static var transitionCrossDissolve: View.AnimationOptions +``` + +### `transitionFlipFromTop` + +A transition that flips a view around its horizontal axis from top to +bottom (the top side of the view moves toward the front and the bottom +side toward the back). + +``` swift +public static var transitionFlipFromTop: View.AnimationOptions +``` + +### `preferredFramesPerSecond30` + +A frame rate of 30 frames per second. + +``` swift +public static var preferredFramesPerSecond30: View.AnimationOptions +``` + +Specify this value to request a preferred frame rate. It's recommended +that you use the default value unless you have identified a specific need +for an explicit rate. + +### `preferredFramesPerSecond60` + +A frame rate of 60 frames per second. + +``` swift +public static var preferredFramesPerSecond60: View.AnimationOptions +``` + +Specify this value to request a preferred frame rate. It's recommended +that you use the default value unless you have identified a specific need +for an explicit rate. diff --git a/SwiftWin32/View_AutoresizingMask.md b/SwiftWin32/View_AutoresizingMask.md new file mode 100644 index 00000000..e91e528d --- /dev/null +++ b/SwiftWin32/View_AutoresizingMask.md @@ -0,0 +1,90 @@ +--- +layout: default +title: View.AutoresizingMask +parent: SwiftWin32 +--- +# View.AutoresizingMask + +Options for automatic view resizing. + +``` swift +public struct AutoresizingMask: OptionSet +``` + +## Inheritance + +`OptionSet` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: UInt) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: UInt +``` + +### `none` + +``` swift +public static var none: View.AutoresizingMask +``` + +### `flexibleLeftMargin` + +Resizing performed by expanding or shrinking a view in the direction of +the left margin. + +``` swift +public static var flexibleLeftMargin: View.AutoresizingMask +``` + +### `flexibleWidth` + +Resizing performed by expanding or shrinking a view's width. + +``` swift +public static var flexibleWidth: View.AutoresizingMask +``` + +### `flexibleRightMargin` + +Resizing performed by expanding or shrinking a view in the direction of +the right margin. + +``` swift +public static var flexibleRightMargin: View.AutoresizingMask +``` + +### `flexibleTopMargin` + +Resizing performed by expanding or shrinking a view in the direction of +the top margin. + +``` swift +public static var flexibleTopMargin: View.AutoresizingMask +``` + +### `flexibleHeight` + +Resizing performed by expanding or shrinking a view's height. + +``` swift +public static var flexibleHeight: View.AutoresizingMask +``` + +### `flexibleBottomMargin` + +Resizing performed by expanding or shrinking a view in the direction of +the bottom margin. + +``` swift +public static var flexibleBottomMargin: View.AutoresizingMask +``` diff --git a/SwiftWin32/View_ContentMode.md b/SwiftWin32/View_ContentMode.md new file mode 100644 index 00000000..9d213e49 --- /dev/null +++ b/SwiftWin32/View_ContentMode.md @@ -0,0 +1,118 @@ +--- +layout: default +title: View.ContentMode +parent: SwiftWin32 +--- +# View.ContentMode + +Options to specify how a view adjusts its content when its size changes. + +``` swift +public enum ContentMode: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `scaleToFill` + +Scale the content to fit the size of itself by changing the aspect ratio +of the content if necessary. + +``` swift +case scaleToFill +``` + +### `scaleAspectFill` + +Scale the content to fit the size of the view by maintaining the aspect +ratio. Any remaining area of the view's bounds is transparent. + +``` swift +case scaleAspectFill +``` + +### `redraw` + +Scale the content to fill the size of the view. Some portion of the +content may be clipped to fill the view's bounds. + +``` swift +case redraw +``` + +### `center` + +center the content in the view's bounds, keeping the proportions the +same. + +``` swift +case center +``` + +### `top` + +Center the content aligned to the top in the view's bounds. + +``` swift +case top +``` + +### `bottom` + +Center the content aligned at the bottom in the view's bounds. + +``` swift +case bottom +``` + +### `left` + +Align the content on the left of the view. + +``` swift +case left +``` + +### `right` + +Align the content on the right of the view. + +``` swift +case right +``` + +### `topLeft` + +Align the content in the top-left corner of the view. + +``` swift +case topLeft +``` + +### `topRight` + +Align the content in the top-right corner of the view. + +``` swift +case topRight +``` + +### `bottomLeft` + +Align the content in the bottom-left corner of the view. + +``` swift +case bottomLeft +``` + +### `bottomRight` + +Align the content in the bottom-right corner of the view. + +``` swift +case bottomRight +``` diff --git a/SwiftWin32/View_TintAdjustmentMode.md b/SwiftWin32/View_TintAdjustmentMode.md new file mode 100644 index 00000000..c938d1fa --- /dev/null +++ b/SwiftWin32/View_TintAdjustmentMode.md @@ -0,0 +1,46 @@ +--- +layout: default +title: View.TintAdjustmentMode +parent: SwiftWin32 +--- +# View.TintAdjustmentMode + +The tint adjustment mode for the view. + +``` swift +public enum TintAdjustmentMode: Int +``` + +## Inheritance + +`Int` + +## Enumeration Cases + +### `automatic` + +The tint adjustment mode of the view is the same as its superview's tint +adjustment mode (or `ViewTintAdjustmentModeNormal` if the view has no +superview). + +``` swift +case automatic +``` + +### `normal` + +The view's tintColor property returns the completely unmodified tint +color of the view. + +``` swift +case normal +``` + +### `dimmed` + +The view's `tintColor` property returns a desaturated, dimmed version +of the view's original tint color. + +``` swift +case dimmed +``` diff --git a/SwiftWin32/VisualEffect.md b/SwiftWin32/VisualEffect.md new file mode 100644 index 00000000..b9f89673 --- /dev/null +++ b/SwiftWin32/VisualEffect.md @@ -0,0 +1,12 @@ +--- +layout: default +title: VisualEffect +parent: SwiftWin32 +--- +# VisualEffect + +An initializer for visual effect views and blur and vibrancy effect objects. + +``` swift +public class VisualEffect +``` diff --git a/SwiftWin32/Window.md b/SwiftWin32/Window.md new file mode 100644 index 00000000..618013f4 --- /dev/null +++ b/SwiftWin32/Window.md @@ -0,0 +1,175 @@ +--- +layout: default +title: Window +parent: SwiftWin32 +--- +# Window + +The backdrop for your application’s user interface and the object that +dispatches events to your views. + +``` swift +public class Window: View +``` + +## Inheritance + +[`View`](https://compnerd.github.io/swift-win32/SwiftWin32/View) + +## Initializers + +### `init(frame:)` + +``` swift +public init(frame: Rect) +``` + +### `init(windowScene:)` + +Creates a Window and associates it with the specified scene object. + +``` swift +public init(windowScene: WindowScene) +``` + +## Properties + +### `rootViewController` + +The root view controller for the window. + +``` swift +public var rootViewController: ViewController? +``` + +### `windowLevel` + +The position of the window in the z-axis. + +``` swift +public var windowLevel: Window.Level = .normal +``` + +### `screen` + +The screen on which the window is displayed. + +``` swift +@available(*, deprecated, message: "use windowScene.scene") + public var screen: Screen +``` + +### `canResizeToFitContent` + +A boolean value that indicates whether the window's constraint-based +content determines its size. + +``` swift +public var canResizeToFitContent: Bool = false +``` + +### `isKeyWindow` + +A boolean value that indicates whether the window is the key window for +the application. + +``` swift +public var isKeyWindow: Bool +``` + +### `canBecomeKey` + +A boolean value that indicates whether the window can become the key +window. + +``` swift +public var canBecomeKey: Bool = true +``` + +### `windowScene` + +The scene containing the window. + +``` swift +public weak var windowScene: WindowScene? +``` + +### `didBecomeVisibleNotification` + +Posted whn a `Window` object becomes visible. + +``` swift +public class var didBecomeVisibleNotification: NSNotification.Name +``` + +### `didBecomeHiddenNotification` + +Posted when a `Window` object becomes hidden. + +``` swift +public class var didBecomeHiddenNotification: NSNotification.Name +``` + +### `didBecomeKeyNotification` + +Posted whenever a `Window` object becomes the key window. + +``` swift +public class var didBecomeKeyNotification: NSNotification.Name +``` + +### `didResignKeyNotification` + +Posted when a `Window` object resigns its status as main window. + +``` swift +public class var didResignKeyNotification: NSNotification.Name +``` + +### `next` + +``` swift +override public var next: Responder? +``` + +### `isMinimizable` + +``` swift +public var isMinimizable: Bool +``` + +## Methods + +### `makeKeyAndVisible()` + +Shows the window and makes it the key window. + +``` swift +public func makeKeyAndVisible() +``` + +### `makeKey()` + +Makes the receiver the key window. + +``` swift +public func makeKey() +``` + +### `becomeKey()` + +Called automatically to inform the window that it has become the key +window. + +``` swift +public func becomeKey() +``` + +### `resignKey()` + +Called automatically to inform the window that it is no longer the key +window. + +``` swift +public func resignKey() +``` diff --git a/SwiftWin32/WindowScene.md b/SwiftWin32/WindowScene.md new file mode 100644 index 00000000..365858d8 --- /dev/null +++ b/SwiftWin32/WindowScene.md @@ -0,0 +1,51 @@ +--- +layout: default +title: WindowScene +parent: SwiftWin32 +--- +# WindowScene + +``` swift +public class WindowScene: Scene +``` + +## Inheritance + +[`Scene`](https://compnerd.github.io/swift-win32/SwiftWin32/Scene) + +## Initializers + +### `init(session:connectionOptions:)` + +``` swift +public required init(session: SceneSession, + connectionOptions: Scene.ConnectionOptions) +``` + +## Properties + +### `windows` + +Getting the Active Windows +The windows associated with the scene. + +``` swift +public internal(set) var windows: [Window] = [] +``` + +### `screen` + +The screen that displays the content of the scene. + +``` swift +public private(set) var screen: Screen +``` + +### `sizeRestrictions` + +Getting the Interface Attributes +The minimum and maximum size of the application's windows. + +``` swift +public private(set) var sizeRestrictions: SceneSizeRestrictions? +``` diff --git a/SwiftWin32/WindowSceneDelegate.md b/SwiftWin32/WindowSceneDelegate.md new file mode 100644 index 00000000..b8e6b935 --- /dev/null +++ b/SwiftWin32/WindowSceneDelegate.md @@ -0,0 +1,55 @@ +--- +layout: default +title: WindowSceneDelegate +parent: SwiftWin32 +--- +# WindowSceneDelegate + +Additional methods that you can use to manage application specific tasks +occurring in a scene. + +``` swift +public protocol WindowSceneDelegate: SceneDelegate +``` + +## Inheritance + +[`SceneDelegate`](https://compnerd.github.io/swift-win32/SwiftWin32/SceneDelegate) + +## Default Implementations + +### `window` + +``` swift +public var window: Window? +``` + +### `windowScene(_:didUpdate:interfaceOrientation:traitCollection:)` + +``` swift +public func windowScene(_ windowScene: WindowScene, + didUpdate previousCoordinateSpace: CoordinateSpace, + interfaceOrientation previousInterfaceOrientation: InterfaceOrientation, + traitCollection previousTraitCollection: TraitCollection) +``` + +## Requirements + +### window + +The main window associated with the scene. + +``` swift +var window: Window? +``` + +### windowScene(\_:​didUpdate:​interfaceOrientation:​traitCollection:​) + +Notifies you when the size, orientation, or traits of a scene change. + +``` swift +func windowScene(_ windowScene: WindowScene, + didUpdate previousCoordinateSpace: CoordinateSpace, + interfaceOrientation previousInterfaceOrientation: InterfaceOrientation, + traitCollection previousTraitCollection: TraitCollection) +``` diff --git a/SwiftWin32/Window_Level.md b/SwiftWin32/Window_Level.md new file mode 100644 index 00000000..3b9d3e93 --- /dev/null +++ b/SwiftWin32/Window_Level.md @@ -0,0 +1,64 @@ +--- +layout: default +title: Window.Level +parent: SwiftWin32 +--- +# Window.Level + +The positioning of windows relative to each other. + +``` swift +public struct Level: Equatable, Hashable, RawRepresentable +``` + +## Inheritance + +`Equatable`, `Hashable`, `RawRepresentable` + +## Nested Type Aliases + +### `RawValue` + +``` swift +public typealias RawValue = Double +``` + +## Initializers + +### `init(rawValue:)` + +``` swift +public init(rawValue: RawValue) +``` + +## Properties + +### `rawValue` + +``` swift +public let rawValue: RawValue +``` + +### `normal` + +The default level. + +``` swift +public static var normal: Window.Level +``` + +### `statusBar` + +The level for a status window. + +``` swift +public static var statusBar: Window.Level +``` + +### `alert` + +The level for an alert view. + +``` swift +public static var alert: Window.Level +``` diff --git a/SwiftWin32/_Footer.md b/SwiftWin32/_Footer.md new file mode 100644 index 00000000..5b6a5145 --- /dev/null +++ b/SwiftWin32/_Footer.md @@ -0,0 +1 @@ +Generated at 2022-06-25T22:36:05+0000 using [swift-doc](https://github.com/SwiftDocOrg/swift-doc) 1.0.0-beta.6. diff --git a/SwiftWin32/_Sidebar.md b/SwiftWin32/_Sidebar.md new file mode 100644 index 00000000..68168da4 --- /dev/null +++ b/SwiftWin32/_Sidebar.md @@ -0,0 +1,257 @@ +
+Types + + - [AccessibilityContrast](https://compnerd.github.io/swift-win32/SwiftWin32/AccessibilityContrast) + - [Action](https://compnerd.github.io/swift-win32/SwiftWin32/Action) + - [Action.Identifier](https://compnerd.github.io/swift-win32/SwiftWin32/Action.Identifier) + - [AffineTransform](https://compnerd.github.io/swift-win32/SwiftWin32/AffineTransform) + - [AlertAction](https://compnerd.github.io/swift-win32/SwiftWin32/AlertAction) + - [AlertAction.Style](https://compnerd.github.io/swift-win32/SwiftWin32/AlertAction.Style) + - [AlertController](https://compnerd.github.io/swift-win32/SwiftWin32/AlertController) + - [AlertController.Style](https://compnerd.github.io/swift-win32/SwiftWin32/AlertController.Style) + - [Application](https://compnerd.github.io/swift-win32/SwiftWin32/Application) + - [Application.LaunchOptionsKey](https://compnerd.github.io/swift-win32/SwiftWin32/Application.LaunchOptionsKey) + - [Application.State](https://compnerd.github.io/swift-win32/SwiftWin32/Application.State) + - [Axis](https://compnerd.github.io/swift-win32/SwiftWin32/Axis) + - [BackgroundConfiguration](https://compnerd.github.io/swift-win32/SwiftWin32/BackgroundConfiguration) + - [BarButtonItem](https://compnerd.github.io/swift-win32/SwiftWin32/BarButtonItem) + - [BarButtonItem.Style](https://compnerd.github.io/swift-win32/SwiftWin32/BarButtonItem.Style) + - [BarButtonItem.SystemItem](https://compnerd.github.io/swift-win32/SwiftWin32/BarButtonItem.SystemItem) + - [BarButtonItemGroup](https://compnerd.github.io/swift-win32/SwiftWin32/BarButtonItemGroup) + - [BarItem](https://compnerd.github.io/swift-win32/SwiftWin32/BarItem) + - [BarMetrics](https://compnerd.github.io/swift-win32/SwiftWin32/BarMetrics) + - [BezierPath](https://compnerd.github.io/swift-win32/SwiftWin32/BezierPath) + - [Button](https://compnerd.github.io/swift-win32/SwiftWin32/Button) + - [Button.ButtonType](https://compnerd.github.io/swift-win32/SwiftWin32/Button.ButtonType) + - [CellConfigurationState](https://compnerd.github.io/swift-win32/SwiftWin32/CellConfigurationState) + - [Color](https://compnerd.github.io/swift-win32/SwiftWin32/Color) + - [Command](https://compnerd.github.io/swift-win32/SwiftWin32/Command) + - [CommandAlternate](https://compnerd.github.io/swift-win32/SwiftWin32/CommandAlternate) + - [ConfigurationColorTransformer](https://compnerd.github.io/swift-win32/SwiftWin32/ConfigurationColorTransformer) + - [ConfigurationStateCustomKey](https://compnerd.github.io/swift-win32/SwiftWin32/ConfigurationStateCustomKey) + - [ContentSizeCategory](https://compnerd.github.io/swift-win32/SwiftWin32/ContentSizeCategory) + - [ContextMenuConfiguration](https://compnerd.github.io/swift-win32/SwiftWin32/ContextMenuConfiguration) + - [ContextMenuInteraction](https://compnerd.github.io/swift-win32/SwiftWin32/ContextMenuInteraction) + - [ContextMenuInteraction.Appearance](https://compnerd.github.io/swift-win32/SwiftWin32/ContextMenuInteraction.Appearance) + - [ContextMenuInteractionCommitStyle](https://compnerd.github.io/swift-win32/SwiftWin32/ContextMenuInteractionCommitStyle) + - [ContextualAction](https://compnerd.github.io/swift-win32/SwiftWin32/ContextualAction) + - [ContextualAction.Style](https://compnerd.github.io/swift-win32/SwiftWin32/ContextualAction.Style) + - [Control](https://compnerd.github.io/swift-win32/SwiftWin32/Control) + - [Control.Event](https://compnerd.github.io/swift-win32/SwiftWin32/Control.Event) + - [Control.State](https://compnerd.github.io/swift-win32/SwiftWin32/Control.State) + - [CubicTimingParameters](https://compnerd.github.io/swift-win32/SwiftWin32/CubicTimingParameters) + - [DatePicker](https://compnerd.github.io/swift-win32/SwiftWin32/DatePicker) + - [DatePickerStyle](https://compnerd.github.io/swift-win32/SwiftWin32/DatePickerStyle) + - [Device](https://compnerd.github.io/swift-win32/SwiftWin32/Device) + - [Device.BatteryState](https://compnerd.github.io/swift-win32/SwiftWin32/Device.BatteryState) + - [Device.Orientation](https://compnerd.github.io/swift-win32/SwiftWin32/Device.Orientation) + - [DirectionalEdgeInsets](https://compnerd.github.io/swift-win32/SwiftWin32/DirectionalEdgeInsets) + - [DirectionalRectEdge](https://compnerd.github.io/swift-win32/SwiftWin32/DirectionalRectEdge) + - [DisplayGamut](https://compnerd.github.io/swift-win32/SwiftWin32/DisplayGamut) + - [EdgeInsets](https://compnerd.github.io/swift-win32/SwiftWin32/EdgeInsets) + - [Event](https://compnerd.github.io/swift-win32/SwiftWin32/Event) + - [Event.ButtonMask](https://compnerd.github.io/swift-win32/SwiftWin32/Event.ButtonMask) + - [Event.EventSubtype](https://compnerd.github.io/swift-win32/SwiftWin32/Event.EventSubtype) + - [Event.EventType](https://compnerd.github.io/swift-win32/SwiftWin32/Event.EventType) + - [FocusAnimationCoordinator](https://compnerd.github.io/swift-win32/SwiftWin32/FocusAnimationCoordinator) + - [FocusHeading](https://compnerd.github.io/swift-win32/SwiftWin32/FocusHeading) + - [FocusMovementHint](https://compnerd.github.io/swift-win32/SwiftWin32/FocusMovementHint) + - [FocusSoundIdentifier](https://compnerd.github.io/swift-win32/SwiftWin32/FocusSoundIdentifier) + - [FocusUpdateContext](https://compnerd.github.io/swift-win32/SwiftWin32/FocusUpdateContext) + - [Font](https://compnerd.github.io/swift-win32/SwiftWin32/Font) + - [Font.TextStyle](https://compnerd.github.io/swift-win32/SwiftWin32/Font.TextStyle) + - [Font.Weight](https://compnerd.github.io/swift-win32/SwiftWin32/Font.Weight) + - [FontDescriptor](https://compnerd.github.io/swift-win32/SwiftWin32/FontDescriptor) + - [FontDescriptor.AttributeName](https://compnerd.github.io/swift-win32/SwiftWin32/FontDescriptor.AttributeName) + - [FontDescriptor.FeatureKey](https://compnerd.github.io/swift-win32/SwiftWin32/FontDescriptor.FeatureKey) + - [FontDescriptor.SymbolicTraits](https://compnerd.github.io/swift-win32/SwiftWin32/FontDescriptor.SymbolicTraits) + - [FontDescriptor.SystemDesign](https://compnerd.github.io/swift-win32/SwiftWin32/FontDescriptor.SystemDesign) + - [FontDescriptor.TraitKey](https://compnerd.github.io/swift-win32/SwiftWin32/FontDescriptor.TraitKey) + - [FontMetrics](https://compnerd.github.io/swift-win32/SwiftWin32/FontMetrics) + - [ForceTouchCapability](https://compnerd.github.io/swift-win32/SwiftWin32/ForceTouchCapability) + - [GestureRecognizer](https://compnerd.github.io/swift-win32/SwiftWin32/GestureRecognizer) + - [GestureRecognizer.State](https://compnerd.github.io/swift-win32/SwiftWin32/GestureRecognizer.State) + - [Image](https://compnerd.github.io/swift-win32/SwiftWin32/Image) + - [Image.Configuration](https://compnerd.github.io/swift-win32/SwiftWin32/Image.Configuration) + - [Image.SymbolConfiguration](https://compnerd.github.io/swift-win32/SwiftWin32/Image.SymbolConfiguration) + - [Image.SymbolScale](https://compnerd.github.io/swift-win32/SwiftWin32/Image.SymbolScale) + - [Image.SymbolWeight](https://compnerd.github.io/swift-win32/SwiftWin32/Image.SymbolWeight) + - [ImageView](https://compnerd.github.io/swift-win32/SwiftWin32/ImageView) + - [InputViewController](https://compnerd.github.io/swift-win32/SwiftWin32/InputViewController) + - [InterfaceOrientation](https://compnerd.github.io/swift-win32/SwiftWin32/InterfaceOrientation) + - [InterfaceOrientationMask](https://compnerd.github.io/swift-win32/SwiftWin32/InterfaceOrientationMask) + - [KeyModifierFlags](https://compnerd.github.io/swift-win32/SwiftWin32/KeyModifierFlags) + - [Label](https://compnerd.github.io/swift-win32/SwiftWin32/Label) + - [LayoutAnchor](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutAnchor) + - [LayoutConstraint](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutConstraint) + - [LayoutConstraint.Attribute](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutConstraint.Attribute) + - [LayoutConstraint.Relation](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutConstraint.Relation) + - [LayoutDimension](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutDimension) + - [LayoutGuide](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutGuide) + - [LayoutPriority](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutPriority) + - [LayoutXAxisAnchor](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutXAxisAnchor) + - [LayoutYAxisAnchor](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutYAxisAnchor) + - [LegibilityWeight](https://compnerd.github.io/swift-win32/SwiftWin32/LegibilityWeight) + - [LineBreakMode](https://compnerd.github.io/swift-win32/SwiftWin32/LineBreakMode) + - [ListContentConfiguration](https://compnerd.github.io/swift-win32/SwiftWin32/ListContentConfiguration) + - [ListContentConfiguration.ImageProperties](https://compnerd.github.io/swift-win32/SwiftWin32/ListContentConfiguration.ImageProperties) + - [ListContentConfiguration.TextProperties](https://compnerd.github.io/swift-win32/SwiftWin32/ListContentConfiguration.TextProperties) + - [ListContentConfiguration.TextProperties.TextAlignment](https://compnerd.github.io/swift-win32/SwiftWin32/ListContentConfiguration.TextProperties.TextAlignment) + - [ListContentConfiguration.TextProperties.TextTransform](https://compnerd.github.io/swift-win32/SwiftWin32/ListContentConfiguration.TextProperties.TextTransform) + - [Menu](https://compnerd.github.io/swift-win32/SwiftWin32/Menu) + - [Menu.Identifier](https://compnerd.github.io/swift-win32/SwiftWin32/Menu.Identifier) + - [Menu.Options](https://compnerd.github.io/swift-win32/SwiftWin32/Menu.Options) + - [MenuElement](https://compnerd.github.io/swift-win32/SwiftWin32/MenuElement) + - [MenuElement.Attributes](https://compnerd.github.io/swift-win32/SwiftWin32/MenuElement.Attributes) + - [MenuElement.State](https://compnerd.github.io/swift-win32/SwiftWin32/MenuElement.State) + - [MenuSystem](https://compnerd.github.io/swift-win32/SwiftWin32/MenuSystem) + - [ModalPresentationStyle](https://compnerd.github.io/swift-win32/SwiftWin32/ModalPresentationStyle) + - [ModalTransitionStyle](https://compnerd.github.io/swift-win32/SwiftWin32/ModalTransitionStyle) + - [Offset](https://compnerd.github.io/swift-win32/SwiftWin32/Offset) + - [PickerView](https://compnerd.github.io/swift-win32/SwiftWin32/PickerView) + - [Point](https://compnerd.github.io/swift-win32/SwiftWin32/Point) + - [PointerEffect](https://compnerd.github.io/swift-win32/SwiftWin32/PointerEffect) + - [PointerEffect.TintMode](https://compnerd.github.io/swift-win32/SwiftWin32/PointerEffect.TintMode) + - [PointerInteraction](https://compnerd.github.io/swift-win32/SwiftWin32/PointerInteraction) + - [PointerRegion](https://compnerd.github.io/swift-win32/SwiftWin32/PointerRegion) + - [PointerRegionRequest](https://compnerd.github.io/swift-win32/SwiftWin32/PointerRegionRequest) + - [PointerShape](https://compnerd.github.io/swift-win32/SwiftWin32/PointerShape) + - [PointerStyle](https://compnerd.github.io/swift-win32/SwiftWin32/PointerStyle) + - [PresentationController](https://compnerd.github.io/swift-win32/SwiftWin32/PresentationController) + - [Press](https://compnerd.github.io/swift-win32/SwiftWin32/Press) + - [Press.Phase](https://compnerd.github.io/swift-win32/SwiftWin32/Press.Phase) + - [Press.PressType](https://compnerd.github.io/swift-win32/SwiftWin32/Press.PressType) + - [PressesEvent](https://compnerd.github.io/swift-win32/SwiftWin32/PressesEvent) + - [PreviewParameters](https://compnerd.github.io/swift-win32/SwiftWin32/PreviewParameters) + - [PreviewTarget](https://compnerd.github.io/swift-win32/SwiftWin32/PreviewTarget) + - [ProgressView](https://compnerd.github.io/swift-win32/SwiftWin32/ProgressView) + - [Rect](https://compnerd.github.io/swift-win32/SwiftWin32/Rect) + - [Rect.Edge](https://compnerd.github.io/swift-win32/SwiftWin32/Rect.Edge) + - [RectEdge](https://compnerd.github.io/swift-win32/SwiftWin32/RectEdge) + - [Responder](https://compnerd.github.io/swift-win32/SwiftWin32/Responder) + - [Scene](https://compnerd.github.io/swift-win32/SwiftWin32/Scene) + - [Scene.ConnectionOptions](https://compnerd.github.io/swift-win32/SwiftWin32/Scene.ConnectionOptions) + - [SceneConfiguration](https://compnerd.github.io/swift-win32/SwiftWin32/SceneConfiguration) + - [SceneSession](https://compnerd.github.io/swift-win32/SwiftWin32/SceneSession) + - [SceneSession.Role](https://compnerd.github.io/swift-win32/SwiftWin32/SceneSession.Role) + - [SceneSizeRestrictions](https://compnerd.github.io/swift-win32/SwiftWin32/SceneSizeRestrictions) + - [Screen](https://compnerd.github.io/swift-win32/SwiftWin32/Screen) + - [Size](https://compnerd.github.io/swift-win32/SwiftWin32/Size) + - [Slider](https://compnerd.github.io/swift-win32/SwiftWin32/Slider) + - [SpringLoadedInteractionEffectState](https://compnerd.github.io/swift-win32/SwiftWin32/SpringLoadedInteractionEffectState) + - [SpringTimingParameters](https://compnerd.github.io/swift-win32/SwiftWin32/SpringTimingParameters) + - [Stepper](https://compnerd.github.io/swift-win32/SwiftWin32/Stepper) + - [SwipeActionsConfiguration](https://compnerd.github.io/swift-win32/SwiftWin32/SwipeActionsConfiguration) + - [Switch](https://compnerd.github.io/swift-win32/SwiftWin32/Switch) + - [Switch.Style](https://compnerd.github.io/swift-win32/SwiftWin32/Switch.Style) + - [TableView](https://compnerd.github.io/swift-win32/SwiftWin32/TableView) + - [TableView.Style](https://compnerd.github.io/swift-win32/SwiftWin32/TableView.Style) + - [TableViewCell](https://compnerd.github.io/swift-win32/SwiftWin32/TableViewCell) + - [TableViewCell.CellStyle](https://compnerd.github.io/swift-win32/SwiftWin32/TableViewCell.CellStyle) + - [TableViewCell.EditingStyle](https://compnerd.github.io/swift-win32/SwiftWin32/TableViewCell.EditingStyle) + - [TableViewFocusUpdateContext](https://compnerd.github.io/swift-win32/SwiftWin32/TableViewFocusUpdateContext) + - [TableViewHeaderFooterView](https://compnerd.github.io/swift-win32/SwiftWin32/TableViewHeaderFooterView) + - [TapGestureRecognizer](https://compnerd.github.io/swift-win32/SwiftWin32/TapGestureRecognizer) + - [TargetedPreview](https://compnerd.github.io/swift-win32/SwiftWin32/TargetedPreview) + - [TextAlignment](https://compnerd.github.io/swift-win32/SwiftWin32/TextAlignment) + - [TextField](https://compnerd.github.io/swift-win32/SwiftWin32/TextField) + - [TextView](https://compnerd.github.io/swift-win32/SwiftWin32/TextView) + - [TimingCurveType](https://compnerd.github.io/swift-win32/SwiftWin32/TimingCurveType) + - [Touch](https://compnerd.github.io/swift-win32/SwiftWin32/Touch) + - [Touch.Phase](https://compnerd.github.io/swift-win32/SwiftWin32/Touch.Phase) + - [Touch.TouchType](https://compnerd.github.io/swift-win32/SwiftWin32/Touch.TouchType) + - [TraitCollection](https://compnerd.github.io/swift-win32/SwiftWin32/TraitCollection) + - [TraitEnvironmentLayoutDirection](https://compnerd.github.io/swift-win32/SwiftWin32/TraitEnvironmentLayoutDirection) + - [Transform3D](https://compnerd.github.io/swift-win32/SwiftWin32/Transform3D) + - [TransitionContextViewControllerKey](https://compnerd.github.io/swift-win32/SwiftWin32/TransitionContextViewControllerKey) + - [TransitionContextViewKey](https://compnerd.github.io/swift-win32/SwiftWin32/TransitionContextViewKey) + - [UserInterfaceActiveAppearance](https://compnerd.github.io/swift-win32/SwiftWin32/UserInterfaceActiveAppearance) + - [UserInterfaceIdiom](https://compnerd.github.io/swift-win32/SwiftWin32/UserInterfaceIdiom) + - [UserInterfaceLevel](https://compnerd.github.io/swift-win32/SwiftWin32/UserInterfaceLevel) + - [UserInterfaceSizeClass](https://compnerd.github.io/swift-win32/SwiftWin32/UserInterfaceSizeClass) + - [UserInterfaceStyle](https://compnerd.github.io/swift-win32/SwiftWin32/UserInterfaceStyle) + - [Vector](https://compnerd.github.io/swift-win32/SwiftWin32/Vector) + - [View](https://compnerd.github.io/swift-win32/SwiftWin32/View) + - [View.AnimationCurve](https://compnerd.github.io/swift-win32/SwiftWin32/View.AnimationCurve) + - [View.AnimationOptions](https://compnerd.github.io/swift-win32/SwiftWin32/View.AnimationOptions) + - [View.AutoresizingMask](https://compnerd.github.io/swift-win32/SwiftWin32/View.AutoresizingMask) + - [View.ContentMode](https://compnerd.github.io/swift-win32/SwiftWin32/View.ContentMode) + - [View.TintAdjustmentMode](https://compnerd.github.io/swift-win32/SwiftWin32/View.TintAdjustmentMode) + - [ViewAnimatingPosition](https://compnerd.github.io/swift-win32/SwiftWin32/ViewAnimatingPosition) + - [ViewAnimatingState](https://compnerd.github.io/swift-win32/SwiftWin32/ViewAnimatingState) + - [ViewConfigurationState](https://compnerd.github.io/swift-win32/SwiftWin32/ViewConfigurationState) + - [ViewController](https://compnerd.github.io/swift-win32/SwiftWin32/ViewController) + - [VisualEffect](https://compnerd.github.io/swift-win32/SwiftWin32/VisualEffect) + - [Window](https://compnerd.github.io/swift-win32/SwiftWin32/Window) + - [Window.Level](https://compnerd.github.io/swift-win32/SwiftWin32/Window.Level) + - [WindowScene](https://compnerd.github.io/swift-win32/SwiftWin32/WindowScene) + - [\_Win32WindowText](https://compnerd.github.io/swift-win32/SwiftWin32/_Win32WindowText) + +
+ +
+Protocols + + - [AdaptivePresentationControllerDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/AdaptivePresentationControllerDelegate) + - [Appearance](https://compnerd.github.io/swift-win32/SwiftWin32/Appearance) + - [AppearanceContainer](https://compnerd.github.io/swift-win32/SwiftWin32/AppearanceContainer) + - [ApplicationDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/ApplicationDelegate) + - [ConfigurationState](https://compnerd.github.io/swift-win32/SwiftWin32/ConfigurationState) + - [ContentConfiguration](https://compnerd.github.io/swift-win32/SwiftWin32/ContentConfiguration) + - [ContentContainer](https://compnerd.github.io/swift-win32/SwiftWin32/ContentContainer) + - [ContentSizeCategoryAdjusting](https://compnerd.github.io/swift-win32/SwiftWin32/ContentSizeCategoryAdjusting) + - [ContentSizeCategoryImageAdjusting](https://compnerd.github.io/swift-win32/SwiftWin32/ContentSizeCategoryImageAdjusting) + - [ContentView](https://compnerd.github.io/swift-win32/SwiftWin32/ContentView) + - [ContextMenuInteractionAnimating](https://compnerd.github.io/swift-win32/SwiftWin32/ContextMenuInteractionAnimating) + - [ContextMenuInteractionCommitAnimating](https://compnerd.github.io/swift-win32/SwiftWin32/ContextMenuInteractionCommitAnimating) + - [ContextMenuInteractionDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/ContextMenuInteractionDelegate) + - [CoordinateSpace](https://compnerd.github.io/swift-win32/SwiftWin32/CoordinateSpace) + - [FocusAnimationContext](https://compnerd.github.io/swift-win32/SwiftWin32/FocusAnimationContext) + - [FocusEnvironment](https://compnerd.github.io/swift-win32/SwiftWin32/FocusEnvironment) + - [FocusItem](https://compnerd.github.io/swift-win32/SwiftWin32/FocusItem) + - [FocusItemContainer](https://compnerd.github.io/swift-win32/SwiftWin32/FocusItemContainer) + - [GestureRecognizerDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/GestureRecognizerDelegate) + - [Interaction](https://compnerd.github.io/swift-win32/SwiftWin32/Interaction) + - [LayoutSupport](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutSupport) + - [MenuBuilder](https://compnerd.github.io/swift-win32/SwiftWin32/MenuBuilder) + - [PickerViewDataSource](https://compnerd.github.io/swift-win32/SwiftWin32/PickerViewDataSource) + - [PickerViewDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/PickerViewDelegate) + - [PointerInteractionAnimating](https://compnerd.github.io/swift-win32/SwiftWin32/PointerInteractionAnimating) + - [PointerInteractionDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/PointerInteractionDelegate) + - [SceneDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/SceneDelegate) + - [SpringLoadedInteractionContext](https://compnerd.github.io/swift-win32/SwiftWin32/SpringLoadedInteractionContext) + - [TableViewDataSource](https://compnerd.github.io/swift-win32/SwiftWin32/TableViewDataSource) + - [TableViewDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/TableViewDelegate) + - [TextFieldDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/TextFieldDelegate) + - [TextInputTraits](https://compnerd.github.io/swift-win32/SwiftWin32/TextInputTraits) + - [TimingCurveProvider](https://compnerd.github.io/swift-win32/SwiftWin32/TimingCurveProvider) + - [TraitEnvironment](https://compnerd.github.io/swift-win32/SwiftWin32/TraitEnvironment) + - [ViewAnimating](https://compnerd.github.io/swift-win32/SwiftWin32/ViewAnimating) + - [ViewControllerAnimatedTransitioning](https://compnerd.github.io/swift-win32/SwiftWin32/ViewControllerAnimatedTransitioning) + - [ViewControllerContextTransitioning](https://compnerd.github.io/swift-win32/SwiftWin32/ViewControllerContextTransitioning) + - [ViewControllerInteractiveTransitioning](https://compnerd.github.io/swift-win32/SwiftWin32/ViewControllerInteractiveTransitioning) + - [ViewControllerTransitionCoordinator](https://compnerd.github.io/swift-win32/SwiftWin32/ViewControllerTransitionCoordinator) + - [ViewControllerTransitionCoordinatorContext](https://compnerd.github.io/swift-win32/SwiftWin32/ViewControllerTransitionCoordinatorContext) + - [ViewControllerTransitioningDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/ViewControllerTransitioningDelegate) + - [ViewImplicitlyAnimating](https://compnerd.github.io/swift-win32/SwiftWin32/ViewImplicitlyAnimating) + - [WindowSceneDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/WindowSceneDelegate) + - [\_TriviallyConstructible](https://compnerd.github.io/swift-win32/SwiftWin32/_TriviallyConstructible) + +
+ +
+Global Functions + + - [ApplicationMain(\_:\_:\_:\_:)](https://compnerd.github.io/swift-win32/SwiftWin32/ApplicationMain\(________\)) + +
+ +
+Extensions + + - [IndexPath](https://compnerd.github.io/swift-win32/SwiftWin32/IndexPath) + - [ListContentConfiguration.TextProperties.TextAlignment](https://compnerd.github.io/swift-win32/SwiftWin32/ListContentConfiguration.TextProperties.TextAlignment) + - [ListContentConfiguration.TextProperties.TextTransform](https://compnerd.github.io/swift-win32/SwiftWin32/ListContentConfiguration.TextProperties.TextTransform) + - [String](https://compnerd.github.io/swift-win32/SwiftWin32/String) + +
diff --git a/SwiftWin32/_TriviallyConstructible.md b/SwiftWin32/_TriviallyConstructible.md new file mode 100644 index 00000000..1373627f --- /dev/null +++ b/SwiftWin32/_TriviallyConstructible.md @@ -0,0 +1,18 @@ +--- +layout: default +title: _TriviallyConstructible +parent: SwiftWin32 +--- +# \_TriviallyConstructible + +``` swift +public protocol _TriviallyConstructible +``` + +## Requirements + +### init() + +``` swift +init() +``` diff --git a/SwiftWin32/_Win32WindowText.md b/SwiftWin32/_Win32WindowText.md new file mode 100644 index 00000000..3aaac629 --- /dev/null +++ b/SwiftWin32/_Win32WindowText.md @@ -0,0 +1,27 @@ +--- +layout: default +title: _Win32WindowText +parent: SwiftWin32 +--- +# \_Win32WindowText + +``` swift +@propertyWrapper +public struct _Win32WindowText +``` + +## Initializers + +### `init()` + +``` swift +public init() +``` + +## Properties + +### `wrappedValue` + +``` swift +public var wrappedValue: String? +``` diff --git a/SwiftWin32/index.md b/SwiftWin32/index.md new file mode 100644 index 00000000..7ba5a459 --- /dev/null +++ b/SwiftWin32/index.md @@ -0,0 +1,503 @@ +--- +layout: default +title: SwiftWin32 +has_children: true +--- +# Types + + - [CubicTimingParameters](https://compnerd.github.io/swift-win32/SwiftWin32/CubicTimingParameters): + The timing information for animations in the form of a cubic Bézier curve. + - [SpringTimingParameters](https://compnerd.github.io/swift-win32/SwiftWin32/SpringTimingParameters): + The timing information for animations that mimics the behavior of a spring. + - [InputViewController](https://compnerd.github.io/swift-win32/SwiftWin32/InputViewController) + - [Application](https://compnerd.github.io/swift-win32/SwiftWin32/Application): + The centralised point of control and coordination for running applications. + - [Scene.ConnectionOptions](https://compnerd.github.io/swift-win32/SwiftWin32/Scene_ConnectionOptions) + - [Scene](https://compnerd.github.io/swift-win32/SwiftWin32/Scene) + - [SceneConfiguration](https://compnerd.github.io/swift-win32/SwiftWin32/SceneConfiguration) + - [SceneSession](https://compnerd.github.io/swift-win32/SwiftWin32/SceneSession) + - [WindowScene](https://compnerd.github.io/swift-win32/SwiftWin32/WindowScene) + - [TraitCollection](https://compnerd.github.io/swift-win32/SwiftWin32/TraitCollection) + - [LayoutAnchor](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutAnchor): + A factory class for creating layout constraint objects using a fluent API. + - [LayoutConstraint](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutConstraint) + - [LayoutDimension](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutDimension): + A factory class for creating size-based layout constraint objects using a + fluent API. + - [LayoutGuide](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutGuide) + - [LayoutXAxisAnchor](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutXAxisAnchor): + A factory class for creating horizontal layout constraint objects using a + fluent API. + - [LayoutYAxisAnchor](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutYAxisAnchor): + A factory class for creating vertical layout constraint objects using a + fluent API. + - [BezierPath](https://compnerd.github.io/swift-win32/SwiftWin32/BezierPath) + - [FocusAnimationCoordinator](https://compnerd.github.io/swift-win32/SwiftWin32/FocusAnimationCoordinator): + A coordinator of focus-related animations during a focus update. + - [FocusMovementHint](https://compnerd.github.io/swift-win32/SwiftWin32/FocusMovementHint): + Provides movement hint information for the focused item. + - [FocusUpdateContext](https://compnerd.github.io/swift-win32/SwiftWin32/FocusUpdateContext): + An object that provides information relevant to a specific focus update from + one view to another. + - [Image.Configuration](https://compnerd.github.io/swift-win32/SwiftWin32/Image_Configuration): + A configuration object that contains the traits that the system uses when + selecting the current image variant. + - [Image.SymbolConfiguration](https://compnerd.github.io/swift-win32/SwiftWin32/Image_SymbolConfiguration): + An object that contains the specific font, size, style, and weight + attributes to apply to a symbol image. + - [Image](https://compnerd.github.io/swift-win32/SwiftWin32/Image): + An object that manages image data in your app. + - [Action](https://compnerd.github.io/swift-win32/SwiftWin32/Action): + A menu element that performs its action in a closure. + - [CommandAlternate](https://compnerd.github.io/swift-win32/SwiftWin32/CommandAlternate): + An object representing an alternative action for a command. + - [Command](https://compnerd.github.io/swift-win32/SwiftWin32/Command): + A menu element that performs its action in a selector. + - [ContextMenuConfiguration](https://compnerd.github.io/swift-win32/SwiftWin32/ContextMenuConfiguration): + Returns the configuration data to use when previewing the content. + - [ContextMenuInteraction](https://compnerd.github.io/swift-win32/SwiftWin32/ContextMenuInteraction): + An interaction object that you use to display relevant actions for your + content. + - [Menu](https://compnerd.github.io/swift-win32/SwiftWin32/Menu): + A container for grouping related menu elements in an application menu or + contextual menu. + - [MenuElement](https://compnerd.github.io/swift-win32/SwiftWin32/MenuElement): + An object representing a menu, action, or command. + - [MenuSystem](https://compnerd.github.io/swift-win32/SwiftWin32/MenuSystem): + An object representing a main or contextual menu system. + - [PreviewParameters](https://compnerd.github.io/swift-win32/SwiftWin32/PreviewParameters): + Additional parameters to use when animating a preview interface. + - [PreviewTarget](https://compnerd.github.io/swift-win32/SwiftWin32/PreviewTarget): + An object that specifies the container view to use for animations. + - [TargetedPreview](https://compnerd.github.io/swift-win32/SwiftWin32/TargetedPreview) + - [PointerInteraction](https://compnerd.github.io/swift-win32/SwiftWin32/PointerInteraction): + An interaction that enables support for effects on a view or customizes the + pointer's appearance within a region of an app. + - [PointerRegion](https://compnerd.github.io/swift-win32/SwiftWin32/PointerRegion) + - [PointerRegionRequest](https://compnerd.github.io/swift-win32/SwiftWin32/PointerRegionRequest): + An object to describe the pointer's location in the interaction's view. + - [PointerStyle](https://compnerd.github.io/swift-win32/SwiftWin32/PointerStyle): + An object that defines the pointer shape and effect. + - [Font](https://compnerd.github.io/swift-win32/SwiftWin32/Font): + Represents a font. + - [FontDescriptor](https://compnerd.github.io/swift-win32/SwiftWin32/FontDescriptor): + A collection of attributes that describes a font. + - [FontMetrics](https://compnerd.github.io/swift-win32/SwiftWin32/FontMetrics) + - [Event](https://compnerd.github.io/swift-win32/SwiftWin32/Event): + An object that describes a single user interaction with your app. + - [GestureRecognizer](https://compnerd.github.io/swift-win32/SwiftWin32/GestureRecognizer) + - [Press](https://compnerd.github.io/swift-win32/SwiftWin32/Press): + An object that represents the presence or movement of a button press on the + screen for a particular event. + - [PressesEvent](https://compnerd.github.io/swift-win32/SwiftWin32/PressesEvent): + An event that describes the state of a set of physical buttons that are + available to the device, such as those on an associated remote or game + controller. + - [Responder](https://compnerd.github.io/swift-win32/SwiftWin32/Responder) + - [TapGestureRecognizer](https://compnerd.github.io/swift-win32/SwiftWin32/TapGestureRecognizer): + A discrete gesture recognizer that interprets single or multiple taps. + - [Touch](https://compnerd.github.io/swift-win32/SwiftWin32/Touch): + An object representing the location, size, movement, and force of a touch + occurring on the screen. + - [SceneSizeRestrictions](https://compnerd.github.io/swift-win32/SwiftWin32/SceneSizeRestrictions) + - [PresentationController](https://compnerd.github.io/swift-win32/SwiftWin32/PresentationController): + An object that manages the transition animations and the presentation of + view controllers onscreen. + - [ViewController](https://compnerd.github.io/swift-win32/SwiftWin32/ViewController): + An object that manages a view hierarchy for your application. + - [BarButtonItem](https://compnerd.github.io/swift-win32/SwiftWin32/BarButtonItem): + A specialized button for placement on a toolbar or tab bar. + - [BarButtonItemGroup](https://compnerd.github.io/swift-win32/SwiftWin32/BarButtonItemGroup): + A set of bar button items on the shortcuts bar. + - [BarItem](https://compnerd.github.io/swift-win32/SwiftWin32/BarItem): + An abstract superclass for items that you can add to a bar that appears at + the bottom of the screen. + - [Button](https://compnerd.github.io/swift-win32/SwiftWin32/Button): + A control that executes your custom code in response to user interactions. + - [Control](https://compnerd.github.io/swift-win32/SwiftWin32/Control): + The base class for controls, which are visual elements that convey a + specific action or intention in response to user interactions. + - [DatePicker](https://compnerd.github.io/swift-win32/SwiftWin32/DatePicker) + - [EdgeInsets](https://compnerd.github.io/swift-win32/SwiftWin32/EdgeInsets) + - [ImageView](https://compnerd.github.io/swift-win32/SwiftWin32/ImageView): + An object that displays a single image or a sequence of animated images in + your interface. + - [Label](https://compnerd.github.io/swift-win32/SwiftWin32/Label) + - [PickerView](https://compnerd.github.io/swift-win32/SwiftWin32/PickerView): + A view that shows one or more sets of values. + - [ProgressView](https://compnerd.github.io/swift-win32/SwiftWin32/ProgressView) + - [Slider](https://compnerd.github.io/swift-win32/SwiftWin32/Slider): + A control for selecting a single value from a continuous range of values. + - [Stepper](https://compnerd.github.io/swift-win32/SwiftWin32/Stepper): + A control for incrementing or decrementing a value. + - [Switch](https://compnerd.github.io/swift-win32/SwiftWin32/Switch): + A control that offers a binary choice, such as on/off. + - [ContextualAction](https://compnerd.github.io/swift-win32/SwiftWin32/ContextualAction): + An action to display when the user swipes a table row. + - [SwipeActionsConfiguration](https://compnerd.github.io/swift-win32/SwiftWin32/SwipeActionsConfiguration): + The set of actions to perform when swiping on rows of a table. + - [TableView](https://compnerd.github.io/swift-win32/SwiftWin32/TableView): + A view that presents data using rows arranged in a single column. + - [TableViewCell](https://compnerd.github.io/swift-win32/SwiftWin32/TableViewCell): + The visual representation of a single row in a table view. + - [TableViewFocusUpdateContext](https://compnerd.github.io/swift-win32/SwiftWin32/TableViewFocusUpdateContext): + A context object that provides information relevant to a specific focus + update from one view to another. + - [TableViewHeaderFooterView](https://compnerd.github.io/swift-win32/SwiftWin32/TableViewHeaderFooterView): + A reusable view that you place at the top or bottom of a table section to + display additional information for that section. + - [TextField](https://compnerd.github.io/swift-win32/SwiftWin32/TextField) + - [TextView](https://compnerd.github.io/swift-win32/SwiftWin32/TextView) + - [View](https://compnerd.github.io/swift-win32/SwiftWin32/View): + An object that manages the content for a rectangular area on the screen. + - [VisualEffect](https://compnerd.github.io/swift-win32/SwiftWin32/VisualEffect): + An initializer for visual effect views and blur and vibrancy effect objects. + - [AlertAction](https://compnerd.github.io/swift-win32/SwiftWin32/AlertAction): + An action that can be taken when the user taps a button in an alert. + - [AlertController](https://compnerd.github.io/swift-win32/SwiftWin32/AlertController): + An object that displays an alert message to the user. + - [Screen](https://compnerd.github.io/swift-win32/SwiftWin32/Screen) + - [Window](https://compnerd.github.io/swift-win32/SwiftWin32/Window): + The backdrop for your application’s user interface and the object that + dispatches events to your views. + - [TimingCurveType](https://compnerd.github.io/swift-win32/SwiftWin32/TimingCurveType): + Constants indicating the type of timing information to use. + - [ViewAnimatingPosition](https://compnerd.github.io/swift-win32/SwiftWin32/ViewAnimatingPosition): + Constants indicating positions within the animation. + - [ViewAnimatingState](https://compnerd.github.io/swift-win32/SwiftWin32/ViewAnimatingState): + Constants indicating the current state of the animation. + - [ModalPresentationStyle](https://compnerd.github.io/swift-win32/SwiftWin32/ModalPresentationStyle): + Modal presentation styles available when presenting view controllers. + - [Application.State](https://compnerd.github.io/swift-win32/SwiftWin32/Application_State): + The running states of the application + - [InterfaceOrientation](https://compnerd.github.io/swift-win32/SwiftWin32/InterfaceOrientation): + The orientation of the application's user interface + - [Device.BatteryState](https://compnerd.github.io/swift-win32/SwiftWin32/Device_BatteryState) + - [Device.Orientation](https://compnerd.github.io/swift-win32/SwiftWin32/Device_Orientation) + - [UserInterfaceSizeClass](https://compnerd.github.io/swift-win32/SwiftWin32/UserInterfaceSizeClass): + Constants that indicate the size class of a view. + - [DisplayGamut](https://compnerd.github.io/swift-win32/SwiftWin32/DisplayGamut): + Constants that indicate the gamut of the current display. + - [UserInterfaceStyle](https://compnerd.github.io/swift-win32/SwiftWin32/UserInterfaceStyle): + Constants that indicate the interface style for the application. + - [UserInterfaceActiveAppearance](https://compnerd.github.io/swift-win32/SwiftWin32/UserInterfaceActiveAppearance): + Constants that indicate whether the user interface has an active appearance. + - [UserInterfaceIdiom](https://compnerd.github.io/swift-win32/SwiftWin32/UserInterfaceIdiom): + Constants that indicate the interface type for the device or an object that + has a trait environment, such as a view and view controller. + - [UserInterfaceLevel](https://compnerd.github.io/swift-win32/SwiftWin32/UserInterfaceLevel): + Constants that indicate the visual level for content in the window. + - [TraitEnvironmentLayoutDirection](https://compnerd.github.io/swift-win32/SwiftWin32/TraitEnvironmentLayoutDirection): + Constants that indicate the layout direction associated with the current + environment. + - [AccessibilityContrast](https://compnerd.github.io/swift-win32/SwiftWin32/AccessibilityContrast): + Constants that indicate the accessibility contrast setting. + - [LegibilityWeight](https://compnerd.github.io/swift-win32/SwiftWin32/LegibilityWeight): + The font weight to apply to text. + - [ForceTouchCapability](https://compnerd.github.io/swift-win32/SwiftWin32/ForceTouchCapability): + Keys that indicate the availability of 3D Touch on a device. + - [ListContentConfiguration.TextProperties.TextAlignment](https://compnerd.github.io/swift-win32/SwiftWin32/ListContentConfiguration_TextProperties_TextAlignment): + Constants that specify the visual alignment of the text. + - [ListContentConfiguration.TextProperties.TextTransform](https://compnerd.github.io/swift-win32/SwiftWin32/ListContentConfiguration_TextProperties_TextTransform) + - [LayoutConstraint.Relation](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutConstraint_Relation): + The relation between the first attribute and the modified second attribute + in a constraint. + - [LayoutConstraint.Attribute](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutConstraint_Attribute): + The part of the object's visual representation that should be used to get + the value for the constraint. + - [Rect.Edge](https://compnerd.github.io/swift-win32/SwiftWin32/Rect_Edge): + Coordinates that establish the edges of a rectangle. + - [SpringLoadedInteractionEffectState](https://compnerd.github.io/swift-win32/SwiftWin32/SpringLoadedInteractionEffectState): + The spring-loaded interaction states that determine the style of the + interaction view. + - [Image.SymbolWeight](https://compnerd.github.io/swift-win32/SwiftWin32/Image_SymbolWeight): + Constants that indicate which weight variant of a symbol image to use. + - [Image.SymbolScale](https://compnerd.github.io/swift-win32/SwiftWin32/Image_SymbolScale) + - [ContextMenuInteraction.Appearance](https://compnerd.github.io/swift-win32/SwiftWin32/ContextMenuInteraction_Appearance): + Constants that describe the appearance of the menu. + - [ContextMenuInteractionCommitStyle](https://compnerd.github.io/swift-win32/SwiftWin32/ContextMenuInteractionCommitStyle): + Constants that control the interaction commit style. + - [MenuElement.State](https://compnerd.github.io/swift-win32/SwiftWin32/MenuElement_State): + Constants that indicate the state of an action-based or command-based + menu element. + - [PointerEffect.TintMode](https://compnerd.github.io/swift-win32/SwiftWin32/PointerEffect_TintMode): + An effect that defines how to apply a tint to a view during a pointer + interaction. + - [PointerEffect](https://compnerd.github.io/swift-win32/SwiftWin32/PointerEffect): + An effect that alters a view's appearance when a pointer enters the current + region. + - [PointerShape](https://compnerd.github.io/swift-win32/SwiftWin32/PointerShape): + An object that defines the shape of custom pointers. + - [LineBreakMode](https://compnerd.github.io/swift-win32/SwiftWin32/LineBreakMode): + Constants that specify what happens when a line is too long for its + container. + - [Event.EventType](https://compnerd.github.io/swift-win32/SwiftWin32/Event_EventType): + Specifies the general type of event. + - [Event.EventSubtype](https://compnerd.github.io/swift-win32/SwiftWin32/Event_EventSubtype): + Specifies the subtype of the event in relation to its general type. + - [GestureRecognizer.State](https://compnerd.github.io/swift-win32/SwiftWin32/GestureRecognizer_State): + The current state a gesture recognizer is in. + - [Press.Phase](https://compnerd.github.io/swift-win32/SwiftWin32/Press_Phase): + The phases of a button press. + - [Press.PressType](https://compnerd.github.io/swift-win32/SwiftWin32/Press_PressType): + Constants that represent buttons that a user can press. + - [Touch.TouchType](https://compnerd.github.io/swift-win32/SwiftWin32/Touch_TouchType): + The type of touch received. + - [Touch.Phase](https://compnerd.github.io/swift-win32/SwiftWin32/Touch_Phase): + The phase of a touch event. + - [ModalTransitionStyle](https://compnerd.github.io/swift-win32/SwiftWin32/ModalTransitionStyle): + Transition styles available when presenting view controllers. + - [BarButtonItem.SystemItem](https://compnerd.github.io/swift-win32/SwiftWin32/BarButtonItem_SystemItem): + Defines system-supplied images for bar button items. + - [BarButtonItem.Style](https://compnerd.github.io/swift-win32/SwiftWin32/BarButtonItem_Style): + The system close button. + - [BarMetrics](https://compnerd.github.io/swift-win32/SwiftWin32/BarMetrics): + Constants to specify metrics to use for appearance. + - [Button.ButtonType](https://compnerd.github.io/swift-win32/SwiftWin32/Button_ButtonType): + Specifies the style of a button. + - [DatePickerStyle](https://compnerd.github.io/swift-win32/SwiftWin32/DatePickerStyle) + - [Switch.Style](https://compnerd.github.io/swift-win32/SwiftWin32/Switch_Style): + Styles that determine the appearance of the switch. + - [ContextualAction.Style](https://compnerd.github.io/swift-win32/SwiftWin32/ContextualAction_Style): + Constants indicating the style information that is applied to the action + button. + - [TableView.Style](https://compnerd.github.io/swift-win32/SwiftWin32/TableView_Style) + - [TableViewCell.CellStyle](https://compnerd.github.io/swift-win32/SwiftWin32/TableViewCell_CellStyle) + - [TableViewCell.EditingStyle](https://compnerd.github.io/swift-win32/SwiftWin32/TableViewCell_EditingStyle): + The editing control used by a cell. + - [TextAlignment](https://compnerd.github.io/swift-win32/SwiftWin32/TextAlignment) + - [View.ContentMode](https://compnerd.github.io/swift-win32/SwiftWin32/View_ContentMode): + Options to specify how a view adjusts its content when its size changes. + - [View.AnimationCurve](https://compnerd.github.io/swift-win32/SwiftWin32/View_AnimationCurve): + Specifies the supported animation curves. + - [View.TintAdjustmentMode](https://compnerd.github.io/swift-win32/SwiftWin32/View_TintAdjustmentMode): + The tint adjustment mode for the view. + - [AlertAction.Style](https://compnerd.github.io/swift-win32/SwiftWin32/AlertAction_Style): + Styles to apply to action buttons in an alert. + - [AlertController.Style](https://compnerd.github.io/swift-win32/SwiftWin32/AlertController_Style): + Constants indicating the type of alert to display. + - [TransitionContextViewControllerKey](https://compnerd.github.io/swift-win32/SwiftWin32/TransitionContextViewControllerKey): + The keys you use to identify the view controllers involved in a transition. + - [TransitionContextViewKey](https://compnerd.github.io/swift-win32/SwiftWin32/TransitionContextViewKey): + The keys you use to identify the views involved in a transition. + - [ContentSizeCategory](https://compnerd.github.io/swift-win32/SwiftWin32/ContentSizeCategory): + Constants that indicate the preferred size of your content. + - [InterfaceOrientationMask](https://compnerd.github.io/swift-win32/SwiftWin32/InterfaceOrientationMask): + These constants are mask bits for specifying a view controller's supported + interface orientations. + - [Device](https://compnerd.github.io/swift-win32/SwiftWin32/Device) + - [SceneSession.Role](https://compnerd.github.io/swift-win32/SwiftWin32/SceneSession_Role): + Constants that indicate the possible roles for a scene. + - [BackgroundConfiguration](https://compnerd.github.io/swift-win32/SwiftWin32/BackgroundConfiguration): + A configuration that describes a specific background appearance. + - [CellConfigurationState](https://compnerd.github.io/swift-win32/SwiftWin32/CellConfigurationState): + A structure that encapsulates a cell's state. + - [ConfigurationColorTransformer](https://compnerd.github.io/swift-win32/SwiftWin32/ConfigurationColorTransformer): + A transformer that generates a modified output color from an input color. + - [ConfigurationStateCustomKey](https://compnerd.github.io/swift-win32/SwiftWin32/ConfigurationStateCustomKey): + A key that defines a custom state for a view. + - [ListContentConfiguration.ImageProperties](https://compnerd.github.io/swift-win32/SwiftWin32/ListContentConfiguration_ImageProperties): + Properties that affect the list content configuration's image. + - [ListContentConfiguration.TextProperties](https://compnerd.github.io/swift-win32/SwiftWin32/ListContentConfiguration_TextProperties): + Properties that affect the list content configuration's text. + - [ListContentConfiguration](https://compnerd.github.io/swift-win32/SwiftWin32/ListContentConfiguration): + A content configuration for a list-based content view. + - [ViewConfigurationState](https://compnerd.github.io/swift-win32/SwiftWin32/ViewConfigurationState): + A structure that encapsulates a view's state. + - [Application.LaunchOptionsKey](https://compnerd.github.io/swift-win32/SwiftWin32/Application_LaunchOptionsKey): + Keys used to access values in the launch options dictionary passed to your + application at initialization time. + - [LayoutPriority](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutPriority): + The layout priority is used to indicate to the constraint-based layout + system which constraints are more important, allowing the system to make + appropriate tradeoffs when satisfying the constraints of the system as a + whole. + - [Transform3D](https://compnerd.github.io/swift-win32/SwiftWin32/Transform3D): + The standard transform matrix. + - [AffineTransform](https://compnerd.github.io/swift-win32/SwiftWin32/AffineTransform): + An affine transformation matrix for use in drawing 2D graphics. + - [Point](https://compnerd.github.io/swift-win32/SwiftWin32/Point): + A structure that contains a point in a two-dimensional coordinate system. + - [Rect](https://compnerd.github.io/swift-win32/SwiftWin32/Rect): + A structure that contains the location and dimensions of a rectangle. + - [Size](https://compnerd.github.io/swift-win32/SwiftWin32/Size): + A structure that contains width and height values. + - [Vector](https://compnerd.github.io/swift-win32/SwiftWin32/Vector): + A structure that contains a two-dimensional vector. + - [Color](https://compnerd.github.io/swift-win32/SwiftWin32/Color): + An object that stores color data and sometimes opacity. + - [FocusSoundIdentifier](https://compnerd.github.io/swift-win32/SwiftWin32/FocusSoundIdentifier): + An identifier for a focus-related sound. + - [FocusHeading](https://compnerd.github.io/swift-win32/SwiftWin32/FocusHeading): + The general type of an event. + - [Action.Identifier](https://compnerd.github.io/swift-win32/SwiftWin32/Action_Identifier): + A type that represents an action identifier. + - [KeyModifierFlags](https://compnerd.github.io/swift-win32/SwiftWin32/KeyModifierFlags): + Constants that indicate which modifier keys are pressed. + - [Menu.Identifier](https://compnerd.github.io/swift-win32/SwiftWin32/Menu_Identifier): + Constants for identifying an application's standard menus. + - [Menu.Options](https://compnerd.github.io/swift-win32/SwiftWin32/Menu_Options): + Options for configuring a menu's appearance. + - [MenuElement.Attributes](https://compnerd.github.io/swift-win32/SwiftWin32/MenuElement_Attributes): + Attributes that determine the style of the menu element. + - [\_Win32WindowText](https://compnerd.github.io/swift-win32/SwiftWin32/_Win32WindowText) + - [Font.Weight](https://compnerd.github.io/swift-win32/SwiftWin32/Font_Weight): + Constants that represent standard font weights. + - [Font.TextStyle](https://compnerd.github.io/swift-win32/SwiftWin32/Font_TextStyle): + Constants that describe the preferred styles for fonts. + - [FontDescriptor.SystemDesign](https://compnerd.github.io/swift-win32/SwiftWin32/FontDescriptor_SystemDesign): + Constants that describe the system-defined typeface designs. + - [FontDescriptor.SymbolicTraits](https://compnerd.github.io/swift-win32/SwiftWin32/FontDescriptor_SymbolicTraits): + Constants that describe the stylistic aspects of a font. + - [FontDescriptor.AttributeName](https://compnerd.github.io/swift-win32/SwiftWin32/FontDescriptor_AttributeName): + Constants that describe font attributes. + - [FontDescriptor.FeatureKey](https://compnerd.github.io/swift-win32/SwiftWin32/FontDescriptor_FeatureKey): + Keys for retrieving feature settings. + - [FontDescriptor.TraitKey](https://compnerd.github.io/swift-win32/SwiftWin32/FontDescriptor_TraitKey) + - [Event.ButtonMask](https://compnerd.github.io/swift-win32/SwiftWin32/Event_ButtonMask): + Set of buttons pressed for the current event + - [RectEdge](https://compnerd.github.io/swift-win32/SwiftWin32/RectEdge): + Constants that specify the edges of a rectangle. + - [Axis](https://compnerd.github.io/swift-win32/SwiftWin32/Axis): + Defines a structure that specifies the layout axes. + - [Control.State](https://compnerd.github.io/swift-win32/SwiftWin32/Control_State): + The state of the control, specified as a bit mask value. + - [Control.Event](https://compnerd.github.io/swift-win32/SwiftWin32/Control_Event): + Constants describing the types of events possible for controls. + - [DirectionalEdgeInsets](https://compnerd.github.io/swift-win32/SwiftWin32/DirectionalEdgeInsets): + Edge insets that take language direction into account. + - [DirectionalRectEdge](https://compnerd.github.io/swift-win32/SwiftWin32/DirectionalRectEdge): + Constants that specify an edge or a set of edges, taking the user interface + layout direction into account. + - [Offset](https://compnerd.github.io/swift-win32/SwiftWin32/Offset): + A structure that specifies an amount to offset a position. + - [View.AnimationOptions](https://compnerd.github.io/swift-win32/SwiftWin32/View_AnimationOptions): + Options for animating views using block objects. + - [View.AutoresizingMask](https://compnerd.github.io/swift-win32/SwiftWin32/View_AutoresizingMask): + Options for automatic view resizing. + - [Window.Level](https://compnerd.github.io/swift-win32/SwiftWin32/Window_Level): + The positioning of windows relative to each other. + +# Protocols + + - [TimingCurveProvider](https://compnerd.github.io/swift-win32/SwiftWin32/TimingCurveProvider): + An interface for providing the timing information needed to perform + animations. + - [ViewAnimating](https://compnerd.github.io/swift-win32/SwiftWin32/ViewAnimating): + An interface for implementing custom animator objects. + - [ViewImplicitlyAnimating](https://compnerd.github.io/swift-win32/SwiftWin32/ViewImplicitlyAnimating): + An interface for modifying an animation while it is running. + - [ViewControllerAnimatedTransitioning](https://compnerd.github.io/swift-win32/SwiftWin32/ViewControllerAnimatedTransitioning): + A set of methods for implementing the animations for a custom view controller + transition. + - [ViewControllerInteractiveTransitioning](https://compnerd.github.io/swift-win32/SwiftWin32/ViewControllerInteractiveTransitioning): + A set of methods that enable an object (such as a navigation controller) to + drive a view controller transition. + - [ViewControllerTransitionCoordinator](https://compnerd.github.io/swift-win32/SwiftWin32/ViewControllerTransitionCoordinator) + - [ViewControllerTransitionCoordinatorContext](https://compnerd.github.io/swift-win32/SwiftWin32/ViewControllerTransitionCoordinatorContext): + A set of methods that provides information about an in-progress view + controller transition. + - [ViewControllerTransitioningDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/ViewControllerTransitioningDelegate): + A set of methods that vend objects used to manage a fixed-length or + interactive transition between view controllers. + - [ViewControllerContextTransitioning](https://compnerd.github.io/swift-win32/SwiftWin32/ViewControllerContextTransitioning): + A set of methods that provide contextual information for transition + animations between view controllers. + - [AdaptivePresentationControllerDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/AdaptivePresentationControllerDelegate): + A set of methods that, in conjunction with a presentation controller, + determine how to respond to trait changes in your application. + - [ApplicationDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/ApplicationDelegate): + A set of methods used to manage shared behaviours for the application. + - [SceneDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/SceneDelegate) + - [WindowSceneDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/WindowSceneDelegate): + Additional methods that you can use to manage application specific tasks + occurring in a scene. + - [TraitEnvironment](https://compnerd.github.io/swift-win32/SwiftWin32/TraitEnvironment): + A set of methods that makes the interface environment available to your + application. + - [Appearance](https://compnerd.github.io/swift-win32/SwiftWin32/Appearance): + A collection of methods that gives you access to the appearance proxy for a + class. + - [AppearanceContainer](https://compnerd.github.io/swift-win32/SwiftWin32/AppearanceContainer): + A protocol that a class must adopt to allow appearance customization using + the `Appearance` API. + - [ConfigurationState](https://compnerd.github.io/swift-win32/SwiftWin32/ConfigurationState): + The requirements for an object that encapsulate a view's state. + - [ContentConfiguration](https://compnerd.github.io/swift-win32/SwiftWin32/ContentConfiguration): + The requirements for an object that provides the configuration for a content + view. + - [ContentView](https://compnerd.github.io/swift-win32/SwiftWin32/ContentView): + The requirements for a content view that you create using a configuration. + - [\_TriviallyConstructible](https://compnerd.github.io/swift-win32/SwiftWin32/_TriviallyConstructible) + - [LayoutSupport](https://compnerd.github.io/swift-win32/SwiftWin32/LayoutSupport): + A set of methods that provide layout support and access to layout anchors. + - [SpringLoadedInteractionContext](https://compnerd.github.io/swift-win32/SwiftWin32/SpringLoadedInteractionContext): + The interface an object implements to provide information about a + spring-loaded interaction. + - [FocusAnimationContext](https://compnerd.github.io/swift-win32/SwiftWin32/FocusAnimationContext): + Information about focusing animations being performed by the system. + - [FocusEnvironment](https://compnerd.github.io/swift-win32/SwiftWin32/FocusEnvironment): + A set of methods that define the focus behavior for a branch of the view + hierarchy. + - [FocusItem](https://compnerd.github.io/swift-win32/SwiftWin32/FocusItem): + An object that can become focused. + - [FocusItemContainer](https://compnerd.github.io/swift-win32/SwiftWin32/FocusItemContainer): + The container responsible for providing geometric context to focus items + within a given focus environment. + - [TextInputTraits](https://compnerd.github.io/swift-win32/SwiftWin32/TextInputTraits) + - [ContextMenuInteractionAnimating](https://compnerd.github.io/swift-win32/SwiftWin32/ContextMenuInteractionAnimating): + Methods adopted by system-supplied animator objects when interacting with + context menus. + - [ContextMenuInteractionCommitAnimating](https://compnerd.github.io/swift-win32/SwiftWin32/ContextMenuInteractionCommitAnimating): + Methods adopted by system-supplied animator objects when committing + preview-related animations. + - [ContextMenuInteractionDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/ContextMenuInteractionDelegate): + The methods for providing the set of actions to perform on your content, + and for customizing the preview of that content. + - [MenuBuilder](https://compnerd.github.io/swift-win32/SwiftWin32/MenuBuilder): + An interface for adding and removing menus from a menu system. + - [PointerInteractionAnimating](https://compnerd.github.io/swift-win32/SwiftWin32/PointerInteractionAnimating): + An interface for modifying an interaction animation in coordination with the + pointer effect animations. + - [PointerInteractionDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/PointerInteractionDelegate): + An interface for handling pointer movements within the interaction's view. + - [GestureRecognizerDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/GestureRecognizerDelegate): + A set of methods implemented by the delegate of a gesture recognizer to + fine-tune an application’s gesture-recognition behavior. + - [ContentSizeCategoryAdjusting](https://compnerd.github.io/swift-win32/SwiftWin32/ContentSizeCategoryAdjusting): + A collection of methods that gives controls an easy way to adopt automatic + adjustment to content category changes. + - [ContentSizeCategoryImageAdjusting](https://compnerd.github.io/swift-win32/SwiftWin32/ContentSizeCategoryImageAdjusting): + Methods to determine when to adjust images for different content size + categories. + - [Interaction](https://compnerd.github.io/swift-win32/SwiftWin32/Interaction): + The protocol that an interaction implements to access the view that owns it. + - [ContentContainer](https://compnerd.github.io/swift-win32/SwiftWin32/ContentContainer): + A set of methods for adapting the contents of your view controllers to size + and trait changes. + - [PickerViewDataSource](https://compnerd.github.io/swift-win32/SwiftWin32/PickerViewDataSource): + Mediates between a `PickerView` object and your application's data model for + that picker view. + - [PickerViewDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/PickerViewDelegate): + The delegate of a `PickerView` object must adopt this protocol and implement + at least some of its methods to provide the picker view with the data it + needs to construct itself. + - [TableViewDataSource](https://compnerd.github.io/swift-win32/SwiftWin32/TableViewDataSource) + - [TableViewDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/TableViewDelegate): + Methods for managing selections, configuring section headers and footers, + deleting and reordering cells, and performing other actions in a table view. + - [TextFieldDelegate](https://compnerd.github.io/swift-win32/SwiftWin32/TextFieldDelegate) + - [CoordinateSpace](https://compnerd.github.io/swift-win32/SwiftWin32/CoordinateSpace): + A set of methods for converting between different frames of reference on a + screen. + +# Global Functions + + - [ApplicationMain(\_:​\_:​\_:​\_:​)](https://compnerd.github.io/swift-win32/SwiftWin32/ApplicationMain\(________\)) + +# Extensions + + - [IndexPath](https://compnerd.github.io/swift-win32/SwiftWin32/IndexPath) + - [ListContentConfiguration.TextProperties.TextAlignment](https://compnerd.github.io/swift-win32/SwiftWin32/ListContentConfiguration_TextProperties_TextAlignment) + - [ListContentConfiguration.TextProperties.TextTransform](https://compnerd.github.io/swift-win32/SwiftWin32/ListContentConfiguration_TextProperties_TextTransform) + - [String](https://compnerd.github.io/swift-win32/SwiftWin32/String) diff --git a/SwiftWin32UI/AnyView.md b/SwiftWin32UI/AnyView.md new file mode 100644 index 00000000..1d14a134 --- /dev/null +++ b/SwiftWin32UI/AnyView.md @@ -0,0 +1,46 @@ +--- +layout: default +title: AnyView +parent: SwiftWin32UI +--- +# AnyView + +A type-erased view. + +``` swift +@frozen +public struct AnyView: View +``` + +An `AnyView` allows changing the type of view used in a given view +hierarchy. Whenever the type of view used with an `AnyView` changes, the old +hierarchy is destroyed and a new hierarchy is created for the new type. + +## Inheritance + +[`View`](https://compnerd.github.io/swift-win32/SwiftWin32UI/View) + +## Nested Type Aliases + +### `Body` + +``` swift +public typealias Body = Never +``` + +## Initializers + +### `init(_:)` + +Create an instance that type-erases `view`. + +``` swift +public init(_ view: ViewType) +``` + +### `init(erasing:)` + +``` swift +@_alwaysEmitIntoClient + public init(erasing view: ViewType) +``` diff --git a/SwiftWin32UI/App.md b/SwiftWin32UI/App.md new file mode 100644 index 00000000..0630b6ba --- /dev/null +++ b/SwiftWin32UI/App.md @@ -0,0 +1,55 @@ +--- +layout: default +title: App +parent: SwiftWin32UI +--- +# App + +A type that represents the structure and behaviour of an application. + +``` swift +public protocol App +``` + +## Default Implementations + +### `main()` + +``` swift +public static func main() +``` + +## Requirements + +### Body + +The type of scene representing the content of the application. + +``` swift +associatedtype Body: Scene +``` + +### body + +The content and behaviour of the application. + +``` swift +@SceneBuilder + var body: Self.Body +``` + +### init() + +Creates an instance of the application using the body as the content. + +``` swift +init() +``` + +### main() + +Initializes and runs the application. + +``` swift +static func main() +``` diff --git a/SwiftWin32UI/EmptyView.md b/SwiftWin32UI/EmptyView.md new file mode 100644 index 00000000..6c744592 --- /dev/null +++ b/SwiftWin32UI/EmptyView.md @@ -0,0 +1,32 @@ +--- +layout: default +title: EmptyView +parent: SwiftWin32UI +--- +# EmptyView + +``` swift +@frozen +public struct EmptyView: View +``` + +## Inheritance + +[`View`](https://compnerd.github.io/swift-win32/SwiftWin32UI/View) + +## Nested Type Aliases + +### `Body` + +``` swift +public typealias Body = Never +``` + +## Initializers + +### `init()` + +``` swift +@inlinable + public init() +``` diff --git a/SwiftWin32UI/EquatableView.md b/SwiftWin32UI/EquatableView.md new file mode 100644 index 00000000..af767622 --- /dev/null +++ b/SwiftWin32UI/EquatableView.md @@ -0,0 +1,43 @@ +--- +layout: default +title: EquatableView +parent: SwiftWin32UI +--- +# EquatableView + +A view type that compares itself against its previous value and prevents its +child updating if its new value is the same as its old value. + +``` swift +@frozen +public struct EquatableView: View +``` + +## Inheritance + +[`View`](https://compnerd.github.io/swift-win32/SwiftWin32UI/View) + +## Nested Type Aliases + +### `Body` + +``` swift +public typealias Body = Never +``` + +## Initializers + +### `init(content:)` + +``` swift +@inlinable + public init(content: Content) +``` + +## Properties + +### `content` + +``` swift +public var content: Content +``` diff --git a/SwiftWin32UI/Group.md b/SwiftWin32UI/Group.md new file mode 100644 index 00000000..c1c52d9c --- /dev/null +++ b/SwiftWin32UI/Group.md @@ -0,0 +1,33 @@ +--- +layout: default +title: Group +parent: SwiftWin32UI +--- +# Group + +An affordance for grouping view content. + +``` swift +@frozen +public struct Group +``` + +## Inheritance + +`CustomStringConvertible` + +## Nested Type Aliases + +### `Body` + +``` swift +public typealias Body = Never +``` + +## Properties + +### `description` + +``` swift +public var description: String +``` diff --git a/SwiftWin32UI/Label.md b/SwiftWin32UI/Label.md new file mode 100644 index 00000000..77c07429 --- /dev/null +++ b/SwiftWin32UI/Label.md @@ -0,0 +1,30 @@ +--- +layout: default +title: Label +parent: SwiftWin32UI +--- +# Label + +``` swift +public struct Label +``` + +## Inheritance + +[`View`](https://compnerd.github.io/swift-win32/SwiftWin32UI/View) + +## Nested Type Aliases + +### `Body` + +``` swift +public typealias Body = SwiftWin32.Label +``` + +## Properties + +### `body` + +``` swift +public var body: SwiftWin32.Label +``` diff --git a/SwiftWin32UI/Never.md b/SwiftWin32UI/Never.md new file mode 100644 index 00000000..b51e035e --- /dev/null +++ b/SwiftWin32UI/Never.md @@ -0,0 +1,14 @@ +--- +layout: default +title: Never +parent: SwiftWin32UI +--- +# Extensions on Never + +## Nested Type Aliases + +### `Body` + +``` swift +public typealias Body = Never +``` diff --git a/SwiftWin32UI/Scene.md b/SwiftWin32UI/Scene.md new file mode 100644 index 00000000..57271b0e --- /dev/null +++ b/SwiftWin32UI/Scene.md @@ -0,0 +1,31 @@ +--- +layout: default +title: Scene +parent: SwiftWin32UI +--- +# Scene + +A part of the application's user interface. + +``` swift +public protocol Scene +``` + +## Requirements + +### Body + +The type of scene representing the body of this scene. + +``` swift +associatedtype Body: Scene +``` + +### body + +The content and behaviour of the scene. + +``` swift +@SceneBuilder + var body: Self.Body +``` diff --git a/SwiftWin32UI/SceneBuilder.md b/SwiftWin32UI/SceneBuilder.md new file mode 100644 index 00000000..d46526cd --- /dev/null +++ b/SwiftWin32UI/SceneBuilder.md @@ -0,0 +1,19 @@ +--- +layout: default +title: SceneBuilder +parent: SwiftWin32UI +--- +# SceneBuilder + +``` swift +@resultBuilder +public struct SceneBuilder +``` + +## Methods + +### `buildBlock(_:)` + +``` swift +public static func buildBlock(_ content: Content) -> Content +``` diff --git a/SwiftWin32UI/SwiftWin32_Label.md b/SwiftWin32UI/SwiftWin32_Label.md new file mode 100644 index 00000000..75f61ef0 --- /dev/null +++ b/SwiftWin32UI/SwiftWin32_Label.md @@ -0,0 +1,14 @@ +--- +layout: default +title: SwiftWin32.Label +parent: SwiftWin32UI +--- +# Extensions on SwiftWin32.Label + +## Nested Type Aliases + +### `Body` + +``` swift +public typealias Body = Never +``` diff --git a/SwiftWin32UI/UIApplicationDelegateAdaptor.md b/SwiftWin32UI/UIApplicationDelegateAdaptor.md new file mode 100644 index 00000000..e744b389 --- /dev/null +++ b/SwiftWin32UI/UIApplicationDelegateAdaptor.md @@ -0,0 +1,34 @@ +--- +layout: default +title: UIApplicationDelegateAdaptor +parent: SwiftWin32UI +--- +# UIApplicationDelegateAdaptor + +A property wrapper that is used in `App` to provide an application delegate +from Swift/Win32. + +``` swift +@propertyWrapper +public struct UIApplicationDelegateAdaptor +``` + +## Initializers + +### `init(_:)` + +Creates an `UIApplicationDelegateAdaptor` using an ApplicationDelegate. + +``` swift +public init(_ delegateType: DelegateType.Type = DelegateType.self) +``` + +## Properties + +### `wrappedValue` + +The underlying delegate. + +``` swift +public private(set) var wrappedValue: DelegateType +``` diff --git a/SwiftWin32UI/View.md b/SwiftWin32UI/View.md new file mode 100644 index 00000000..1ae712b0 --- /dev/null +++ b/SwiftWin32UI/View.md @@ -0,0 +1,40 @@ +--- +layout: default +title: View +parent: SwiftWin32UI +--- +# View + +A type that represents part of your app’s user interface and provides +modifiers that you use to configure views. + +``` swift +public protocol View +``` + +## Default Implementations + +### `body` + +``` swift +public var body: Never +``` + +## Requirements + +### Body + +The type of view representing the body of this view. + +``` swift +associatedtype Body: View +``` + +### body + +The content and behavior of the view. + +``` swift +@ViewBuilder + var body: Self.Body +``` diff --git a/SwiftWin32UI/ViewBuilder.md b/SwiftWin32UI/ViewBuilder.md new file mode 100644 index 00000000..96099232 --- /dev/null +++ b/SwiftWin32UI/ViewBuilder.md @@ -0,0 +1,25 @@ +--- +layout: default +title: ViewBuilder +parent: SwiftWin32UI +--- +# ViewBuilder + +``` swift +@resultBuilder +public struct ViewBuilder +``` + +## Methods + +### `buildBlock()` + +``` swift +public static func buildBlock() -> EmptyView +``` + +### `buildBlock(_:)` + +``` swift +public static func buildBlock(_ content: Content) -> Content +``` diff --git a/SwiftWin32UI/WindowGroup.md b/SwiftWin32UI/WindowGroup.md new file mode 100644 index 00000000..1bf9c292 --- /dev/null +++ b/SwiftWin32UI/WindowGroup.md @@ -0,0 +1,34 @@ +--- +layout: default +title: WindowGroup +parent: SwiftWin32UI +--- +# WindowGroup + +A scene that presents a group of identically structured windows. + +``` swift +public struct WindowGroup: Scene +``` + +## Inheritance + +[`Scene`](https://compnerd.github.io/swift-win32/SwiftWin32UI/Scene) + +## Initializers + +### `init(content:)` + +Creates a window group. + +``` swift +public init(@ViewBuilder content: () -> Content) +``` + +## Properties + +### `body` + +``` swift +public var body: some Scene +``` diff --git a/SwiftWin32UI/_Footer.md b/SwiftWin32UI/_Footer.md new file mode 100644 index 00000000..d692cbda --- /dev/null +++ b/SwiftWin32UI/_Footer.md @@ -0,0 +1 @@ +Generated at 2022-06-25T22:36:06+0000 using [swift-doc](https://github.com/SwiftDocOrg/swift-doc) 1.0.0-beta.6. diff --git a/SwiftWin32UI/_Sidebar.md b/SwiftWin32UI/_Sidebar.md new file mode 100644 index 00000000..74847168 --- /dev/null +++ b/SwiftWin32UI/_Sidebar.md @@ -0,0 +1,31 @@ +
+Types + + - [AnyView](https://compnerd.github.io/swift-win32/SwiftWin32UI/AnyView) + - [EmptyView](https://compnerd.github.io/swift-win32/SwiftWin32UI/EmptyView) + - [EquatableView](https://compnerd.github.io/swift-win32/SwiftWin32UI/EquatableView) + - [Group](https://compnerd.github.io/swift-win32/SwiftWin32UI/Group) + - [Label](https://compnerd.github.io/swift-win32/SwiftWin32UI/Label) + - [SceneBuilder](https://compnerd.github.io/swift-win32/SwiftWin32UI/SceneBuilder) + - [UIApplicationDelegateAdaptor](https://compnerd.github.io/swift-win32/SwiftWin32UI/UIApplicationDelegateAdaptor) + - [ViewBuilder](https://compnerd.github.io/swift-win32/SwiftWin32UI/ViewBuilder) + - [WindowGroup](https://compnerd.github.io/swift-win32/SwiftWin32UI/WindowGroup) + +
+ +
+Protocols + + - [App](https://compnerd.github.io/swift-win32/SwiftWin32UI/App) + - [Scene](https://compnerd.github.io/swift-win32/SwiftWin32UI/Scene) + - [View](https://compnerd.github.io/swift-win32/SwiftWin32UI/View) + +
+ +
+Extensions + + - [Never](https://compnerd.github.io/swift-win32/SwiftWin32UI/Never) + - [SwiftWin32.Label](https://compnerd.github.io/swift-win32/SwiftWin32UI/SwiftWin32.Label) + +
diff --git a/SwiftWin32UI/index.md b/SwiftWin32UI/index.md new file mode 100644 index 00000000..15653712 --- /dev/null +++ b/SwiftWin32UI/index.md @@ -0,0 +1,38 @@ +--- +layout: default +title: SwiftWin32UI +has_children: true +--- +# Types + + - [SceneBuilder](https://compnerd.github.io/swift-win32/SwiftWin32UI/SceneBuilder) + - [WindowGroup](https://compnerd.github.io/swift-win32/SwiftWin32UI/WindowGroup): + A scene that presents a group of identically structured windows. + - [EmptyView](https://compnerd.github.io/swift-win32/SwiftWin32UI/EmptyView) + - [UIApplicationDelegateAdaptor](https://compnerd.github.io/swift-win32/SwiftWin32UI/UIApplicationDelegateAdaptor): + A property wrapper that is used in `App` to provide an application delegate + from Swift/Win32. + - [AnyView](https://compnerd.github.io/swift-win32/SwiftWin32UI/AnyView): + A type-erased view. + - [EquatableView](https://compnerd.github.io/swift-win32/SwiftWin32UI/EquatableView): + A view type that compares itself against its previous value and prevents its + child updating if its new value is the same as its old value. + - [Group](https://compnerd.github.io/swift-win32/SwiftWin32UI/Group): + An affordance for grouping view content. + - [Label](https://compnerd.github.io/swift-win32/SwiftWin32UI/Label) + - [ViewBuilder](https://compnerd.github.io/swift-win32/SwiftWin32UI/ViewBuilder) + +# Protocols + + - [App](https://compnerd.github.io/swift-win32/SwiftWin32UI/App): + A type that represents the structure and behaviour of an application. + - [Scene](https://compnerd.github.io/swift-win32/SwiftWin32UI/Scene): + A part of the application's user interface. + - [View](https://compnerd.github.io/swift-win32/SwiftWin32UI/View): + A type that represents part of your app’s user interface and provides + modifiers that you use to configure views. + +# Extensions + + - [Never](https://compnerd.github.io/swift-win32/SwiftWin32UI/Never) + - [SwiftWin32.Label](https://compnerd.github.io/swift-win32/SwiftWin32UI/SwiftWin32_Label) diff --git a/_config.yml b/_config.yml new file mode 100644 index 00000000..98984e9a --- /dev/null +++ b/_config.yml @@ -0,0 +1,67 @@ +# Welcome to Jekyll! +# +# This config file is meant for settings that affect your whole blog, values +# which you are expected to set up once and rarely edit after that. If you find +# yourself editing this file very often, consider using Jekyll's data files +# feature for the data you need to update frequently. +# +# For technical reasons, this file is *NOT* reloaded automatically when you use +# 'bundle exec jekyll serve'. If you change this file, please restart the server process. +# +# If you need help with YAML syntax, here are some quick references for you: +# https://learn-the-web.algonquindesign.ca/topics/markdown-yaml-cheat-sheet/#yaml +# https://learnxinyminutes.com/docs/yaml/ +# +# Site settings +# These are used to personalize your new site. If you look in the HTML files, +# you will see them accessed via {{ site.title }}, {{ site.email }}, and so on. +# You can create any custom variable you would like, and they will be accessible +# in the templates via {{ site.myvariable }}. + +title: Swift/Win32 +email: compnerd@compnerd.org +description: >- # this means to ignore newlines until "baseurl:" + A Swift Application Framework for Windows +baseurl: "/swift-win32" # the subpath of your site, e.g. /blog +url: "https://compnerd.github.io" # the base hostname & protocol for your site, e.g. http://example.com +twitter_username: compnerd +github_username: compnerd + +# Build settings +remote_theme: pmarsceill/just-the-docs +plugins: + - jekyll-feed + +# Exclude from processing. +# The following items will not be processed, by default. +# Any item listed under the `exclude:` key here will be automatically added to +# the internal "default list". +# +# Excluded items can be processed by explicitly listing the directories or +# their entries' file path in the `include:` list. +# +# exclude: +# - .sass-cache/ +# - .jekyll-cache/ +# - gemfiles/ +# - Gemfile +# - Gemfile.lock +# - node_modules/ +# - vendor/bundle/ +# - vendor/cache/ +# - vendor/gems/ +# - vendor/ruby/ +include: + - "SwiftWin32/_*" + +search_enabled: true +search: + heading_level: 2 + previews: 2 + preview_words_before: 3 + preview_words_after: 3 + tokenizer_separator: /[\s/]+/ + rel_url: true + button: true + +heading_anchors: true diff --git a/index.md b/index.md new file mode 100644 index 00000000..7213164c --- /dev/null +++ b/index.md @@ -0,0 +1,12 @@ +--- +# Feel free to add content and custom Front Matter to this file. +# To modify the layout, see https://jekyllrb.com/docs/themes/#overriding-theme-defaults + +layout: home +--- + +Swift/Win32 aims to provide a [MVC](https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller) model for writing applications on Windows. It provides Swift friendly wrapping of the Win32 APIs much like [MFC](https://en.wikipedia.org/wiki/Microsoft_Foundation_Class_Library) did for C++. + +

+ Swift/Win32 Screenshot +

diff --git a/media/images/screenshot.png b/media/images/screenshot.png new file mode 100644 index 0000000000000000000000000000000000000000..3102e78a935260449c23fb62cc9fb504d9a04149 GIT binary patch literal 132237 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 literal 0 HcmV?d00001