diff --git a/MacCollectionNew/Readme.md b/MacCollectionNew/Readme.md index 8dd47cb7..1c21906e 100644 --- a/MacCollectionNew/Readme.md +++ b/MacCollectionNew/Readme.md @@ -1,6 +1,6 @@ --- name: Xamarin.Mac - MacCollectionNew -description: Source code for the Collection Views documentation on Xamarin Developer Center Uses Xamarin.Mac. This project covers working with Data Binding and... +description: This project covers working with Data Binding and new version of the Collection View API on macOS. page_type: sample languages: - csharp @@ -10,8 +10,19 @@ urlFragment: maccollectionnew --- # MacCollectionNew -Source code for the [Collection Views](/guides/mac/user-interface/working-with-collection-views/) documentation on [Xamarin Developer Center](http://docs.xamarin.com) +Source code for the [Collection Views](https://docs.microsoft.com/xamarin/mac/user-interface/collection-view) documentation on [Xamarin Developer Center](http://docs.microsoft.com/xamarin) -Uses [Xamarin.Mac](http://xamarin.com). +This project covers working with Data Binding and new version of the Collection View API (`NSCollectionView`) -This project covers working with Data Binding and new version of the Collection View API (`NSCollectionView`) \ No newline at end of file +![Mac app with collection view](Screenshots/01.png) + +## Prerequisites + +* Mac computer with the latest version of macOS. +* [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/). +* Latest version of [Xcode](https://developer.apple.com/xcode/) from Apple. + +## Running the sample + +1. Open the solution file (**.sln**) in Visual Studio for Mac. +1. Use the **Run** button or menu to start the app. diff --git a/MacControls/Readme.md b/MacControls/Readme.md index 3dae6ab7..f5fabe10 100644 --- a/MacControls/Readme.md +++ b/MacControls/Readme.md @@ -10,12 +10,23 @@ urlFragment: maccontrols --- # MacControls -Source code for the [Standard Controls](/guides/mac/user-interface/standard-controls/) documentation on [Xamarin Developer Center](http://docs.xamarin.com) - -Uses [Xamarin.Mac](http://xamarin.com). +Source code for the [Standard Controls]https://docs.microsoft.com/xamarin/mac/user-interface/standard-controls) documentation on [Xamarin Developer Center](http://docs.microsoft.com/xamarin) When working with C# and .NET in a Xamarin.Mac application, you have access to the same Standard AppKit Controls that a developer working in in *Objective-C* and *Xcode* does. AppKit Controls are the UI Elements that are used to create the User Interface of your Xamarin.Mac application. They consist of elements such as Buttons, Labels, Text Fields, Check Boxes and Segmented Controls and cause instant actions or visible results when a user manipulates them. -This sample application covers working with the standard AppKit controls such as Buttons, Labels, Text Fields, Check Boxes and Segmented Controls in a Xamarin.Mac application. \ No newline at end of file +This sample application covers working with the standard AppKit controls such as Buttons, Labels, Text Fields, Check Boxes and Segmented Controls in a Xamarin.Mac application. + +![Mac app showing various control types](Screenshots/01.png) + +## Prerequisites + +* Mac computer with the latest version of macOS. +* [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/). +* Latest version of [Xcode](https://developer.apple.com/xcode/) from Apple. + +## Running the sample + +1. Open the solution file (**.sln**) in Visual Studio for Mac. +1. Use the **Run** button or menu to start the app. diff --git a/MacDatabase/Readme.md b/MacDatabase/Readme.md index b528ece9..49f41f0d 100644 --- a/MacDatabase/Readme.md +++ b/MacDatabase/Readme.md @@ -10,8 +10,19 @@ urlFragment: macdatabase --- # MacDatabase -Source code for the [Working with SQLite Databases](/guides/mac/application_fundamentals/databases/) documentation on [Xamarin Developer Center](http://docs.xamarin.com) +Source code for the [Working with SQLite Databases](https://docs.microsoft.com/xamarin/mac/app-fundamentals/databases) documentation on [Xamarin Developer Center](http://docs.microsoft.com/xamarin) -Uses [Xamarin.Mac](http://xamarin.com). +This project covers working with SQLite Databases through direct access and Data Binding and Key-Value Coding in a Xamarin.Mac application. It also covers using the SQLite.Net ORM to read and write SQLite data that will be displayed in a Table View. -This project covers working with SQLite Databases through direct access and Data Binding and Key-Value Coding in a Xamarin.Mac application. It also covers using the SQLite.Net ORM to read and write SQLite data that will be displayed in a Table View. \ No newline at end of file +![Mac table showing database data](Screenshots/01.png) + +## Prerequisites + +* Mac computer with the latest version of macOS. +* [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/). +* Latest version of [Xcode](https://developer.apple.com/xcode/) from Apple. + +## Running the sample + +1. Open the solution file (**.sln**) in Visual Studio for Mac. +1. Use the **Run** button or menu to start the app. diff --git a/MacDatabinding-Storyboard/Readme.md b/MacDatabinding-Storyboard/Readme.md index e04150b9..073a8856 100644 --- a/MacDatabinding-Storyboard/Readme.md +++ b/MacDatabinding-Storyboard/Readme.md @@ -1,6 +1,6 @@ --- name: Xamarin.Mac - MacDatabinding Storyboard -description: Source code for the Data Binding and Key-Value Coding documentation on Xamarin Developer Center Uses Xamarin.Mac. This project covers working with... +description: This project covers working with Data Binding and Key-Value Coding in a Xamarin.Mac application page_type: sample languages: - csharp @@ -10,8 +10,19 @@ urlFragment: macdatabinding-storyboard --- # MacDatabinding Storyboard -Source code for the [Data Binding and Key-Value Coding](/guides/mac/application_fundamentals/databinding/) documentation on [Xamarin Developer Center](http://docs.xamarin.com) +Source code for the [Data Binding and Key-Value Coding](https://docs.microsoft.com/xamarin/mac/app-fundamentals/databinding) documentation on [Xamarin Developer Center](http://docs.microsoft.com/xamarin) -Uses [Xamarin.Mac](http://xamarin.com). +This project covers working with Data Binding and Key-Value Coding in a Xamarin.Mac application (using a `.storyboard` files) from simple control binding to Table View & Outlines and finally covers Collection Views (`NSCollectionView`). -This project covers working with Data Binding and Key-Value Coding in a Xamarin.Mac application (using a `.storyboard` files) from simple control binding to Table View & Outlines and finally covers Collection Views (`NSCollectionView`). \ No newline at end of file +![Mac app using data binding](Screenshots/01.png) + +## Prerequisites + +* Mac computer with the latest version of macOS. +* [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/). +* Latest version of [Xcode](https://developer.apple.com/xcode/) from Apple. + +## Running the sample + +1. Open the solution file (**.sln**) in Visual Studio for Mac. +1. Use the **Run** button or menu to start the app. diff --git a/MacInspector/Documentation/ReadMe.md b/MacInspector/Documentation/ReadMe.md index 9c719117..392c66ab 100644 --- a/MacInspector/Documentation/ReadMe.md +++ b/MacInspector/Documentation/ReadMe.md @@ -2,15 +2,15 @@ Most modern OS X applications present auxiliary controls and options that affect the active document or selection as **Inspectors** that are part of the Main Window (like Apple's Pages or Numbers apps), instead of using [Panel Windows](https://developer.xamarin.com/guides/mac/user-interface/working-with-windows/#Panels). -While **Panel Windows** have been deprecated in Storyboards, Apple does not provide a specific User Interface Widget to build **Inspectors**. Instead the developer must use `NSSplitViewControllers` and standard UI Widgets (such as Checkboxes and Text Fields) to create the [Inspector Interface](/guides/mac/user-interface/working-with-windows/#Inspectors). +While **Panel Windows** have been deprecated in Storyboards, Apple does not provide a specific User Interface Widget to build **Inspectors**. Instead the developer must use `NSSplitViewControllers` and standard UI Widgets (such as Checkboxes and Text Fields) to create the [Inspector Interface](https://docs.microsoft.com/xamarin/mac/user-interface/window#inspectors). -This app shows an example of creating two different types of Inspector Panels and running those panels with a Split View. It also uses a [Segment Control](/guides/mac/user-interface/standard-controls/#Working_with_Selection_Controls) in the [Toolbar](/guides/mac/user-interface/working-with-toolbars/) to control the **Inspector** similar to Apple's Pages word processing app. +This app shows an example of creating two different types of Inspector Panels and running those panels with a Split View. It also uses a [Segment Control](https://docs.microsoft.com/xamarin/mac/user-interface/standard-controls#working-with-selection-controls) in the [Toolbar](https://docs.microsoft.com/xamarin/mac/user-interface/toolbar) to control the **Inspector** similar to Apple's Pages word processing app. -# Implementation +## Implementation The following sections will briefly discuss the key source code components and how they were used to implement MacInspector's functionality. -## Generic Classes +### Generic Classes The following generic classes are defined: @@ -18,11 +18,11 @@ The following generic classes are defined: * **DocumentProperties.cs** - Provides a set of adjustable properties for the document being edited and exposes those properties via [Key-Value Coding and Data Binding](https://developer.xamarin.com/guides/mac/application_fundamentals/databinding/). * **ReplaceInspectorPanelSegue.cs** - Creates a custom Segue type that is used to show new **Inspector Panels** in the **Inspector**. -## Resources +### Resources Provides the custom Toolbar images used in MacInspector. -## App, Windows and Controllers +### App, Windows and Controllers The following classes provide app support, Windows, Windows Controllers, View and View Controller Support in the application: @@ -32,12 +32,11 @@ The following classes provide app support, Windows, Windows Controllers, View an * **DocPrefsViewController.cs** - Handles the **Inspector Panel** for the `DocumentProperties` for the window. It uses [Key-Value Coding and Data Binding](https://developer.xamarin.com/guides/mac/application_fundamentals/databinding/) to maintain the values. * **Entitlements.plist** - Controls any Entitlements for the app such as Sandboxing or iCloud support. * **Info.plist** - The [`Info.plist`](https://developer.xamarin.com/guides/mac/getting_started/hello,_mac/#Info.plist) file defines information for the app such as its Title, Type and Icon. -* **InspectorViewController.cs** - Handles the [Inspector Interface](/guides/mac/user-interface/working-with-windows/#Inspectors) and controls the hiding and displaying of **Inspector Panels**. +* **InspectorViewController.cs** - Handles the [Inspector Interface](https://docs.microsoft.com/xamarin/mac/user-interface/window#Inspectors) and controls the hiding and displaying of **Inspector Panels**. * **Main.cs** - The [`Main.cs`](https://developer.xamarin.com/guides/mac/getting_started/hello,_mac/#Main.cs) file starts the App. * **Main.storyboard** - This [Storyboard](https://developer.xamarin.com/guides/mac/platform-features/storyboards/) defines the User Interface for the app. Use Xcode's Interface Builder to edit. * **MainSplitViewController.cs** - Handles the Split View used to contain the document content on the left and the **Inspector** on the right. Contains routines to help the Content communicate with the **Inspector**. * **MainWindow.cs** - Defines the main window for the app. -* **MainWindowController.cs** - Handles the `MainWindow` for the app and controls the [Toolbar](/guides/mac/user-interface/working-with-toolbars/) for the window. +* **MainWindowController.cs** - Handles the `MainWindow` for the app and controls the [Toolbar](https://docs.microsoft.com/xamarin/mac/user-interface/toolbar) for the window. For more detailed descriptions, please see the [API Documentation](html/index.html) for the MacInspector source code. - diff --git a/MacXibless/Readme.md b/MacXibless/Readme.md index 9566db40..22b11024 100644 --- a/MacXibless/Readme.md +++ b/MacXibless/Readme.md @@ -10,8 +10,19 @@ urlFragment: macxibless --- # MacXibless -Source code for the [.XIBless User Interface Design](/guides/mac/application_fundamentals/xibless-ui) documentation on [Xamarin Developer Center](http://docs.xamarin.com) +Source code for the [.XIBless User Interface Design](https://docs.microsoft.com/xamarin/mac/app-fundamentals/xibless-ui) documentation on [Xamarin Developer Center](http://docs.microsoft.com/xamarin). -Uses [Xamarin.Mac](http://xamarin.com). +This project covers creating a Xamarin.Mac Application's User Interface directly from C# code without using Xcode's Interface Builder or `.xib` files. -This project covers creating a Xamarin.Mac Application's User Interface directly from C# code without using Xcode's Interface Builder or `.xib` files. \ No newline at end of file +![Mac app built without a XIB file](Screenshots/01.png) + +## Prerequisites + +* Mac computer with the latest version of macOS. +* [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/). +* Latest version of [Xcode](https://developer.apple.com/xcode/) from Apple. + +## Running the sample + +1. Open the solution file (**.sln**) in Visual Studio for Mac. +1. Use the **Run** button or menu to start the app.