Merge pull request #9272 from mendix/Mendix-11

Mendix 11 Beta 1

Author: MariaShaposhnikova

content/en/docs/apidocs-mxsdk/apidocs/_index.md

@@ -9,6 +9,7 @@ aliases:
     - /apidocs/
     - /apidocs-mxsdk/apidocs/authentication/
     - /apidocs/index.html
+    - /apidocs-mxsdk/apidocs/runtime-api/
 #If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details.
 ---
 

content/en/docs/apidocs-mxsdk/apidocs/studio-pro-10/_index.md

@@ -0,0 +1,11 @@
+---
+title: "APIs for Studio Pro 10"
+url: /apidocs-mxsdk/apidocs/apis-for-studio-pro-10/
+no_list: false
+description_list: true
+description: "Provides the documentation of APIs for Studio Pro 10, including Extensibility API and Mendix Runtime API."
+weight: 5
+linktitle: "Studio Pro 10"
+---
+
+Mendix offers the following APIs for Studio Pro 10:

content/en/docs/apidocs-mxsdk/apidocs/studio-pro/extensibility-api/_index.md renamed to content/en/docs/apidocs-mxsdk/apidocs/studio-pro-10/extensibility-api/_index.md

@@ -1,6 +1,6 @@
 ---
 title: "Extensibility API"
-url: /apidocs-mxsdk/apidocs/extensibility-api/
+url: /apidocs-mxsdk/apidocs/extensibility-api-10/
 description: "The Extensibility API allows you to extend Studio Pro by adding custom functionality."
 weight: 57
 no_list: false

content/en/docs/apidocs-mxsdk/apidocs/studio-pro-10/extensibility-api/csharp/_index.md

@@ -0,0 +1,65 @@
+---
+title: "Extensibility API for C# Developers"
+linktitle: "C# Extensibility API"
+url: /apidocs-mxsdk/apidocs/csharp-extensibility-api-10/
+description: "The C# extensibility API allows your custom Studio Pro extensions developed in C# to interact with some internal services of Studio Pro."
+weight: 10
+no_list: false
+description_list: true
+aliases:
+    - /apidocs-mxsdk/apidocs/extensibility-api/
+---
+
+{{% alert color="warning" %}}
+This feature is in beta. For more information, see [Beta Releases](/releasenotes/beta-features/).
+{{% /alert %}}
+
+{{% alert color="info" %}}
+For information on new releases of the Extensibility API, see [Extensibility: C# API Release Notes](/releasenotes/studio-pro/csharp-extensibility-api/).
+{{% /alert %}}
+
+## Introduction
+
+Extensions can be written in C#, described here, or using a web API which is documented separately in [Extensibility API for Web Developers](/apidocs-mxsdk/apidocs/web-extensibility-api-10/).
+
+If you need to add your own custom UI to Studio Pro, you can achieve this using web technology. Your web-based UI will be rendered in Studio Pro using a hosted web view, the API provides communication functionality between your web UI and the C# extension logic.
+
+## Prerequisites
+
+* You need at least a basic understanding of the Mendix platform.
+* You need some understanding of the Mendix Model.
+* You need to have some C# development experience. Extensions are developed using [C#](https://docs.microsoft.com/en-us/dotnet/), and compiled into a `.dll` assembly file.
+
+## Getting Started
+
+For detailed explanation on how to get started with extensions, check out [Get Started with the Extensibility API](/apidocs-mxsdk/apidocs/csharp-extensibility-api-10/get-started/).
+
+You can also check out our examples and [API reference documentation](https://github.com/mendix/ExtensionAPI-Samples).
+
+## How-tos
+
+Here is a list of how-tos for you to begin with:
+
+* [How to Create a Menu Extension Using C#](/apidocs-mxsdk/apidocs/csharp-extensibility-api-10/create-menu-extension/)
+* [How to Create a Dockable Pane Extension Using C#](/apidocs-mxsdk/apidocs/csharp-extensibility-api-10/create-dockable-pane-extension/)
+* [How to Create a Context Menu Using C#](/apidocs-mxsdk/apidocs/csharp-extensibility-api-10/create-context-menu/)
+* [How to Create a Web View Hosted Inside a Modal Dialog Using C#](/apidocs-mxsdk/apidocs/csharp-extensibility-api-10/create-modal-web-view/)
+* [How to Create Microflows for Calculations Using C#](/apidocs-mxsdk/apidocs/csharp-extensibility-api-10/create-microflows-for-calculations/)
+
+## Advanced APIs
+
+APIs for the Mendix platform's advanced users:
+
+* [Use the Untyped Model Access API Using C#](/apidocs-mxsdk/apidocs/untyped-model-access-api-10/)
+
+## Learn More
+
+You can dive into the following topics in depth:
+
+* [What are extension points](/apidocs-mxsdk/apidocs/csharp-extensibility-api-10/extension-points/)
+* [What are the Extensibility API services](/apidocs-mxsdk/apidocs/csharp-extensibility-api-10/services/)
+* [How to Interact with the Model API Using C#](/apidocs-mxsdk/apidocs/interact-with-model-api-10/)
+* [How to host web content via a web view wrapper](/apidocs-mxsdk/apidocs/csharp-extensibility-api-10/web-views/)
+* [How to Build a Todo Example Extension Using C#](/apidocs-mxsdk/apidocs/csharp-extensibility-api-10/build-todo-example-extension/)
+
+## Documentation in This Category

content/en/docs/apidocs-mxsdk/apidocs/studio-pro-10/extensibility-api/csharp/extensibility-api-howtos/_index.md

@@ -0,0 +1,12 @@
+---
+title: "C# Extensibility API How-tos"
+linktitle: "How-tos"
+url: /apidocs-mxsdk/apidocs/csharp-extensibility-api-10/how-tos/
+weight: 3
+no_list: false
+description_list: true
+---
+
+## Introduction
+
+The following how-tos teach you how to use the Extensibility API for C# Developers in different use cases.

content/en/docs/apidocs-mxsdk/apidocs/studio-pro-10/extensibility-api/csharp/extensibility-api-howtos/add-menu.md

@@ -0,0 +1,66 @@
+---
+title: "Add Menus and Submenus to Studio Pro Using C#"
+linktitle: "Structured Menus"
+url: /apidocs-mxsdk/apidocs/csharp-extensibility-api-10/add-menu/
+weight: 15
+---
+
+## Introduction
+
+This how-to describes how you can add a menu that contains submenus, some of which also contain submenus of their own. Before you start this how-to, it is recommended to [Create a Menu Extension Using C#](/apidocs-mxsdk/apidocs/csharp-extensibility-api-10/create-menu-extension/) first.
+
+You can download the example in this how-to in [this GitHub repository](https://github.com/mendix/ExtensionAPI-Samples).
+
+## Creating Menu Extension Class
+
+1. Open the project that you previously created when you followed [Create a Menu Extension Using C#](/apidocs-mxsdk/apidocs/csharp-extensibility-api-10/create-menu-extension/).
+2. Add a new class to the project and name it `MyMenuExtension.cs`.
+3. Replace the code in the file with the following code:
+
+    ```csharp
+    using Mendix.StudioPro.ExtensionsAPI.UI.Menu;
+    using Mendix.StudioPro.ExtensionsAPI.UI.Services;
+    using System.ComponentModel.Composition;
+    
+    namespace MyCompany.MyProject.MendixExtension;
+    
+    [Export(typeof(MenuExtension))]
+    public class MyMenuExtension : MenuExtension
+    {
+        readonly IMessageBoxService messageBoxService;
+    
+        [ImportingConstructor]
+        public MyMenuExtension(IMessageBoxService messageBoxService)
+        {
+            this.messageBoxService = messageBoxService;
+        }
+    
+        public override IEnumerable<MenuViewModel> GetMenus()
+        {
+            var ristretto = new MenuViewModel("Ristretto", () => messageBoxService.ShowInformation("Ristretto"));
+            var regularExpresso = new MenuViewModel("Regular Espresso", () => messageBoxService.ShowInformation("Regular Espresso"));
+            var espresso = new MenuViewModel("Espresso", [regularExpresso, ristretto]);
+            var blackCoffee = new MenuViewModel("Black Coffee", () => messageBoxService.ShowInformation("Black Coffee"));
+            var decaf = new MenuViewModel("Decaf", () => messageBoxService.ShowInformation("Decaf")) { Separator = MenuSeparator.After };
+            var coffee = new MenuViewModel("Coffee", [blackCoffee, decaf, espresso]);
+    
+            var tea = new MenuViewModel("Tea", () => messageBoxService.ShowInformation("Tea"));
+    
+            var hot = new MenuViewModel("Hot", [coffee, tea]);
+    
+            var soda = new MenuViewModel("Soda", () => messageBoxService.ShowInformation("Soda"));
+            var cold = new MenuViewModel("Cold", [soda]);
+    
+            var beverages = new MenuViewModel("Beverages", [hot, cold]);
+            yield return beverages;
+        }
+    }
+    ```
+
+The code above creates a single menu, `Beverages`, which contains the submenus `Hot` and `Cold`, both of which contain some submenus. Note that when you are creating this menu structure, you only return the main parent menu (in this example, the `Beverages` menu) from the `GetMenus` method. You should only return the topmost parents in your list, so only the ones that do not have a parent should be returned. In the example above, there is only one.
+
+If an app contains one or more extensions, a top-level menu named `Extensions` will appear in the main menu bar of Studio Pro. Menus that are created from `MenuExtension` implementations will be grouped by their extension entry point name (in this example, `MyCompany`), and then placed under their own dedicated submenu under the main `Extensions` top-level menu. For example, the `MyMenuExtension` above will be placed as follows: **Extensions** > **MyCompany** > **MyMenuExtension**.
+
+A menu can only be a parent (namely, a menu that contains submenus) or have an action. You cannot create a menu with an action which also contains submenus.
+
+You can add a `MenuSeparator` to a menu, via the `Separator` property. Options are `After`, `Before` or `None`. The default value is `None`. You can also disable a menu by setting its `IsEnabled` property to `false`. Menus are enabled by default.