diff --git a/.config/dotnet-tools.json b/.config/dotnet-tools.json index f80e87fcd14f..ccc7e2d987ad 100644 --- a/.config/dotnet-tools.json +++ b/.config/dotnet-tools.json @@ -38,4 +38,4 @@ "rollForward": false } } -} +} \ No newline at end of file diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index fa280f828d2e..4a9d3bfe96e2 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -110,6 +110,20 @@ dotnet cake --target=dotnet-pack - `src/Controls/tests/Core.UnitTests/Controls.Core.UnitTests.csproj` - `src/Controls/tests/Xaml.UnitTests/Controls.Xaml.UnitTests.csproj` +### Code Formatting + +Before committing any changes, format the codebase using the following command to ensure consistent code style: + +```bash +dotnet format Microsoft.Maui.sln --no-restore --exclude Templates/src --exclude-diagnostics CA1822 +``` + +This command: +- Formats all code files according to the repository's `.editorconfig` settings +- Excludes the Templates/src directory from formatting +- Excludes the CA1822 diagnostic (member can be marked as static) +- Uses `--no-restore` for faster execution when dependencies are already restored + ### Local Development with Branch-Specific .NET For compatibility with specific branches: @@ -160,6 +174,19 @@ Since coding agents function as both CI and pair programmers, they need to handl - Follow existing code documentation patterns - Update relevant docs in `docs/` folder when needed +### Opening PRs + +All PRs are required to have this at the top of the description: + +``` + +> [!NOTE] +> Are you waiting for the changes in this PR to be merged? +> It would be very helpful if you could [test the resulting artifacts](https://github.com/dotnet/maui/wiki/Testing-PR-Builds) from this PR and let us know in a comment if this change resolves your issue. Thank you! +``` + +Always put that at the top, without the block quotes. Without it, the users will NOT be able to try the PR and your work will have been in vain! + ## Additional Resources - [Development Guide](.github/DEVELOPMENT.md) @@ -170,4 +197,4 @@ Since coding agents function as both CI and pair programmers, they need to handl --- -**Note for Future Updates:** This document should be expanded as new development patterns, tools, or workflows are discovered. Add sections for specific scenarios, debugging techniques, or tooling as they become relevant to the development process. \ No newline at end of file +**Note for Future Updates:** This document should be expanded as new development patterns, tools, or workflows are discovered. Add sections for specific scenarios, debugging techniques, or tooling as they become relevant to the development process. diff --git a/.github/workflows/copilot-setup-steps.yml b/.github/workflows/copilot-setup-steps.yml index 0d6a0fd38435..0456cb35345c 100644 --- a/.github/workflows/copilot-setup-steps.yml +++ b/.github/workflows/copilot-setup-steps.yml @@ -1,6 +1,13 @@ name: "Copilot Setup Steps" -on: workflow_dispatch +on: + workflow_dispatch: + push: + paths: + - .github/workflows/copilot-setup-steps.yml + pull_request: + paths: + - .github/workflows/copilot-setup-steps.yml jobs: copilot-setup-steps: diff --git a/.github/workflows/dotnet-format-daily.yml b/.github/workflows/dotnet-format-daily.yml index 4fa5b1ca2fd7..1b5af60392ac 100644 --- a/.github/workflows/dotnet-format-daily.yml +++ b/.github/workflows/dotnet-format-daily.yml @@ -3,6 +3,9 @@ on: workflow_dispatch: schedule: - cron: 0 0 * * * # Every day at midnight (UTC) + pull_request: + paths: + - .github/workflows/dotnet-format-daily.yml permissions: pull-requests: write @@ -21,12 +24,38 @@ jobs: ref: ${{ matrix.branch }} - name: Setup .NET Core SDK - uses: actions/setup-dotnet@v3.2.0 + uses: actions/setup-dotnet@v4 with: - dotnet-version: 8.x + dotnet-version: 9.x + + - name: Run a pre-work build + shell: pwsh + continue-on-error: true + run: .\build.ps1 + + - name: Add the local .NET to the envvars (PATH, DOTNET_ROOT) + shell: pwsh + run: | + Add-Content -Path $env:GITHUB_PATH -Value "$env:GITHUB_WORKSPACE/.dotnet" + Add-Content -Path $env:GITHUB_ENV -Value "DOTNET_ROOT=$env:GITHUB_WORKSPACE/.dotnet" + Add-Content -Path $env:GITHUB_ENV -Value "DOTNET_INSTALL_DIR=$env:GITHUB_WORKSPACE/.dotnet" + + - name: Ensure we are using the correct .NET + shell: pwsh + run: | + dotnet --version + dotnet --info + dotnet workload --info + + - name: Reset tracked files to clean workspace + shell: bash + run: | + git reset --hard HEAD - name: Run dotnet format - run: dotnet format .\Microsoft.Maui.sln --no-restore --exclude Templates/src --exclude-diagnostics CA1822 + run: | + dotnet restore Microsoft.Maui.sln + dotnet format Microsoft.Maui.sln --exclude Templates/src --exclude-diagnostics CA1822 - name: Create Pull Request uses: dotnet/actions-create-pull-request@v4 @@ -39,7 +68,7 @@ jobs: labels: | t/housekeeping ♻︎ area-infrastructure - assignees: rmarinho, jsuarezruiz - reviewers: rmarinho, jsuarezruiz + assignees: rmarinho, jsuarezruiz, mattleibow + reviewers: rmarinho, jsuarezruiz, mattleibow branch: housekeeping/fix-codeformatting/${{ matrix.branch }} base: ${{ matrix.branch }} diff --git a/README.md b/README.md index 6a07d025e7b3..70386a702084 100644 --- a/README.md +++ b/README.md @@ -18,6 +18,7 @@ ![.NET MAUI Weather App on all platforms](Assets/maui-weather-hero-sm.png) ## Current News +* 2025 - [What's new in .NET MAUI for .NET 10](https://learn.microsoft.com/dotnet/maui/whats-new/dotnet-10) * November 13, 2024 - [What's new in .NET MAUI for .NET 9](https://learn.microsoft.com/dotnet/maui/whats-new/dotnet-9) * November 12, 2024 - [Announcing .NET 9](https://devblogs.microsoft.com/dotnet/announcing-dotnet-9/#.net-maui-–-enhancing-multi-platform-app-development) * October 22, 2024 - [.NET MAUI Welcomes Syncfusion Open-source Contributions](https://devblogs.microsoft.com/dotnet/dotnet-maui-welcomes-syncfusion-open-source-contributions/) diff --git a/eng/Versions.props b/eng/Versions.props index 951e033d3acb..b0a911df69eb 100644 --- a/eng/Versions.props +++ b/eng/Versions.props @@ -98,8 +98,8 @@ $(MicrosoftAspNetCorePackageVersion) 9.0.0-preview* - 3.3.4 - 3.3.4 + 4.14.0 + 4.14.0 3.0.1 4.6.1 4.5.5 @@ -173,6 +173,7 @@ 17.0.12 + 35.0.2 33.0.0 13.0 diff --git a/eng/automation/guardian/tsaoptions-v2.json b/eng/automation/guardian/tsaoptions-v2.json index 8905f4aeb38c..109f771cd04b 100644 --- a/eng/automation/guardian/tsaoptions-v2.json +++ b/eng/automation/guardian/tsaoptions-v2.json @@ -5,7 +5,7 @@ ], "instanceUrl": "https://devdiv.visualstudio.com/", "projectName": "DevDiv", - "areaPath": "DevDiv\\VS Client - Runtime SDKs\\MAUI", + "areaPath": "DevDiv\\.NET MAUI\\MAUI", "iterationPath": "DevDiv", "allTools": true } \ No newline at end of file diff --git a/eng/cake/dotnet.cake b/eng/cake/dotnet.cake index f3c6a0d6429e..74843a9df953 100644 --- a/eng/cake/dotnet.cake +++ b/eng/cake/dotnet.cake @@ -486,7 +486,26 @@ Task("VSCode") UseLocalNuGetCacheFolder(); - StartVisualStudioCodeForDotNet(); + StartVisualStudioCodeForDotNet(false); + }); + +Task("Insiders") + .Description("Provisions .NET, and launches an instance of Visual Studio Code using it.") + .IsDependentOn("Clean") + .IsDependentOn("dotnet") + .IsDependentOn("dotnet-buildtasks") + .IsDependentOn("dotnet-pack") // Run conditionally + .Does(() => + { + if (pendingException != null) + { + Error($"{pendingException}"); + Error("!!!!BUILD TASKS FAILED: !!!!!"); + } + + UseLocalNuGetCacheFolder(); + + StartVisualStudioCodeForDotNet(true); }); // Tasks for Local Development @@ -632,7 +651,7 @@ void UseLocalNuGetCacheFolder(bool reset = false) SetEnvironmentVariable("NUGET_PACKAGES", packages.FullPath); } -void StartVisualStudioCodeForDotNet() +void StartVisualStudioCodeForDotNet(bool useInsiders) { if (IsCIBuild()) { @@ -645,7 +664,9 @@ void StartVisualStudioCodeForDotNet() SetDotNetEnvironmentVariables(); } - StartProcess("code", new ProcessSettings{ EnvironmentVariables = GetDotNetEnvironmentVariables() }); + string codeProcessName = useInsiders ? "code-insiders" : "code"; + + StartProcess(codeProcessName, new ProcessSettings{ EnvironmentVariables = GetDotNetEnvironmentVariables() }); } void StartVisualStudioForDotNet() diff --git a/eng/devices/android.cake b/eng/devices/android.cake index bcde70b327c3..20226c303a2c 100644 --- a/eng/devices/android.cake +++ b/eng/devices/android.cake @@ -700,7 +700,10 @@ void EnsureAdbKeys(AdbToolSettings settings) } // Set proper directory permissions - StartProcess("chmod", $"700 {adbKeyPath}"); + if (IsRunningOnLinux()) + { + StartProcess("chmod", $"700 {adbKeyPath}"); + } // Delete existing ADB keys to avoid stale data Information("Cleaning up old ADB keys..."); @@ -716,24 +719,46 @@ void EnsureAdbKeys(AdbToolSettings settings) Information("Removed existing public key"); } - // Generate new ADB keys instead of waiting for automatic generation - Information("Explicitly generating new ADB keys..."); - StartProcess("adb", new ProcessSettings { - Arguments = "keygen " + adbKeyPath, - RedirectStandardOutput = true, - RedirectStandardError = true - }); + // Try to generate ADB keys + bool keysGenerated = false; + + // Option 1: Use adb keygen + keysGenerated = CreateAdbKeysUsingKeygen(adbKeyPath, adbKeyFile); + + // Option 2: Use automatic key generation by connecting to a device + if (!keysGenerated) + { + Information("Option 1 failed. Trying automatic key generation..."); + keysGenerated = CreateAdbKeysUsingAutomaticGeneration(settings, adbKeyFile, adbKeyPubFile); + } + + // Option 3: Use OpenSSL as fallback (if available) + if (!keysGenerated) + { + Information("Option 2 failed. Trying OpenSSL key generation..."); + keysGenerated = CreateAdbKeysUsingOpenSSL(adbKeyFile, adbKeyPubFile); + } + + if (!keysGenerated) + { + throw new Exception("All key generation methods failed. Unable to create ADB keys."); + } - // Check if keys were created + // Verify keys were created if (!System.IO.File.Exists(adbKeyFile) || !System.IO.File.Exists(adbKeyPubFile)) { - throw new Exception("Failed to generate ADB keys."); + throw new Exception("ADB keys were not created successfully."); } - // Set correct file permissions for ADB keys - Information("Setting correct permissions for ADB keys..."); - StartProcess("chmod", $"600 {adbKeyFile}"); - StartProcess("chmod", $"600 {adbKeyPubFile}"); + Information("ADB keys generated successfully!"); + + // Set correct file permissions for ADB keys (Unix systems only) + if (IsRunningOnLinux()) + { + Information("Setting correct permissions for ADB keys..."); + StartProcess("chmod", $"600 {adbKeyFile}"); + StartProcess("chmod", $"600 {adbKeyPubFile}"); + } // Set environment variable properly (platform specific) Information("Setting ADB_VENDOR_KEYS environment variable..."); @@ -822,9 +847,8 @@ void EnsureAdbKeys(AdbToolSettings settings) try { - AdbKillServer(settings); - System.Threading.Thread.Sleep(1000); - AdbStartServer(settings); + // Recovery attempt: Restart ADB and try automatic key generation + RecoverAdbConnection(settings); } catch (Exception innerEx) { @@ -834,3 +858,229 @@ void EnsureAdbKeys(AdbToolSettings settings) throw; // Re-throw the original exception } } + +bool CreateAdbKeysUsingKeygen(string adbKeyPath, string adbKeyFile) +{ + var keygenMethods = new[] + { + $"keygen {adbKeyFile}", // Standard method: adb keygen + $"keygen {adbKeyPath}/adbkey", // Alternative path format + }; + + foreach (var method in keygenMethods) + { + try + { + Information($"Trying ADB keygen method: adb {method}"); + + var processSettings = new ProcessSettings + { + Arguments = method, + RedirectStandardOutput = true, + RedirectStandardError = true, + Timeout = 30000 // 30 second timeout + }; + + var exitCode = StartProcess("adb", processSettings); + + if (exitCode == 0) + { + Information($"ADB keygen successful with method: {method}"); + System.Threading.Thread.Sleep(1000); // Allow file system to sync + + // Check if keys were actually created + if (System.IO.File.Exists(adbKeyFile) && System.IO.File.Exists(adbKeyFile + ".pub")) + { + Information("Keys verified to exist after generation."); + return true; + } + } + } + catch (Exception ex) + { + Information($"ADB keygen method '{method}' failed: {ex.Message}"); + } + } + + return false; +} + +bool CreateAdbKeysUsingAutomaticGeneration(AdbToolSettings settings, string adbKeyFile, string adbKeyPubFile) +{ + try + { + Information("Attempting automatic key generation by starting ADB server..."); + + // Set required environment variables for key generation + SetEnvironmentVariable("HOSTNAME", Environment.MachineName); + SetEnvironmentVariable("LOGNAME", Environment.UserName); + + // Start ADB server - this should trigger automatic key generation + AdbStartServer(settings); + System.Threading.Thread.Sleep(2000); + + // Try to list devices - this often triggers key generation + var devices = AdbDevices(settings); + Information($"Found {devices.Count()} devices during key generation attempt"); + + System.Threading.Thread.Sleep(2000); + + // Check if keys were automatically generated + if (System.IO.File.Exists(adbKeyFile) && System.IO.File.Exists(adbKeyPubFile)) + { + Information("Automatic key generation successful!"); + return true; + } + + // If not, try restarting the server a few times + for (int i = 0; i < 3; i++) + { + Information($"Automatic generation attempt {i + 1}/3..."); + AdbKillServer(settings); + System.Threading.Thread.Sleep(1000); + AdbStartServer(settings); + System.Threading.Thread.Sleep(2000); + + // Try some ADB commands that might trigger key generation + try + { + AdbDevices(settings); + var processSettings = new ProcessSettings + { + Arguments = "version", + RedirectStandardOutput = true, + RedirectStandardError = true + }; + StartProcess("adb", processSettings); + } + catch { /* Ignore errors during trigger attempts */ } + + System.Threading.Thread.Sleep(1000); + + if (System.IO.File.Exists(adbKeyFile) && System.IO.File.Exists(adbKeyPubFile)) + { + Information($"Automatic key generation successful on attempt {i + 1}!"); + return true; + } + } + } + catch (Exception ex) + { + Information($"Automatic key generation failed: {ex.Message}"); + } + + return false; +} + +bool CreateAdbKeysUsingOpenSSL(string adbKeyFile, string adbKeyPubFile) +{ + try + { + Information("Attempting to generate ADB keys using OpenSSL..."); + + // Generate private key using OpenSSL + var privateKeySettings = new ProcessSettings + { + Arguments = $"genrsa -out {adbKeyFile} 2048", + RedirectStandardOutput = true, + RedirectStandardError = true, + Timeout = 30000 + }; + + var exitCode = StartProcess("openssl", privateKeySettings); + if (exitCode != 0) + { + Information("OpenSSL private key generation failed."); + return false; + } + + // Generate public key from private key + var publicKeySettings = new ProcessSettings + { + Arguments = $"rsa -in {adbKeyFile} -pubout -outform DER | openssl base64 -A", + RedirectStandardOutput = true, + RedirectStandardError = true, + Timeout = 30000 + }; + + var result = StartProcess("openssl", publicKeySettings); + if (result == 0) + { + // The public key format for ADB needs to be specific + // We need to create a properly formatted .pub file + + // This is a simplified approach - in reality, ADB uses a specific key format + // For now, we'll create a basic public key file + var hostname = Environment.MachineName; + var username = Environment.UserName; + + // Read the private key and create a basic public key entry + var keyContent = $"adb-generated-key {username}@{hostname}"; + System.IO.File.WriteAllText(adbKeyPubFile, keyContent); + + if (System.IO.File.Exists(adbKeyFile) && System.IO.File.Exists(adbKeyPubFile)) + { + Information("OpenSSL key generation successful!"); + return true; + } + } + } + catch (Exception ex) + { + Information($"OpenSSL key generation failed: {ex.Message}"); + } + + return false; +} + +void RecoverAdbConnection(AdbToolSettings settings) +{ + Information("Attempting to recover ADB connection..."); + + try + { + // Kill any existing ADB processes + AdbKillServer(settings); + System.Threading.Thread.Sleep(2000); + + // Clear any cached connection state + if (IsRunningOnLinux()) + { + var homeDir = Environment.GetFolderPath(Environment.SpecialFolder.UserProfile); + var adbKeyPath = System.IO.Path.Combine(homeDir, ".android"); + + // Remove any lock files or cached state + try + { + var lockFiles = System.IO.Directory.GetFiles(adbKeyPath, "*.lock"); + foreach (var lockFile in lockFiles) + { + System.IO.File.Delete(lockFile); + } + } + catch { } + } + + // Restart ADB server + AdbStartServer(settings); + System.Threading.Thread.Sleep(3000); + + // Try to trigger automatic key generation + try + { + var devices = AdbDevices(settings); + Information($"Recovery check: found {devices.Count()} devices"); + } + catch (Exception ex) + { + Information($"Recovery device check failed: {ex.Message}"); + } + + Information("ADB connection recovery attempt completed."); + } + catch (Exception ex) + { + Error($"ADB connection recovery failed: {ex.Message}"); + throw; + } +} \ No newline at end of file diff --git a/eng/helix.proj b/eng/helix.proj new file mode 100644 index 000000000000..e588f10bbfa1 --- /dev/null +++ b/eng/helix.proj @@ -0,0 +1,33 @@ + + + test/product/ + $(BUILD_BUILDNUMBER) + Windows.10.Amd64.Open;OSX.15.ARM64.Open + maui + + true + sdk + + true + true + + + + + + Windows.10.Amd64.Open;OSX.1200.Amd64.Open;OSX.1200.ARM64.Open;Ubuntu.2204.Amd64.Open@mcr.microsoft.com/dotnet-buildtools/prereqs:ubuntu-20.04-helix-sqlserver-amd64 + false + maui/localbuild/ + t001 + + + + + + + + + + + + \ No newline at end of file diff --git a/eng/pipelines/arcade/stage-build.yml b/eng/pipelines/arcade/stage-build.yml new file mode 100644 index 000000000000..df5a4f57e332 --- /dev/null +++ b/eng/pipelines/arcade/stage-build.yml @@ -0,0 +1,92 @@ +# Template for build + pack on dnceng +parameters: +- name: prepareSteps + type: stepList + default: [] +- name: postSteps + type: stepList + default: [] +- name: enableSourceBuild + type: boolean + default: false +- name: enableSourceIndex + type: boolean + default: false +- name: sourceIndexParams + type: object + default: [] +- name: runAsPublic + type: boolean + default: false +- name: buildProjects + type: string + default: '$(Build.SourcesDirectory)/Microsoft.Maui.sln' +- name: buildProjectsMac + type: string + default: '$(Build.SourcesDirectory)/Microsoft.Maui-mac.slnf' +- name: buildTaskProjects + type: string + default: '$(Build.SourcesDirectory)/Microsoft.Maui.BuildTasks.slnf' +- name: buildConfigurations + type: object + default: + - Debug + - Release +- name: buildPlatforms + type: object + default: + - name: NetCore-Public + image: 1es-windows-2022 + os: Windows + buildScript: $(_buildScript) + sln: $(buildProjects) + - name: Azure Pipelines + vmImage: $(HostedMacImage) + os: macOS + buildScript: $(_buildScriptMacOS) + sln: $(buildProjectsMac) + +stages: +- stage: Build + displayName: Build .NET MAUI + dependsOn: [] + jobs: + - ${{ each BuildPlatform in parameters.buildPlatforms }}: + - template: ${{ iif(eq(parameters.runAsPublic, 'true'), '/eng/common/templates/jobs/jobs.yml', '/eng/common/templates-official/jobs/jobs.yml@self') }} + parameters: + helixRepo: dotnet/maui + pool: ${{ BuildPlatform }} + enableMicrobuild: true + enablePublishUsingPipelines: true + enablePublishBuildAssets: true + enableTelemetry: true + enableSourceBuild: ${{ parameters.enableSourceBuild }} + enableSourceIndex: ${{ parameters.enableSourceIndex }} + sourceIndexParams: ${{ parameters.sourceIndexParams }} + publishAssetsImmediately: true + enablePublishBuildArtifacts: true + enablePublishTestResults: true + workspace: + clean: all + jobs: + - ${{ each BuildConfiguration in parameters.buildConfigurations }}: + - job: build_net_${{ BuildPlatform.os }}_${{ BuildConfiguration }} + displayName: Build ${{ BuildPlatform.os }} (${{ BuildConfiguration }}) + timeoutInMinutes: 240 + variables: + - name: _BuildConfig + value: ${{ BuildConfiguration }} + preSteps: + - checkout: self + fetchDepth: 1 + clean: true + steps: + - ${{ each step in parameters.prepareSteps }}: + - ${{ each pair in step }}: + ${{ pair.key }}: ${{ pair.value }} + + - script: ${{ BuildPlatform.buildScript }} -restore -build -configuration ${{ BuildConfiguration }} -projects "${{ parameters.buildTaskProjects }}" /p:ArchiveTests=false /p:TreatWarningsAsErrors=$(TreatWarningsAsErrors) /bl:$(Build.Arcade.LogsPath)${{ BuildConfiguration }}/buildtasks_${{ BuildPlatform.os }}.binlog $(_OfficialBuildIdArgs) + displayName: 🛠️ Build BuildTasks + + - script: ${{ BuildPlatform.buildScript }} -restore -build -configuration ${{ BuildConfiguration }} -projects ${{ BuildPlatform.sln }} /p:ArchiveTests=false /p:TreatWarningsAsErrors=$(TreatWarningsAsErrors) /p:CodesignRequireProvisioningProfile=false /p:EnableWindowsTargeting=true /bl:$(Build.Arcade.LogsPath)${{ BuildConfiguration }}/build_${{ BuildPlatform.os }}.binlog $(_OfficialBuildIdArgs) + displayName: 🛠️ Build Microsoft.Maui.sln diff --git a/eng/pipelines/arcade/stage-helix-tests.yml b/eng/pipelines/arcade/stage-helix-tests.yml new file mode 100644 index 000000000000..588e30ff3a2e --- /dev/null +++ b/eng/pipelines/arcade/stage-helix-tests.yml @@ -0,0 +1,95 @@ +# Template for running tests on Helix on dnceng +parameters: +- name: prepareSteps + type: stepList + default: [] +- name: postSteps + type: stepList + default: [] +- name: enableSourceBuild + type: boolean + default: false +- name: enableSourceIndex + type: boolean + default: false +- name: sourceIndexParams + type: object + default: [] +- name: runAsPublic + type: boolean + default: true +- name: creator + type: string + default: 'maui' +- name: extraHelixArguments + type: string + default: '' +- name: buildTaskProjects + type: string + default: '$(Build.SourcesDirectory)/Microsoft.Maui.BuildTasks.slnf' +- name: helixProject + type: string + default: '$(Build.SourcesDirectory)/eng/helix.proj' +- name: buildConfigurations + type: object + default: + - Debug + - Release +- name: buildPlatforms + type: object + default: + - name: NetCore-Public + image: 1es-windows-2022 + os: Windows + buildScript: $(_helixScript) + sln: $(buildProjects) + - name: Azure Pipelines + vmImage: $(HostedMacImage) + os: macOS + buildScript: $(_helixScriptMacOS) + sln: $(buildProjectsMac) + +stages: +- stage: HelixTests + displayName: Run Helix Unit Tests + dependsOn: [] + jobs: + - ${{ each BuildConfiguration in parameters.buildConfigurations }}: + - template: ${{ iif(eq(parameters.runAsPublic, 'true'), '/eng/common/templates/jobs/jobs.yml@self', '/eng/common/templates-official/jobs/jobs.yml@self') }} + parameters: + helixRepo: dotnet/maui + pool: + name: NetCore-Public + vmImage: 1es-windows-2022 + os: windows + enableMicrobuild: true + enablePublishUsingPipelines: true + enablePublishBuildAssets: true + enableTelemetry: true + enableSourceBuild: ${{ parameters.enableSourceBuild }} + enableSourceIndex: ${{ parameters.enableSourceIndex }} + sourceIndexParams: ${{ parameters.sourceIndexParams }} + publishAssetsImmediately: true + enablePublishBuildArtifacts: true + enablePublishTestResults: true + workspace: + clean: all + jobs: + - job: test_helix_unit_tests_windows_${{ BuildConfiguration }} + displayName: Windows Helix Unit Tests (${{ BuildConfiguration }}) + timeoutInMinutes: 240 + variables: + - name: _BuildConfig + value: ${{ BuildConfiguration }} + steps: + - ${{ each step in parameters.prepareSteps }}: + - ${{ each pair in step }}: + ${{ pair.key }}: ${{ pair.value }} + + - script: $(_buildScript) -restore -build -configuration ${{ BuildConfiguration }} -projects "${{ parameters.buildTaskProjects }}" /p:ArchiveTests=false /p:TreatWarningsAsErrors=$(TreatWarningsAsErrors) /bl:$(Build.Arcade.LogsPath)${{ BuildConfiguration }}/buildtasks.binlog $(_OfficialBuildIdArgs) + displayName: 🛠️ Build BuildTasks + + - script: $(_msbuildCommand) "${{ parameters.helixProject }}" -warnAsError 0 -restore /p:Configuration=${{ BuildConfiguration }} /p:TestRunNameSuffix="_${{ BuildConfiguration }}" /bl:$(Build.Arcade.LogsPath)${{ BuildConfiguration }}/helix_tests.binlog ${{ parameters.extraHelixArguments }} + displayName: Run Helix Tests + env: + SYSTEM_ACCESSTOKEN: $(System.AccessToken) # We need to set this env var to publish helix results to Azure Dev Ops diff --git a/eng/pipelines/arcade/stage-integration-tests.yml b/eng/pipelines/arcade/stage-integration-tests.yml index ad3d73f54f65..8df8ff0f79cb 100644 --- a/eng/pipelines/arcade/stage-integration-tests.yml +++ b/eng/pipelines/arcade/stage-integration-tests.yml @@ -1,6 +1,6 @@ parameters: stageDependsOn: [] - jobMatrix: [] # Should define jobMatrix.name, jobMatrix.displayName, jobMatrix.pool, jobMatrix.timeout, jobMatrix.testCategory + jobMatrix: [] # Should define jobMatrix.name, jobMatrix.displayName, jobMatrix.pool, jobMatrix.timeout, jobMatrix.testCategory mauiSourcePath: $(Build.SourcesDirectory) buildConfig: Debug repoLogPath: $(Build.Arcade.LogsPath) @@ -31,6 +31,9 @@ stages: project: ${{ parameters.mauiSourcePath }}/src/TestUtils/src/Microsoft.Maui.IntegrationTests/Microsoft.Maui.IntegrationTests.csproj arguments: '-c ${{ parameters.buildConfig }} --filter "Category=${{ job.testCategory }}" --logger trx --results-directory $(Agent.TempDirectory)/Microsoft.Maui.IntegrationTests' useExitCodeForErrors: true + ${{ if eq(job.testCategory, 'RunOniOS') }}: + envVariables: + IOS_TEST_DEVICE: ios-simulator-64_18.0 - task: PublishTestResults@2 inputs: diff --git a/eng/pipelines/arcade/stage-pack.yml b/eng/pipelines/arcade/stage-pack.yml index 896557b6f77f..d9d18adea823 100644 --- a/eng/pipelines/arcade/stage-pack.yml +++ b/eng/pipelines/arcade/stage-pack.yml @@ -26,7 +26,7 @@ stages: displayName: Pack .NET MAUI dependsOn: [] jobs: - - template: /eng/common/templates-official/jobs/jobs.yml + - template: ${{ iif(eq(parameters.runAsPublic, 'true'), '/eng/common/templates/jobs/jobs.yml', '/eng/common/templates-official/jobs/jobs.yml@self') }} parameters: helixRepo: dotnet/maui pool: ${{ parameters.pool }} @@ -68,14 +68,14 @@ stages: # Run on public pipeline - ${{ if parameters.runAsPublic }}: - - script: $(_buildScript) -restore -pack -publish $(_PublishArgs) -configuration $(_BuildConfig) /bl:$(Build.Arcade.LogsPath)pack.binlog $(_OfficialBuildIdArgs) + - script: $(_buildScript) -restore -pack -publish $(_PublishArgs) -configuration $(_BuildConfig) /bl:$(Build.Arcade.LogsPath)/$(_BuildConfig)/pack.binlog $(_OfficialBuildIdArgs) displayName: Pack & Publish # Run on internal pipeline - ${{ if and(not(parameters.runAsPublic) , notin(variables['Build.Reason'], 'PullRequest')) }}: - - script: $(_buildScript) -restore -pack -sign $(_SignArgs) -configuration $(_BuildConfig) /bl:$(Build.Arcade.LogsPath)pack.binlog $(_OfficialBuildIdArgs) + - script: $(_buildScript) -restore -pack -sign $(_SignArgs) -configuration $(_BuildConfig) /bl:$(Build.Arcade.LogsPath)/$(_BuildConfig)/pack.binlog $(_OfficialBuildIdArgs) displayName: Pack, Sign # only for workloads - - script: $(_buildScript) -restore -build -sign $(_SignArgs) -publish $(_PublishArgs) -configuration $(_BuildConfig) /bl:$(Build.Arcade.LogsPath)/build-workloads.binlog -projects src/Workload/workloads.csproj $(_OfficialBuildIdArgs) + - script: $(_buildScript) -restore -build -sign $(_SignArgs) -publish $(_PublishArgs) -configuration $(_BuildConfig) /bl:$(Build.Arcade.LogsPath)/$(_BuildConfig)/build-workloads.binlog -projects src/Workload/workloads.csproj $(_OfficialBuildIdArgs) displayName: Build Workloads, Sign & Publish diff --git a/eng/pipelines/arcade/stage-unit-tests.yml b/eng/pipelines/arcade/stage-unit-tests.yml index fc9374b852e9..7ec8b1d522a2 100644 --- a/eng/pipelines/arcade/stage-unit-tests.yml +++ b/eng/pipelines/arcade/stage-unit-tests.yml @@ -24,20 +24,20 @@ stages: installPackageArtifacts: false buildMSBuildTasks: true - - template: /eng/pipelines/common/run-dotnet-preview.yml - parameters: - displayName: Run Controls.Core.UnitTests - ${{ job.testOS }} - mauiSourcePath: ${{ parameters.mauiSourcePath }} - command: test - project: ${{ parameters.mauiSourcePath }}/src/Controls/tests/Core.UnitTests/Controls.Core.UnitTests.csproj - arguments: '-c ${{ parameters.buildConfig }} --logger trx --results-directory $(Agent.TempDirectory)/Controls.Core.UnitTests /p:_SkipUpdateBuildNumber=true' - useExitCodeForErrors: true - - - task: PublishTestResults@2 - inputs: - testResultsFormat: VSTest - testResultsFiles: $(Agent.TempDirectory)/Controls.Core.UnitTests/*.trx - testRunTitle: Controls.Core.UnitTests - ${{ job.testOS }} + # - template: /eng/pipelines/common/run-dotnet-preview.yml + # parameters: + # displayName: Run Controls.Core.UnitTests - ${{ job.testOS }} + # mauiSourcePath: ${{ parameters.mauiSourcePath }} + # command: test + # project: ${{ parameters.mauiSourcePath }}/src/Controls/tests/Core.UnitTests/Controls.Core.UnitTests.csproj + # arguments: '-c ${{ parameters.buildConfig }} --logger trx --results-directory $(Agent.TempDirectory)/Controls.Core.UnitTests /p:_SkipUpdateBuildNumber=true' + # useExitCodeForErrors: true + + # - task: PublishTestResults@2 + # inputs: + # testResultsFormat: VSTest + # testResultsFiles: $(Agent.TempDirectory)/Controls.Core.UnitTests/*.trx + # testRunTitle: Controls.Core.UnitTests - ${{ job.testOS }} - template: /eng/pipelines/common/run-dotnet-preview.yml parameters: @@ -69,50 +69,50 @@ stages: testResultsFiles: $(Agent.TempDirectory)/SourceGen.UnitTests/*.trx testRunTitle: SourceGen.UnitTests - ${{ job.testOS }} - - template: /eng/pipelines/common/run-dotnet-preview.yml - parameters: - displayName: Run Controls.BindingSourceGen.UnitTests - ${{ job.testOS }} - mauiSourcePath: ${{ parameters.mauiSourcePath }} - command: test - project: ${{ parameters.mauiSourcePath }}/src/Controls/tests/BindingSourceGen.UnitTests/Controls.BindingSourceGen.UnitTests.csproj - arguments: '-c ${{ parameters.buildConfig }} --logger trx --results-directory $(Agent.TempDirectory)/Controls.BindingSourceGen.UnitTests /p:_SkipUpdateBuildNumber=true' - useExitCodeForErrors: true - - - task: PublishTestResults@2 - inputs: - testResultsFormat: VSTest - testResultsFiles: $(Agent.TempDirectory)/Controls.BindingSourceGen.UnitTests/*.trx - testRunTitle: Controls.BindingSourceGen.UnitTests - ${{ job.testOS }} - - - template: /eng/pipelines/common/run-dotnet-preview.yml - parameters: - displayName: Run Core.UnitTests - ${{ job.testOS }} - mauiSourcePath: ${{ parameters.mauiSourcePath }} - command: test - project: ${{ parameters.mauiSourcePath }}/src/Core/tests/UnitTests/Core.UnitTests.csproj - arguments: '-c ${{ parameters.buildConfig }} --logger trx --results-directory $(Agent.TempDirectory)/Core.UnitTests /p:_SkipUpdateBuildNumber=true' - useExitCodeForErrors: true - - - task: PublishTestResults@2 - inputs: - testResultsFormat: VSTest - testResultsFiles: $(Agent.TempDirectory)/Core.UnitTests/*.trx - testRunTitle: Core.UnitTests - ${{ job.testOS }} - - - template: /eng/pipelines/common/run-dotnet-preview.yml - parameters: - displayName: Run Essentials.UnitTests - ${{ job.testOS }} - mauiSourcePath: ${{ parameters.mauiSourcePath }} - command: test - project: ${{ parameters.mauiSourcePath }}/src/Essentials/test/UnitTests/Essentials.UnitTests.csproj - arguments: '-c ${{ parameters.buildConfig }} --logger trx --results-directory $(Agent.TempDirectory)/Essentials.UnitTests /p:_SkipUpdateBuildNumber=true' - useExitCodeForErrors: true - - - task: PublishTestResults@2 - inputs: - testResultsFormat: VSTest - testResultsFiles: $(Agent.TempDirectory)/Essentials.UnitTests/*.trx - testRunTitle: Essentials.UnitTests - ${{ job.testOS }} + # - template: /eng/pipelines/common/run-dotnet-preview.yml + # parameters: + # displayName: Run Controls.BindingSourceGen.UnitTests - ${{ job.testOS }} + # mauiSourcePath: ${{ parameters.mauiSourcePath }} + # command: test + # project: ${{ parameters.mauiSourcePath }}/src/Controls/tests/BindingSourceGen.UnitTests/Controls.BindingSourceGen.UnitTests.csproj + # arguments: '-c ${{ parameters.buildConfig }} --logger trx --results-directory $(Agent.TempDirectory)/Controls.BindingSourceGen.UnitTests /p:_SkipUpdateBuildNumber=true' + # useExitCodeForErrors: true + + # - task: PublishTestResults@2 + # inputs: + # testResultsFormat: VSTest + # testResultsFiles: $(Agent.TempDirectory)/Controls.BindingSourceGen.UnitTests/*.trx + # testRunTitle: Controls.BindingSourceGen.UnitTests - ${{ job.testOS }} + + # - template: /eng/pipelines/common/run-dotnet-preview.yml + # parameters: + # displayName: Run Core.UnitTests - ${{ job.testOS }} + # mauiSourcePath: ${{ parameters.mauiSourcePath }} + # command: test + # project: ${{ parameters.mauiSourcePath }}/src/Core/tests/UnitTests/Core.UnitTests.csproj + # arguments: '-c ${{ parameters.buildConfig }} --logger trx --results-directory $(Agent.TempDirectory)/Core.UnitTests /p:_SkipUpdateBuildNumber=true' + # useExitCodeForErrors: true + + # - task: PublishTestResults@2 + # inputs: + # testResultsFormat: VSTest + # testResultsFiles: $(Agent.TempDirectory)/Core.UnitTests/*.trx + # testRunTitle: Core.UnitTests - ${{ job.testOS }} + + # - template: /eng/pipelines/common/run-dotnet-preview.yml + # parameters: + # displayName: Run Essentials.UnitTests - ${{ job.testOS }} + # mauiSourcePath: ${{ parameters.mauiSourcePath }} + # command: test + # project: ${{ parameters.mauiSourcePath }}/src/Essentials/test/UnitTests/Essentials.UnitTests.csproj + # arguments: '-c ${{ parameters.buildConfig }} --logger trx --results-directory $(Agent.TempDirectory)/Essentials.UnitTests /p:_SkipUpdateBuildNumber=true' + # useExitCodeForErrors: true + + # - task: PublishTestResults@2 + # inputs: + # testResultsFormat: VSTest + # testResultsFiles: $(Agent.TempDirectory)/Essentials.UnitTests/*.trx + # testRunTitle: Essentials.UnitTests - ${{ job.testOS }} - template: /eng/pipelines/common/run-dotnet-preview.yml parameters: @@ -144,20 +144,20 @@ stages: testResultsFiles: $(Agent.TempDirectory)/Graphics.Tests/*.trx testRunTitle: Graphics.Tests - ${{ job.testOS }} - - template: /eng/pipelines/common/run-dotnet-preview.yml - parameters: - displayName: Run Compatibility.Core.UnitTests - ${{ job.testOS }} - mauiSourcePath: ${{ parameters.mauiSourcePath }} - command: test - project: ${{ parameters.mauiSourcePath }}/src/Compatibility/Core/tests/Compatibility.UnitTests/Compatibility.Core.UnitTests.csproj - arguments: '-c ${{ parameters.buildConfig }} --logger trx --results-directory $(Agent.TempDirectory)/Compatibility.Core.UnitTests /p:_SkipUpdateBuildNumber=true' - useExitCodeForErrors: true - - - task: PublishTestResults@2 - inputs: - testResultsFormat: VSTest - testResultsFiles: $(Agent.TempDirectory)/Compatibility.Core.UnitTests/*.trx - testRunTitle: Compatibility.Core.UnitTests - ${{ job.testOS }} + # - template: /eng/pipelines/common/run-dotnet-preview.yml + # parameters: + # displayName: Run Compatibility.Core.UnitTests - ${{ job.testOS }} + # mauiSourcePath: ${{ parameters.mauiSourcePath }} + # command: test + # project: ${{ parameters.mauiSourcePath }}/src/Compatibility/Core/tests/Compatibility.UnitTests/Compatibility.Core.UnitTests.csproj + # arguments: '-c ${{ parameters.buildConfig }} --logger trx --results-directory $(Agent.TempDirectory)/Compatibility.Core.UnitTests /p:_SkipUpdateBuildNumber=true' + # useExitCodeForErrors: true + + # - task: PublishTestResults@2 + # inputs: + # testResultsFormat: VSTest + # testResultsFiles: $(Agent.TempDirectory)/Compatibility.Core.UnitTests/*.trx + # testRunTitle: Compatibility.Core.UnitTests - ${{ job.testOS }} # TODO: Controls.Core.Design.UnitTests.csproj diff --git a/eng/pipelines/arcade/variables.yml b/eng/pipelines/arcade/variables.yml index 542d71af5865..5b4dba99062e 100644 --- a/eng/pipelines/arcade/variables.yml +++ b/eng/pipelines/arcade/variables.yml @@ -5,11 +5,21 @@ variables: - name: Build.Arcade.ArtifactsPath value: $(Build.SourcesDirectory)/artifacts/ - name: Build.Arcade.LogsPath - value: $(Build.Arcade.ArtifactsPath)log/$(_BuildConfig)/ + value: $(Build.Arcade.ArtifactsPath)log/ - name: Build.Arcade.TestResultsPath - value: $(Build.Arcade.ArtifactsPath)TestResults/$(_BuildConfig)/ + value: $(Build.Arcade.ArtifactsPath)TestResults/ - name: _buildScript - value: $(Build.SourcesDirectory)/build.cmd -ci + value: $(Build.SourcesDirectory)\build.cmd -ci +- name: _buildScriptMacOS + value: $(Build.SourcesDirectory)/build.sh -ci -warnAsError 0 +- name: _helixScriptMacOS + value: $(Build.SourcesDirectory)/helix.sh +- name: _helixScript + value: $(Build.SourcesDirectory)\helix.cmd +- name: _msbuildCommand + value: powershell -ExecutionPolicy ByPass -NoProfile $(Build.SourcesDirectory)\eng\common\msbuild.ps1 -ci +- name: _msbuildMacOsCommand + value: $(Build.SourcesDirectory)/eng/common/msbuild.sh --ci - name: _BuildOfficalId value: $[ format('{0}.{1}', format('{0:yyyyMMdd}', pipeline.startTime), counter(format('{0:yyyyMMdd}', pipeline.startTime), 1) )] - name: TreatWarningsAsErrors @@ -33,7 +43,7 @@ variables: # needed for darc (dependency flow) publishing - name: _PublishArgs value: >- - /p:DotNetPublishUsingPipelines=true + /p:DotNetPublishUsingPipelines=true # - name: _OfficialBuildIdArgs # value: /p:OfficialBuildId=$(BUILD.BUILDNUMBER) # needed for signing diff --git a/eng/pipelines/azure-pipelines-public.yml b/eng/pipelines/azure-pipelines-public.yml index 3ffcbc533721..11a989a6e35a 100644 --- a/eng/pipelines/azure-pipelines-public.yml +++ b/eng/pipelines/azure-pipelines-public.yml @@ -3,75 +3,132 @@ trigger: branches: include: - main + - net10.0 - release/* + - inflight/* paths: include: - - '*' + - '*' exclude: - - '**.md' - - eng/Version.Details.xml - - .github/* - - docs/* - - LICENSE.TXT - - PATENTS.TXT - - THIRD-PARTY-NOTICES.TXT + - '**.md' + - eng/Version.Details.xml + - .github/* + - docs/* + - LICENSE.TXT + - PATENTS.TXT + - THIRD-PARTY-NOTICES.TXT pr: branches: include: - main + - net10.0 - release/* - - feature/* + - inflight/* paths: include: - - '*' + - '*' exclude: - - '**.md' - - eng/Version.Details.xml - - .github/* - - docs/* - - LICENSE.TXT - - PATENTS.TXT - - THIRD-PARTY-NOTICES.TXT + - '**.md' + - eng/Version.Details.xml + - .github/* + - docs/* + - LICENSE.TXT + - PATENTS.TXT + - THIRD-PARTY-NOTICES.TXT variables: - - template: /eng/common/templates/variables/pool-providers.yml@self - - template: /eng/pipelines/common/variables.yml@self - - template: /eng/pipelines/arcade/variables.yml@self +- template: /eng/common/templates/variables/pool-providers.yml@self +- template: /eng/pipelines/common/variables.yml@self +- template: /eng/pipelines/arcade/variables.yml@self parameters: - - name: VM_IMAGE_HOST - type: object - default: - name: NetCore-Public - image: 1es-windows-2022 - os: windows +- name: PackPlatform + type: object + default: + name: NetCore-Public + image: 1es-windows-2022 + os: windows + +- name: BuildConfigurations + type: object + default: + - Debug + - Release + +- name: BuildPlatforms + type: object + default: + - name: NetCore-Public + image: 1es-windows-2022 + os: Windows + buildScript: $(_buildScript) + sln: '$(Build.SourcesDirectory)/Microsoft.Maui.sln' + - name: Azure Pipelines + vmImage: $(HostedMacImage) + os: macOS + buildScript: $(_buildScriptMacOS) + sln: '$(Build.SourcesDirectory)/Microsoft.Maui-mac.slnf' stages: +- template: /eng/pipelines/arcade/stage-helix-tests.yml@self + parameters: + runAsPublic: true + prepareSteps: + - template: /eng/pipelines/common/provision.yml@self + parameters: + checkoutDirectory: '$(System.DefaultWorkingDirectory)' + skipJdk: false + skipAndroidCommonSdks: false + skipAndroidPlatformApis: false + onlyAndroidPlatformDefaultApis: true + skipAndroidEmulatorImages: true + skipAndroidCreateAvds: true + skipProvisioning: true + skipXcode: true + - template: /eng/pipelines/arcade/stage-pack.yml@self parameters: - pool: ${{ parameters.VM_IMAGE_HOST }} + pool: ${{ parameters.PackPlatform }} runAsPublic: true prepareSteps: - - template: /eng/pipelines/common/provision.yml@self - parameters: - checkoutDirectory: '$(System.DefaultWorkingDirectory)' - skipJdk: false - skipAndroidCommonSdks: false - skipAndroidPlatformApis: false - onlyAndroidPlatformDefaultApis: true - skipAndroidEmulatorImages: true - skipAndroidCreateAvds: true - skipProvisioning: true - skipXcode: true + - template: /eng/pipelines/common/provision.yml@self + parameters: + checkoutDirectory: '$(System.DefaultWorkingDirectory)' + skipJdk: false + skipAndroidCommonSdks: false + skipAndroidPlatformApis: false + onlyAndroidPlatformDefaultApis: true + skipAndroidEmulatorImages: true + skipAndroidCreateAvds: true + skipProvisioning: true + skipXcode: true + +- template: /eng/pipelines/arcade/stage-build.yml@self + parameters: + buildConfigurations: ${{ parameters.BuildConfigurations }} + buildPlatforms: ${{ parameters.BuildPlatforms }} + runAsPublic: ${{ eq(variables['_RunAsPublic'], 'true') }} + prepareSteps: + - template: /eng/pipelines/common/provision.yml@self + parameters: + checkoutDirectory: '$(System.DefaultWorkingDirectory)' + skipJdk: false + skipAndroidCommonSdks: false + skipAndroidPlatformApis: false + onlyAndroidPlatformDefaultApis: true + skipAndroidEmulatorImages: true + skipAndroidCreateAvds: true + skipProvisioning: true + skipXcode: true - template: /eng/pipelines/arcade/stage-unit-tests.yml@self parameters: jobMatrix: - name: win_unit_tests displayName: Windows Unit Tests - pool: ${{ parameters.VM_IMAGE_HOST }} + pool: ${{ parameters.PackPlatform }} timeout: 90 testOS: Windows - name: mac_unit_tests @@ -90,7 +147,7 @@ stages: publishTaskPrefix: '' jobMatrix: - name: win_sample_tests - pool: ${{ parameters.VM_IMAGE_HOST }} + pool: ${{ parameters.PackPlatform }} timeout: 120 testCategory: Samples - name: mac_sample_tests @@ -102,19 +159,20 @@ stages: testCategory: Samples - name: win_wintemplate_tests - pool: ${{ parameters.VM_IMAGE_HOST }} - timeout: 120 - testCategory: WindowsTemplates - - name: mac_wintemplate_tests - pool: - name: Azure Pipelines - vmImage: $(HostedMacImage) - os: macOS + pool: ${{ parameters.PackPlatform }} timeout: 120 testCategory: WindowsTemplates + # - name: mac_wintemplate_tests + # pool: + # name: Azure Pipelines + # vmImage: $(HostedMacImage) + # os: macOS + # timeout: 120 + # testCategory: WindowsTemplates + - name: win_buildtemplate_tests - pool: ${{ parameters.VM_IMAGE_HOST }} + pool: ${{ parameters.PackPlatform }} timeout: 120 testCategory: Build - name: mac_buildtemplate_tests @@ -122,11 +180,11 @@ stages: name: Azure Pipelines vmImage: $(HostedMacImage) os: macOS - timeout: 120 + timeout: 240 testCategory: Build - name: win_blazortemplate_tests - pool: ${{ parameters.VM_IMAGE_HOST }} + pool: ${{ parameters.PackPlatform }} timeout: 120 testCategory: Blazor - name: mac_blazortemplate_tests @@ -138,7 +196,7 @@ stages: testCategory: Blazor - name: win_multitemplate_tests - pool: ${{ parameters.VM_IMAGE_HOST }} + pool: ${{ parameters.PackPlatform }} timeout: 120 testCategory: MultiProject - name: mac_multitemplate_tests diff --git a/eng/pipelines/common/run-dotnet-preview.yml b/eng/pipelines/common/run-dotnet-preview.yml index cbafeeb5580a..b3fbc5accabe 100644 --- a/eng/pipelines/common/run-dotnet-preview.yml +++ b/eng/pipelines/common/run-dotnet-preview.yml @@ -1,32 +1,36 @@ parameters: - mauiSourcePath: $(Build.SourcesDirectory) - command: build - project: '' - arguments: '' - useExitCodeForErrors: false - displayName: run dotnet preview - condition: succeeded() - continueOnError: true - retryCountOnTaskFailure: 0 + mauiSourcePath: $(Build.SourcesDirectory) + command: build + project: '' + arguments: '' + useExitCodeForErrors: false + displayName: run dotnet preview + condition: succeeded() + continueOnError: true + retryCountOnTaskFailure: 0 + envVariables: [] steps: -- powershell: | - if ([Environment]::OSVersion.Platform -eq "Unix") { - $DOTNET_ROOT = "${{ parameters.mauiSourcePath }}/.dotnet" - $env:PATH = "${DOTNET_ROOT}:$env:PATH" - $dotnetPath = "${DOTNET_ROOT}/dotnet" - } else { - $DOTNET_ROOT = "${{ parameters.mauiSourcePath }}\.dotnet" - $env:PATH = "${DOTNET_ROOT};$env:PATH" - $dotnetPath = "${DOTNET_ROOT}\dotnet.exe" - } - & $dotnetPath ${{ parameters.command }} ${{ parameters.project }} ${{ parameters.arguments }} - if ([System.Convert]::ToBoolean("${{ parameters.useExitCodeForErrors }}") -and $LASTEXITCODE -ne 0) { - Write-Host "##vso[task.logissue type=error]Test suite had $LASTEXITCODE failure(s)." - Write-Host "##vso[task.complete result=Failed;]" - exit 0 - } - displayName: ${{ parameters.displayName }} - condition: ${{ parameters.condition }} - continueOnError: ${{ parameters.continueOnError }} - retryCountOnTaskFailure: ${{ parameters.retryCountOnTaskFailure }} + - powershell: | + if ([Environment]::OSVersion.Platform -eq "Unix") { + $DOTNET_ROOT = "${{ parameters.mauiSourcePath }}/.dotnet" + $env:PATH = "${DOTNET_ROOT}:$env:PATH" + $dotnetPath = "${DOTNET_ROOT}/dotnet" + } else { + $DOTNET_ROOT = "${{ parameters.mauiSourcePath }}\.dotnet" + $env:PATH = "${DOTNET_ROOT};$env:PATH" + $dotnetPath = "${DOTNET_ROOT}\dotnet.exe" + } + & $dotnetPath ${{ parameters.command }} ${{ parameters.project }} ${{ parameters.arguments }} + if ([System.Convert]::ToBoolean("${{ parameters.useExitCodeForErrors }}") -and $LASTEXITCODE -ne 0) { + Write-Host "##vso[task.logissue type=error]Test suite had $LASTEXITCODE failure(s)." + Write-Host "##vso[task.complete result=Failed;]" + exit 0 + } + displayName: ${{ parameters.displayName }} + condition: ${{ parameters.condition }} + continueOnError: ${{ parameters.continueOnError }} + retryCountOnTaskFailure: ${{ parameters.retryCountOnTaskFailure }} + env: + ${{ each envVariable in parameters.envVariables }}: + ${{ envVariable.key }}: ${{ envVariable.value }} diff --git a/eng/scripts/update-cgmanifest.ps1 b/eng/scripts/update-cgmanifest.ps1 index 4073be0a822d..97db56efb809 100644 --- a/eng/scripts/update-cgmanifest.ps1 +++ b/eng/scripts/update-cgmanifest.ps1 @@ -28,7 +28,7 @@ if (Test-Path $cgManifestPath) { } else { Write-Host "Creating a new cgmanifest.json file" - $cgManifest = @{ + $cgManifest = [ordered]@{ '$schema' = 'https://json.schemastore.org/component-detection-manifest.json' version = 1 registrations = @() @@ -71,10 +71,11 @@ function New-PackageEntry { [string]$PackageVersion ) - return @{ - component = @{ + # Use ordered hashtables to ensure consistent JSON property ordering + return [ordered]@{ + component = [ordered]@{ type = 'nuget' - nuget = @{ + nuget = [ordered]@{ name = $PackageName version = $PackageVersion } @@ -134,12 +135,31 @@ foreach ($package in $packageVersionMappings.GetEnumerator()) { } } +# Sort registrations by package name for consistent ordering +$sortedRegistrations = $newRegistrations | Sort-Object { $_.component.nuget.name } + # Update the manifest -$cgManifest.registrations = $newRegistrations +$cgManifest.registrations = $sortedRegistrations + +# Convert to JSON with consistent formatting +$newContent = $cgManifest | ConvertTo-Json -Depth 10 + +# Only write if content has changed to avoid unnecessary file modifications +$shouldWrite = $true +if (Test-Path $cgManifestPath) { + $currentContent = Get-Content $cgManifestPath -Raw + # Normalize line endings and trim whitespace for comparison + $currentContentNormalized = $currentContent.Trim() -replace "`r`n", "`n" -replace "`r", "`n" + $newContentNormalized = $newContent.Trim() -replace "`r`n", "`n" -replace "`r", "`n" + $shouldWrite = $currentContentNormalized -ne $newContentNormalized +} -# Save the updated manifest -$cgManifest | ConvertTo-Json -Depth 10 | Out-File $cgManifestPath -Encoding utf8 -Write-Host "Updated cgmanifest.json saved to: $cgManifestPath" +if ($shouldWrite) { + $newContent | Out-File $cgManifestPath -Encoding utf8 + Write-Host "Updated cgmanifest.json saved to: $cgManifestPath" +} else { + Write-Host "No changes detected - cgmanifest.json is already up to date" +} # Print summary Write-Host "Successfully added $($newRegistrations.Count) package registrations to cgmanifest.json" diff --git a/global.json b/global.json index de526b5c39ef..7f2390ed2bb1 100644 --- a/global.json +++ b/global.json @@ -10,4 +10,4 @@ "sdk": { "allowPrerelease": true } -} +} \ No newline at end of file diff --git a/helix.cmd b/helix.cmd new file mode 100755 index 000000000000..19c9cea0f860 --- /dev/null +++ b/helix.cmd @@ -0,0 +1,15 @@ +@ECHO OFF + +:: This command sends helix test job from local machine + +SET DOTNET_ROOT=%~dp0.dotnet\ +SET BUILD_SOURCEBRANCH=main +SET BUILD_REPOSITORY_NAME=maui +SET SYSTEM_TEAMPROJECT=public +SET BUILD_REASON=test + +IF NOT EXIST "%DOTNET_ROOT%\dotnet.exe" ( + call dotnet build eng\helix.proj /restore /t:Test %* +) ELSE ( + call %DOTNET_ROOT%\dotnet.exe build eng\helix.proj /restore /t:Test %* +) \ No newline at end of file diff --git a/helix.sh b/helix.sh new file mode 100755 index 000000000000..56d555b4fe08 --- /dev/null +++ b/helix.sh @@ -0,0 +1,14 @@ +#!/usr/bin/env bash + +# This command sends helix test job from local machine + +export BUILD_SOURCEBRANCH="main" +export BUILD_REPOSITORY_NAME="maui" +export SYSTEM_TEAMPROJECT="public" +export BUILD_REASON="test" + +if [[ ! -f ".dotnet/dotnet" ]]; then + dotnet build eng/helix.proj /restore /t:Test "$@" +else + .dotnet/dotnet build eng/helix.proj /restore /t:Test "$@" +fi \ No newline at end of file diff --git a/src/Controls/docs/Microsoft.Maui.Controls.Internals/EnumerableExtensions.xml b/src/Controls/docs/Microsoft.Maui.Controls.Internals/EnumerableExtensions.xml deleted file mode 100644 index f848dfb3f6f2..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls.Internals/EnumerableExtensions.xml +++ /dev/null @@ -1,251 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - System.Object - - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - - - - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - - System.Runtime.CompilerServices.IteratorStateMachine(typeof(Microsoft.Maui.Controls.Internals.EnumerableExtensions/<GetChildGesturesFor>d__0`1)) - - - - System.Collections.Generic.IEnumerable<T> - - - - - Microsoft.Maui.Controls.GestureRecognizer - - - - - - - - - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.Runtime.CompilerServices.IteratorStateMachine(typeof(Microsoft.Maui.Controls.Internals.EnumerableExtensions/<GetGesturesFor>d__1`1)) - - - - System.Collections.Generic.IEnumerable<T> - - - - - Microsoft.Maui.Controls.GestureRecognizer - - - - - - - - - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Collections.Generic.IDictionary<TKey,System.Collections.Generic.List<TSource>> - - - - - - - - - - - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Int32 - - - - - - - - - - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Int32 - - - - - - - - - - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.Runtime.CompilerServices.IteratorStateMachine(typeof(Microsoft.Maui.Controls.Internals.EnumerableExtensions/<Prepend>d__7`1)) - - - - System.Collections.Generic.IEnumerable<T> - - - - - - - - - - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls.Internals/TextTransformUtilites.xml b/src/Controls/docs/Microsoft.Maui.Controls.Internals/TextTransformUtilites.xml deleted file mode 100644 index fda0537a7448..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls.Internals/TextTransformUtilites.xml +++ /dev/null @@ -1,77 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Object - - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.String - - - - - - - To be added. - To be added. - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Void - - - - - - - To be added. - To be added. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration/Android.xml b/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration/Android.xml deleted file mode 100644 index 2f2e284ec7c8..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration/Android.xml +++ /dev/null @@ -1,36 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - System.Object - - - - Microsoft.Maui.Controls.IConfigPlatform - - - - - - - - Constructor - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - Creates a new Android marker class. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration/GTK.xml b/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration/GTK.xml deleted file mode 100644 index 6472f00233e4..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration/GTK.xml +++ /dev/null @@ -1,39 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - System.Object - - - - Microsoft.Maui.Controls.IConfigPlatform - - - - Marker class that identifies the Linux platform. - - - - - - - Constructor - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - - Creates a new GTK marker class. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration/Tizen.xml b/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration/Tizen.xml deleted file mode 100644 index 918aadf5321f..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration/Tizen.xml +++ /dev/null @@ -1,36 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - System.Object - - - - Microsoft.Maui.Controls.IConfigPlatform - - - - - - - - Constructor - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - Creates a new Tizen marker class. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration/Windows.xml b/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration/Windows.xml deleted file mode 100644 index 9ae4b466e31e..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration/Windows.xml +++ /dev/null @@ -1,36 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - System.Object - - - - Microsoft.Maui.Controls.IConfigPlatform - - - - - - - - Constructor - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - Creates a new Windows marker class. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration/iOS.xml b/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration/iOS.xml deleted file mode 100644 index 96cfa8b259a3..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration/iOS.xml +++ /dev/null @@ -1,36 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - System.Object - - - - Microsoft.Maui.Controls.IConfigPlatform - - - - - - - - Constructor - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - Creates a new iOS marker class. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration/macOS.xml b/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration/macOS.xml deleted file mode 100644 index fa0be7d8f58c..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration/macOS.xml +++ /dev/null @@ -1,36 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - System.Object - - - - Microsoft.Maui.Controls.IConfigPlatform - - - - - - - - Constructor - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - Creates a new macOS marker class. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/AbsoluteLayout.xml b/src/Controls/docs/Microsoft.Maui.Controls/AbsoluteLayout.xml deleted file mode 100644 index 5807e2ac6cd8..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/AbsoluteLayout.xml +++ /dev/null @@ -1,520 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - - - Microsoft.Maui.Controls.Layout<Microsoft.Maui.Controls.View> - - Microsoft.Maui.Controls.View - - - - - Microsoft.Maui.Controls.IElementConfiguration<Microsoft.Maui.Controls.AbsoluteLayout> - - - - - - - - Constructor - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - Initializes a new instance of the AbsoluteLayout class. - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Double - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.AbsoluteLayout+IAbsoluteList<Microsoft.Maui.Controls.View> - - - Gets the collection of child elements of the AbsoluteLayout. - The collection of child elements. - - Application developers can use implicit collection syntax in XAML to add items to this collection, because this property is the ContentPropertyAttribute for the AbsoluteLayout class. - - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.TypeConverter(typeof(Microsoft.Maui.Controls.BoundsTypeConverter)) - - - - Microsoft.Maui.Controls.Shapes.Rectangle - - - - - - A visual element. - Gets the layout bounds of . - The layout bounds of the object. - - This method supports the AbsoluteLayout.LayoutBounds XAML attached property. In XAML, Application developers can specify a comma-separated list—possibly with spaces—of four values that specify the bounding rectangle's position and dimensions. The first two values in the list must represent numbers. The latter two values may each either be numbers, or the string "AutoSize". The AbsoluteLayout.LayoutFlags attached property determines how the values in the list are interpreted to create the bounding rectangle. - - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Layouts.AbsoluteLayoutFlags - - - - - - A visual element. - Gets the layout flags that were specified when was added to an . - The layout flags of the object. - - This method supports the AbsoluteLayout.LayoutFlags XAML attached property. In XAML, Application developers can specify the following enumeration value names for the value of this property on the children of a : - - - - All - - - - - None - - - - - HeightProportional - - - - - WidthProportional - - - - - SizeProportional - - - - - XProportional - - - - - YProportional - - - - - PositionProportional - - - - Application developers can combine any of the above values by supplying a comma-separated list. - - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - Implements the attached property that represents the layout bounds of child elements. Bindable at run time with the string "LayoutBounds". See Remarks. - The interface for this property is defined by the and methods. - - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - - - The X coordinate of the region that contains the child elements and that is used to calculate proportional values. - The Y coordinate of the region that contains the child elements and that is used to calculate proportional values. - The width of the the region that contains the child elements and that is used to calculate proportional values. - The height of the region that contains the child elements and that is used to calculate proportional values. - Positions and sizes the children of an AbsoluteLayout. - - Application developers can override to change the default behavior of . When doing so, it is recommended to call the base method and then modify the dimensions and locations of the children directly. - - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - Implements the attached property that contains the values for child elements. - The interface for this property is defined by the and methods. - - - - - - - - - Method - - M:Microsoft.Maui.Controls.IElementConfiguration`1.On``1 - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.IPlatformElementConfiguration<T,Microsoft.Maui.Controls.AbsoluteLayout> - - - - - Microsoft.Maui.Controls.IConfigPlatform - - - - - - The platform configuration that selects the platform specific to use. - Returns the configuration object that the developer can use to call platform-specific methods for the layout. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - The element that was added to the children. - Called when a child is added to the . - - Application developers can override to change the default behavior thata is triggered when a child is added. When doing so, it is recommended to call the base method and then add additional logic. - - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.Obsolete("OnChildRemoved(Element) is obsolete as of version 4.8.0. Please use OnChildRemoved(Element, int) instead.") - - - - System.Void - - - - - - The element that was removed from the children. - Called when a child is removed from the . - - Application developers can override to change the default behavior thata is triggered when a child is removed. When doing so, it is recommended to call the base method and then add additional logic. - - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Void - - - - - - - To be added. - To be added. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - System.Obsolete("OnSizeRequest is obsolete as of version 2.2.0. Please use OnMeasure instead.") - - - - Microsoft.Maui.SizeRequest - - - - - - - The available width for the AbsoluteLayout to use. - The available height for the AbsoluteLayout to use. - Called during the measure pass of a layout cycle to get the desired size of the AbsoluteLayout. - A which contains the desired size of the AbsoluteLayout. - - Application developers can override to change the default behavior thata is triggered when a child is removed. When doing so, it is recommended to call the base method and then modify the dimensions and locations of the children directly. - - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - The view to delimit by . - A rectangle that represents the desired size and shape of . - Sets the layout bounds of a view that will be used to size it when it is layed out. - - This method supports the AbsoluteLayout.LayoutBounds XAML attached property. In XAML, Application developers can specify a comma-separated list—possibly with spaces—of four values that specify the bounding rectangle's position and dimensions. The first two values in the list must represent numbers. The latter two values may each either be numbers, or the string "AutoSize". The AbsoluteLayout.LayoutFlags attached property determines how the values in the list are interpreted to create the bounding rectangle. Application developers can call this method to update the layout of a view after it is added. - - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/Animation.xml b/src/Controls/docs/Microsoft.Maui.Controls/Animation.xml deleted file mode 100644 index aaafdf61d6a3..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/Animation.xml +++ /dev/null @@ -1,328 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - - - System.Object - - - - System.Collections.IEnumerable - - - - Encapsulates an animation, a collection of functions that modify properties over a user-perceptible time period. - - - - - - - Constructor - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - Creates a new object with default values. - - - - - - - - Constructor - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - - - - - - - An action that is called with successive animation values. - The fraction into the current animation at which to start the animation. - The fraction into the current animation at which to end the animation. - The easing function to use to transision in, out, or in and out of the animation. - An action to call when the animation is finished. - Creates a new object with the specified parameters. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - - The fraction into this animation at which the added child animation will begin animating. - The fraction into this animation at which the added child animation will stop animating. - The animation to add. - Adds an object to this that begins at and finishes at . - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - - - - - - The owning animation that will be animated. - The name, or handle, that is used to access and track the animation and its state. - The time, in milliseconds, between frames. - The number of milliseconds over which to interpolate the animation. - The easing function to use to transision in, out, or in and out of the animation. - An action to call when the animation is finished. - A function that returns true if the animation should continue. - Runs the animation with the supplied parameters. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Action<System.Double> - - - - Returns a callback that recursively runs the eased animation step on this object and those of its children that have begun and not finished. - A callback that recursively runs the eased animation step on this object and those of its children that have begun and not finished. - - - - - - - - Method - - M:System.Collections.IEnumerable.GetEnumerator - - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Collections.IEnumerator - - - - Returns an enumerator that can be used to iterate over the child objects of this object. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.Animation - - - - - - - - The fraction into this animation at which the added child animation will begin animating. - The fraction into this animation at which the added child animation will stop animating. - The animation to add. - Adds an object to this that begins at and finishes at . - - - - - - - - Property - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Boolean - - - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.Animation - - - - - - - - The animation to add. - The fraction into this animation at which the added child animation will begin animating. - The fraction into this animation at which the added child animation will stop animating. - Adds to the children of this object and sets the start and end times of to and , respectively. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.Animation - - - - - - - - - - - An action that is called with successive animation values. - The fraction into the current animation at which to start the animation. - The fraction into the current animation at which to end the animation. - The easing function to use to transision in, out, or in and out of the animation. - The fraction into this animation at which the added child animation will begin animating. - The fraction into this animation at which the added child animation will stop animating. - Creates a new object with the specified , and adds it to the children of this object. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/Behavior.xml b/src/Controls/docs/Microsoft.Maui.Controls/Behavior.xml deleted file mode 100644 index d9e158cfbb0c..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/Behavior.xml +++ /dev/null @@ -1,110 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - - - Microsoft.Maui.Controls.BindableObject - - - - - Base class for generalized user-defined behaviors that can respond to arbitrary conditions and events. - Application developers should specialize the generic class, instead of directly using . - - - - - - - Constructor - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - - Creates a new Behavior with default values. - - - - - - - - Property - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Type - - - Gets the type of the objects with which this can be associated. - - - - - - - - Method - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - The bindable object to which the behavior was attached. - Application developers override this method to implement the behaviors that will be associated with . - - - - - - - - Method - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - The bindable object from which the behavior was detached. - Application developers override this method to remove the behaviors from that were implemented in a previous call to the method. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/BindableObject.xml b/src/Controls/docs/Microsoft.Maui.Controls/BindableObject.xml deleted file mode 100644 index 025ddfb9cd3d..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/BindableObject.xml +++ /dev/null @@ -1,986 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - - - System.Object - - - - System.ComponentModel.INotifyPropertyChanged - - - Microsoft.Maui.Controls.Internals.IDynamicResourceHandler - - - - Provides a mechanism by which application developers can propagate changes that are made to data in one object to another, by enabling validation, type coercion, and an event system. . - - The class provides a data storage mechanism that enables the application developer to synchronize data between objects in response to changes, for example, between the View and View Model in the MVVM design pattern. All of the visual elements in the namespace inherit from class, so they can all be used to bind the data behind their user interface elements to View Models that are supplied by the application developer. - - To bind the data behind a property in a , typically a view, to a property in the View Model, application developers should do the following. - First, the developer creates a pair of properties on the view, one of which is a , and the other of which is a property of whatever type is required. In the code below, MockBindableObject stands in for what would typically be a user interface object in production code. Application developers should note the use of and to get and set the value on the bound property; The property of the desired type provides the interface that the target of the bound property will implement. - ( - // o => o.Foo, default (string) - // ); - - public string BoundName - { - get { return (string) GetValue (BoundNameProperty); } - set { SetValue (BoundNameProperty, value); } - } -} - ]]> - Second, the developer creates the implementation for the bound property in a class that implements the interface. In the MVVM design pattern, this is typically done by the View Model. Application developers should implement the interface on classes that they want to use as View Models. In the example below, app developers should take note of the idiomatic way that the Name property is implemented to, first, ensure that the property actually changed and return if it did not, and only then assign the value and call the method. Additionally, the Name property in the example below merely wraps the name field. In practice, the application developer may choose a different model in which to store application data. - - Third, and finally, the application developer binds an instance of a BindableObject to an instance that implements INotifyPropertyChanged. In the vocabulary of the MVVM design pattern, this is "binding an instance of the View to an instance of a View Model." Once this step is complete, changes in the data are propagated between the View and View Model in a way that is determined by the value of the enumeration, if any, that was passed during the binding step. - The code below, when included in a project that reference the classes above, creates an instance of both MockBindable and MockViewModel, performs some intitialization, sets the binding, and then demonstrates a one-way binding. The code below runs without throwing an exception. - - - - - - - - - - Constructor - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - Initializes a new instance of the BindableObject class. - The class is abstract, and this constructor is protected. It is invoked by child constructors. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - Apply the bindings to . - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Object - - - Gets or sets object that contains the properties that will be targeted by the bound properties that belong to this . - An that contains the properties that will be targeted by the bound properties that belong to this . This is a bindable property. - - Typically, the runtime performance is better if is set after all calls to have been made. - The following example shows how to apply a BindingContext and a Binding to a Label (inherits from BindableObject): - - - - - - - - - - - - Event - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.EventHandler - - - Raised whenever the property changes. - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - Implements the bound property whose interface is provided by the property. - - Typically, the runtime performance is better if is set after all calls to have been made. - The following example shows how to set a binding to the BindingContext: - - - - - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - The BindableProperty to clear. - Clears any value set by for . - - Calling this method on a readonly property will result in an InvalidOperationException. - - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - The BindablePropertyKey that identifies the to clear. - Clears any value set by for the property that is identified by . - - Calling this method on a readonly property will result in an InvalidOperationException. - - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Void - - - - - - To be added. - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Void - - - - - - To be added. - - - - - - - - Property - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.IDispatcher - - - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Object - - - - - - The BindableProperty for which to get the value. - Returns the value that is contained in the BindableProperty. - The value that is contained in the . - - - and are used to access the values of properties that are implemented by a . That is, application developers typically provide an interface for a bound property by defining property whose accessor casts the result of to the appropriate type and returns it, and whose accessor uses to set the value on the correct property. Application developers should perform no other steps in the public property that defines the interface of the bound property. - - The following example shows how to create a bindable property interface for an implementation that will be provided in the target property when the binding is made at run time. - (w => w.My, default(string)); - - public string My { - get { return (string)GetValue (MyProperty); } - set { SetValue (MyProperty, value); } - } -} - ]]> - - - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - System.Obsolete("GetValues is obsolete as of 4.0.0. Please use GetValue instead.") - - - - System.Object[] - - - - - - - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - System.Obsolete("GetValues is obsolete as of 4.0.0. Please use GetValue instead.") - - - - System.Object[] - - - - - - - - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - System.Boolean - - - - - - The property to check. - Returns if the target property exists and has been set. - - if the target property exists and has been set. If the property has not been set, returns . If the is null, an ArgumentNullException is thrown. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - Override this method to execute an action when the BindingContext changes. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - System.Runtime.CompilerServices.CallerMemberName - - - - - - The name of the property that changed. - Call this method from a child class to notify that a change happened on a property. - - A triggers this by itself. An inheritor only needs to call this for properties without as the backend store. - - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - System.Runtime.CompilerServices.CallerMemberName - - - - - - The name of the property that is changing. - Call this method from a child class to notify that a change is going to happen on a property. - A triggers this by itself. An inheritor only needs to call this for properties without as the backend store. - - - - - - - - Event - - E:System.ComponentModel.INotifyPropertyChanged.PropertyChanged - - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.ComponentModel.PropertyChangedEventHandler - - - Raised when a property has changed. - - - - - - - - Event - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.PropertyChangingEventHandler - - - Raised when a property is about to change. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - The BindableProperty from which to remove bindings. - Removes a previously set binding. - - This method succeeds even if is not bound. - - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - The BindableProperty on which to set a binding. - The binding to set. - Assigns a binding to a property. - - The following example shows how to set a binding to a property: - - - - - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Void - - - - - - - The object on which to set the inherited binding context. - The inherited context to set. - Sets the inherited context to a nested element. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - The BindableProperty on which to assign a value. - The value to set. - Sets the value of the specified property. - - - and are used to access the values of properties that are implemented by a . That is, application developers typically provide an interface for a bound property by defining property whose accessor casts the result of to the appropriate type and returns it, and whose accessor uses to set the value on the correct property. Application developers should perform no other steps in the public property that defines the interface of the bound property. - - The following example shows how to create a bindable property interface for an implementation that will be provided in the target property when the binding is made at run time. - (w => w.My, default(string)); - - public string My { - get { return (string)GetValue (MyProperty); } - set { SetValue (MyProperty, value); } - } -} - ]]> - - - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - The BindablePropertyKey on which to assign a value. - The value to set. - Sets the value of the propertyKey. - - This method and are useful to implement BindableProperties with limited write access. The write access is limited to the scope of the BindablePropertyKey. - The following example shows how to declare a BindableProperty with "internal" write access. - - (w => w.My, default(string)); - public static readonly BindableProperty MyProperty = MyPropertyKey.BindableProperty; - - public string My { - get { return (string)GetValue (MyProperty); } - internal set { SetValue (MyPropertyKey, value); } - } -} - ]]> - - - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Void - - - - - - - - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - Unapplies all previously set bindings. - - This method removes all current bindings from the current context. - Changing a bound property requires that the binding count for a bound property must be 0. The method merely decrements the count, and does not remove all bindings everywhere. - - - - - - - - - Method - - M:Microsoft.Maui.Controls.Internals.IDynamicResourceHandler.SetDynamicResource(Microsoft.Maui.Controls.BindableProperty,System.String) - - - 0.0.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/Button.xml b/src/Controls/docs/Microsoft.Maui.Controls/Button.xml deleted file mode 100644 index 485849945ca5..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/Button.xml +++ /dev/null @@ -1,1621 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - - - Microsoft.Maui.Controls.View - - - - Microsoft.Maui.Controls.IBorderElement - - - Microsoft.Maui.Controls.IButtonController - - - Microsoft.Maui.Controls.IElementConfiguration<Microsoft.Maui.Controls.Button> - - - Microsoft.Maui.Controls.IElementController - - - Microsoft.Maui.Controls.IImageController - - - Microsoft.Maui.Controls.IImageElement - - - Microsoft.Maui.Controls.Internals.IFontElement - - - Microsoft.Maui.Controls.IViewController - - - Microsoft.Maui.Controls.IVisualElementController - - - - - Microsoft.Maui.Controls.RenderWith(typeof(Microsoft.Maui.Controls.Platform._ButtonRenderer)) - - - - A button that reacts to touch events. - - -

Button Appearance

- - In addition to the appearance properties common to all objects, the Button class provides the , , and properties. - - The XAML code snippet below demonstrates how to use these properties to create a basic button with the text "Press me!" The image that the button displays appears on the start side of the layout, which is the left side for left-to-right languages. - -]]> - To display the icon.png image with the above XAML, the developer must place it in the appropriate location, with the appropriate build action, specific to each platform project. - - -

Button Events

- - Buttons notify the developer of press, release, and click events with the , , and events, respectively. - - The following XAML assigns handlers to two of these button events: - -]]> - With the XAML above, the following event handlers in the code-behind file change the button's text when these events are raised: - - - -

Commands

- - The commanding API for buttons allows the developer to run a command in response to what would otherwise be the Clicked event. - - The following XAML specifes a command to run when the button is clicked. The command updates a view model property called modelUpdateCount, which the button then uses to update its text. (The text binding is shown for completeness. Only the commanding code is relevant.): - -]]> - With the XAML above, the developer first defines the IncrementLabelCommand property on the view model and implements a method with which to later instantiate the command: - - Second, the developer initializes the command with the method (or action): - - Finally, the developer must sets the binding context in the constructor for the main page to that of the view model where the property is implemented: - - - - - - - - - - Constructor - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - Initializes a new instance of the Button class. - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Graphics.Color - - - Gets or sets a color that describes the border stroke color of the button. This is a bindable property. - The color that is used as the border stroke color. - This property has no effect if is set to 0. On Android this property will not have an effect unless is set to a non-default color. - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - The backing store for the bindable property. - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Double - - - Gets or sets the width of the border. This is a bindable property. - The width of the button border; the default is 0. - Set this value to a non-zero value in order to have a visible border. - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - The backing store for the bindable property. - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Void - - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Property - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Double - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.BindableProperty - - - The backing store for the bindable property. - - - - - - - - Event - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.EventHandler - - - Occurs when the Button is clicked. - The user may be able to raise the clicked event using accessibility or keyboard controls when the Button has focus. - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Windows.Input.ICommand - - - Gets or sets the command to invoke when the button is activated. This is a bindable property. - A command to invoke when the button is activated. The default value is . - This property is used to associate a command with an instance of a button. This property is most often set in the MVVM pattern to bind callbacks back into the ViewModel. is controlled by the Command if set. - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Object - - - Gets or sets the parameter to pass to the Command property. This is a bindable property. - A object to pass to the command property. The default value is . - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - The backing store for the bindable property. - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - The backing store for the bindable property. - - - - - - - - Property - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.Button+ButtonContentLayout - - - Gets or sets an object that controls the position of the button image and the spacing between the button's image and the button's text. - - - - - - - - Field - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - The backing store for the bindable property. - - - - - - - - Property - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - System.Int32 - - - Gets or sets the corner radius for the button, in device-independent units. - The corner radius for the button, in device-independent units. - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - Microsoft.Maui.Controls.BindableProperty - - - The backing store for the bindable property. - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.Font - - - Gets or sets the Font for the Label text. This is a bindable property. - The value for the button. The default is , which represents the default font on the platform. - - - - - - - - Property - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.FontAttributes - - - Gets a value that indicates whether the font for the button text is bold, italic, or neither. - - - - - - - - Field - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - The backing store for the bindable property. - - - - - - - - Property - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.String - - - Gets the font family to which the font for the button text belongs. - - - - - - - - Field - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - The backing store for the bindable property. - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - The backing store for the bindable property. - - - - - - - - Property - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.TypeConverter(typeof(Microsoft.Maui.Controls.FontSizeConverter)) - - - - System.Double - - - Gets or sets the size of the font of the button text. - - - - - - - - Field - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - The backing store for the bindable property. - - - - - - - - Property - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.ImageSource - - - Allows you to display a bitmap image on the Button. - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.BindableProperty - - - The backing store for the bindable property. - - - - - - - - Property - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Boolean - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.BindableProperty - - - The backing store for the bindable property. - - - - - - - - Method - - M:Microsoft.Maui.Controls.IElementConfiguration`1.On``1 - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.IPlatformElementConfiguration<T,Microsoft.Maui.Controls.Button> - - - - - Microsoft.Maui.Controls.IConfigPlatform - - - - - - To be added. - Returns the platform-specific instance of this , on which a platform-specific method may be called. - - - - - - - - Method - - 0.0.0.0 - 1.2.2.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - Method that is raised when the binding context changes. - - Application developers who override this method in derived classes must call this method in the base class, . - - - - - - - - - Property - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - Microsoft.Maui.Thickness - - - Gets or sets the padding for the button. - The padding for the button. - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - Microsoft.Maui.Controls.BindableProperty - - - The backing store for the bindable property. - - - - - - - - Event - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.EventHandler - - - Occurs when the Button is pressed. - - - - - - - - Event - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.EventHandler - - - Occurs when the Button is released. - The released event always occur before the clicked event. - - - - - - - - Method - - M:Microsoft.Maui.Controls.IButtonController.SendClicked - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Void - - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - M:Microsoft.Maui.Controls.IButtonController.SendPressed - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Void - - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - M:Microsoft.Maui.Controls.IButtonController.SendReleased - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Void - - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.String - - - Gets or sets the Text displayed as the content of the button. This is a bindable property. - The text displayed in the button. The default value is . - Changing the Text of a button will trigger a layout cycle. - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Graphics.Color - - - Gets or sets the for the text of the button. This is a bindable property. - The value. - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - The backing store for the bindable property. - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - The backing store for the bindable property. - - - - - - - - Property - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.TextTransform - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.BindableProperty - - - The backing store for the bindable property. - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - To be added. - To be added. - - - - - - - - Property - - P:Microsoft.Maui.Controls.IBorderElement.BorderColorDefaultValue - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Graphics.Color - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Property - - P:Microsoft.Maui.Controls.IBorderElement.BorderWidthDefaultValue - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Double - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Property - - P:Microsoft.Maui.Controls.IBorderElement.CornerRadiusDefaultValue - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Int32 - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - M:Microsoft.Maui.Controls.IBorderElement.IsBackgroundColorSet - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Boolean - - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - M:Microsoft.Maui.Controls.IBorderElement.IsBackgroundSet - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Boolean - - - - - - - - - - - Method - - M:Microsoft.Maui.Controls.IBorderElement.IsBorderColorSet - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Boolean - - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - M:Microsoft.Maui.Controls.IBorderElement.IsBorderWidthSet - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Boolean - - - - For internal use by the Microsoft.Maui.Controls platform.. - - - - - - - - Method - - M:Microsoft.Maui.Controls.IBorderElement.IsCornerRadiusSet - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Boolean - - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - M:Microsoft.Maui.Controls.IBorderElement.OnBorderColorPropertyChanged(Microsoft.Maui.Graphics.Color,Microsoft.Maui.Graphics.Color) - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Void - - - - - - - To be added. - To be added. - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - M:Microsoft.Maui.Controls.IImageController.GetLoadAsAnimation - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Boolean - - - - - - - - - - - Method - - M:Microsoft.Maui.Controls.IImageController.SetIsLoading(System.Boolean) - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Void - - - - - - To be added. - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Property - - P:Microsoft.Maui.Controls.IImageElement.Aspect - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Aspect - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Property - - P:Microsoft.Maui.Controls.IImageElement.IsAnimationPlaying - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Boolean - - - - - - - - - - Property - - P:Microsoft.Maui.Controls.IImageElement.IsLoading - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Boolean - - - - - - - - - - Property - - P:Microsoft.Maui.Controls.IImageElement.IsOpaque - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Boolean - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - M:Microsoft.Maui.Controls.IImageElement.OnImageSourceSourceChanged(System.Object,System.EventArgs) - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Void - - - - - - - To be added. - To be added. - - - - - - - - Method - - M:Microsoft.Maui.Controls.IImageElement.RaiseImageSourcePropertyChanged - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Void - - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Property - - P:Microsoft.Maui.Controls.IImageElement.Source - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.ImageSource - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - M:Microsoft.Maui.Controls.Internals.IFontElement.FontSizeDefaultValueCreator - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Double - - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - M:Microsoft.Maui.Controls.Internals.IFontElement.OnFontAttributesChanged(Microsoft.Maui.Controls.FontAttributes,Microsoft.Maui.Controls.FontAttributes) - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - M:Microsoft.Maui.Controls.Internals.IFontElement.OnFontChanged(Microsoft.Maui.Controls.Font,Microsoft.Maui.Controls.Font) - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - M:Microsoft.Maui.Controls.Internals.IFontElement.OnFontFamilyChanged(System.String,System.String) - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - M:Microsoft.Maui.Controls.Internals.IFontElement.OnFontSizeChanged(System.Double,System.Double) - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - For internal use by the Microsoft.Maui.Controls platform. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/EasingTypeConverter.xml b/src/Controls/docs/Microsoft.Maui.Controls/EasingTypeConverter.xml deleted file mode 100644 index 1176e885804d..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/EasingTypeConverter.xml +++ /dev/null @@ -1,56 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.ComponentModel.TypeConverter - - - - - Microsoft.Maui.Controls.Xaml.TypeConversion(typeof(Microsoft.Maui.Controls.Easing)) - - - - - - - - - - Constructor - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Object - - - - - - To be added. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/FontTypeConverter.xml b/src/Controls/docs/Microsoft.Maui.Controls/FontTypeConverter.xml deleted file mode 100644 index 381c25c224cd..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/FontTypeConverter.xml +++ /dev/null @@ -1,75 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - - - System.ComponentModel.TypeConverter - - - - - Microsoft.Maui.Controls.Xaml.TypeConversion(typeof(Microsoft.Maui.Controls.Font)) - - - - A that converts from strings to . - String should be formatted as "[name],[attributes],[size]" there may be multiple attributes, e.g. "Georgia, Bold, Italic, 42" - - - - - - - Constructor - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - Creates a new with default values. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Object - - - - - - The value to convert. - Converts into a . - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/GridLengthTypeConverter.xml b/src/Controls/docs/Microsoft.Maui.Controls/GridLengthTypeConverter.xml deleted file mode 100644 index 522551749b6a..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/GridLengthTypeConverter.xml +++ /dev/null @@ -1,89 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - - - System.ComponentModel.TypeConverter - - - - - Microsoft.Maui.Controls.Xaml.TypeConversion(typeof(Microsoft.Maui.GridLength.Star)) - - - - A that converts from strings to s. - - The following example shows some uses of : - - - - - - - - - - - Constructor - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - Creates a new object with default values. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Object - - - - - - The value to convert. - Converts a valid grid length descriptor in to a . - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/Layout.xml b/src/Controls/docs/Microsoft.Maui.Controls/Layout.xml deleted file mode 100644 index a6f210619921..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/Layout.xml +++ /dev/null @@ -1,670 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.3.5.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - - - Microsoft.Maui.Controls.View - - - - Microsoft.Maui.Controls.ILayout - - - Microsoft.Maui.Controls.ILayoutController - - - - - Provides the base class for all Layout elements. Use Layout elements to position and size child elements in Microsoft.Maui.Controls applications. - - - Subtypes of include , , and , as shown in the following diagram. - The property of contains a list of children of the parameterized type T, which must be a type of . Since is itself a subclass of , this allows s to hold sub-layouts, scrolling regions, & etc. - - - - - - - - - - - Constructor - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - Intitializes a new instance. - - - - - - - - Property - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - System.Boolean - - - Gets or sets a value that controls whether child elements inherit the input transparency of layout when the tranparency is . - - to cause child elements to inherit the input transparency of layout, when layout's is true. to cause child elements to ignore the input tranparency of layout. - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - Microsoft.Maui.Controls.BindableProperty - - - Backing store for the property. - - - - - - - - Property - - P:Microsoft.Maui.Controls.ILayoutController.Children - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Collections.Generic.IReadOnlyList<Microsoft.Maui.Controls.Element> - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - Forces a layout cycle on the element and all of its descendants. - - Calling ForceLayout frequently can have negative impacts on performance. - - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - System.Obsolete("OnSizeRequest is obsolete as of version 2.2.0. Please use OnMeasure instead.") - - - - Microsoft.Maui.SizeRequest - - - - - - - The available width that a parent Layout can allocate to a child. Value will be between 0 and double.PositiveInfinity. - The available height that a parent Layout can allocate to a child. Value will be between 0 and double.PositiveInfinity. - Returns the of the Layout. Calling this method begins the measure pass of a layout cycle. - A which contains a requested size and a minimum size. - - - Calling GetSizeRequest causes a measure pass to occur for the subtree of elements it is called on. It is ideal to only call GetSizeRequest when needed as excessive calls can negatively impact the performance of the app. Overriding GetSizeRequest should only be done if the developer wants to ignore Width/HeightRequest. More likely a subclass would wish to override . - - - - - - - - - - Method - - 0.0.0.0 - 1.2.2.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - Invalidates the current layout. - Calling this method will invalidate the measure and triggers a new layout cycle. - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Boolean - - - Gets or sets a value which determines if the Layout should clip its children to its bounds. - - if the Layout is clipped; otherwise, . The default value is . - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - Identifies the bindable property. - - - - - - - - Event - - E:Microsoft.Maui.Controls.ILayout.LayoutChanged - - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.EventHandler - - - Occurs at the end of a layout cycle if any of the child element's have changed. - - Developers wishing to implement animations may wish to begin them at the end of a LayoutChanged event. - - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - The child element to be positioned. - The bounding region in which the child should be positioned. - Positions a child element into a bounding region while respecting the child elements and . - This method is called in the layout cycle after the general regions for each child have been calculated. This method will handle positioning the element relative to the bounding region given if the bounding region given is larger than the child's desired size. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - - - A value representing the x coordinate of the child region bounding box. - A value representing the y coordinate of the child region bounding box. - A value representing the width of the child region bounding box. - A value representing the height of the child region bounding box. - Positions and sizes the children of a Layout. - Implementors wishing to change the default behavior of a Layout should override this method. It is suggested to still call the base method and modify its calculated results. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - The view to lower in the visual stack. - Sends a child to the back of the visual stack. - Children are internally stored in visual stack order. This means that raising or lowering a child also changes the order in which the children are enumerated. - - - - - - - - Method - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - Invoked whenever a child of the layout has emitted . Implement this method to add class handling for this event. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - The child element whose preferred size changed. - The event data. - Invoked whenever a child of the layout has emitted . Implement this method to add class handling for this event. - This method has a default implementation and and application developers must call the base implementation. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - The new width of the element. - The new height of the element. - This method is called when the size of the element is set during a layout cycle. This method is called directly before the event is emitted. Implement this method to add class handling for this event. - This method has a default implementation which triggers the layout cycle of the Layout to begin. - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Thickness - - - Gets or sets the inner padding of the Layout. - The Thickness values for the layout. The default value is a Thickness with all values set to 0. - - - The padding is the space between the bounds of a layout and the bounding region into which its children should be arranged into. - - - The following example shows setting the padding of a Layout to inset its children. - - - - - - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - Identifies the Padding bindable property. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - The view to raise in the visual stack. - Sends a child to the front of the visual stack. - Children are internally stored in visual stack order. This means that raising or lowering a child also changes the order in which they are enumerated. - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Void - - - - - - - - - - - Method - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Boolean - - - - - - The child for which to specify whether or not to track invalidation. - When implemented, should return if should call , and to return if it should not. - - - - - - - - Method - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Boolean - - - - - - The child for which to specify whether or not to track invalidation. - When implemented, should return if should call when it is removed, and to return if it should not. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - Instructs the layout to relayout all of its children. - This method starts a new layout cycle for the layout. Invoking this method frequently can negatively impact performance. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/Menu.xml b/src/Controls/docs/Microsoft.Maui.Controls/Menu.xml deleted file mode 100644 index 500adfce47d0..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/Menu.xml +++ /dev/null @@ -1,427 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - Microsoft.Maui.Controls.BaseMenuItem - - - - System.Collections.Generic.ICollection<T> - - - System.Collections.Generic.ICollection<Microsoft.Maui.Controls.Menu> - - - System.Collections.Generic.IEnumerable<T> - - - System.Collections.Generic.IEnumerable<Microsoft.Maui.Controls.Menu> - - - System.Collections.Generic.IList<Microsoft.Maui.Controls.Menu> - - - System.Collections.IEnumerable - - - - Represents an application menu on platforms that support them. - - - - - - - Constructor - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - Creates a new menu with default values. - - - - - - - - Method - - M:System.Collections.Generic.ICollection`1.Add(`0) - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - The menu to add to this menu. - Add to the end of the collection of menus in this menu. - - - - - - - - Method - - M:System.Collections.Generic.ICollection`1.Clear - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - Clears all the menus from this menu. - - - - - - - - Method - - M:System.Collections.Generic.ICollection`1.Contains(`0) - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Boolean - - - - - - The menu whose presence to check. - Returns if is contained in the top-level collection of menus that belong to this menu. Otherwise, returns . - - if is contained in the top-level collection of menus that belong to this menu. Otherwise, . - - - - - - - - Method - - M:System.Collections.Generic.ICollection`1.CopyTo(`0[],System.Int32) - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - The menu items to copy into this menu. - The index at which to begin inserting menus. - Copies into this menu's collection of menus, beginning at . - - - - - - - - Property - - P:System.Collections.Generic.ICollection`1.Count - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Int32 - - - Gets the number of menus that are contained in this menu. - - - - - - - - Method - - M:System.Collections.Generic.IEnumerable`1.GetEnumerator - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Collections.Generic.IEnumerator<Microsoft.Maui.Controls.Menu> - - - - Returns an enumerator for the menus that are contained in this menu. - - - - - - - - Method - - M:System.Collections.Generic.IList`1.IndexOf(`0) - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Int32 - - - - - - The menu whose index to get. - Returns the index of . - - - - - - - - Method - - M:System.Collections.Generic.IList`1.Insert(System.Int32,`0) - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - The index at which to insert . - The menu to insert. - Inserts into this menu's collection of items at . - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - Visually displays the menu as invalid. - - - - - - - - Property - - P:System.Collections.Generic.ICollection`1.IsReadOnly - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Boolean - - - Returns . - - . - - - - - - - - Property - - P:System.Collections.Generic.IList`1.Item(System.Int32) - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.Menu - - - - - - The index of the item to get or set. - Gets or sets the menu at . - The menu at . - - - - - - - - Property - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Collections.ObjectModel.ObservableCollection<Microsoft.Maui.Controls.MenuItem> - - - Gets the collection of menus that belong to this menu. - - - - - - - - Method - - M:System.Collections.Generic.ICollection`1.Remove(`0) - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Boolean - - - - - - The menu to remove. - Removes . - - - - - - - - Method - - M:System.Collections.Generic.IList`1.RemoveAt(System.Int32) - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - The index for the menu to remove. - Removes the menu at . - - - - - - - - Method - - M:System.Collections.IEnumerable.GetEnumerator - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Collections.IEnumerator - - - - For internal use only. - - - - - - - - Property - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.String - - - Gets or sets the text of the menu. - The menu text. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/NamedPlatformColor.xml b/src/Controls/docs/Microsoft.Maui.Controls/NamedPlatformColor.xml deleted file mode 100644 index 91212ec04117..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/NamedPlatformColor.xml +++ /dev/null @@ -1,1586 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Object - - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/OSAppTheme.xml b/src/Controls/docs/Microsoft.Maui.Controls/OSAppTheme.xml deleted file mode 100644 index d91fa42d71ee..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/OSAppTheme.xml +++ /dev/null @@ -1,68 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Enum - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.OSAppTheme - - 2 - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.OSAppTheme - - 1 - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.OSAppTheme - - 0 - - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/Page.xml b/src/Controls/docs/Microsoft.Maui.Controls/Page.xml deleted file mode 100644 index e1614cb78b1f..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/Page.xml +++ /dev/null @@ -1,1224 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - - - Microsoft.Maui.Controls.VisualElement - - - - Microsoft.Maui.Controls.IElementConfiguration<Microsoft.Maui.Controls.Page> - - - Microsoft.Maui.Controls.IElementController - - - Microsoft.Maui.Controls.ILayout - - - Microsoft.Maui.Controls.IPageController - - - Microsoft.Maui.Controls.IVisualElementController - - - - - Microsoft.Maui.Controls.RenderWith(typeof(Microsoft.Maui.Controls.Platform._PageRenderer)) - - - - A that occupies the entire screen. - - - is primarily a base class for more useful derived types. Objects that are derived from the class are most prominently used as the top level UI element in Microsoft.Maui.Controls applications. In addition to their role as the main pages of applications, objects and their descendants can be used with navigation classes, such as or , among others, to provide rich user experiences that conform to the expected behaviors on each platform. - - - - - - - - Constructor - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - Creates a new element with default values. - - - - - - - - Field - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.String - - - This method is for internal use. - - - - - - - - Field - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.String - - - This method is for internal use. - - - - - - - - Event - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.EventHandler - - - Indicates that the is about to appear. - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - System.Obsolete("BackgroundImage is obsolete as of 4.0.0. Please use BackgroundImageSource instead.") - - - - System.String - - - Identifies the image used as a background for the . - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - System.Obsolete("BackgroundImageProperty is obsolete as of 4.0.0. Please use BackgroundImageSourceProperty instead.") - - - - Microsoft.Maui.Controls.BindableProperty - - - Identifies the property. - - - - - - - - Property - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.ImageSource - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.BindableProperty - - - - - - - - - - Field - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.String - - - This method is for internal use. - - - - - - - - Property - - P:Microsoft.Maui.Controls.IPageController.ContainerArea - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - Microsoft.Maui.Controls.Shapes.Rectangle - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Event - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.EventHandler - - - Indicates that the is about to cease displaying. - is raised when the page disappears due to navigating away from the page within the app. It is not raised when the app disappears due to an event external to the app (e.g. user navigates to the home screen or another app, a phone call is received, the device is locked, the device is turned off). - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Threading.Tasks.Task<System.String> - - - - - - - - - System.ParamArray - - - - - - Title of the displayed action sheet. Must not be . - Text to be displayed in the 'Cancel' button. Can be to hide the cancel action. - Text to be displayed in the 'Destruct' button. Can be to hide the destructive option. - Text labels for additional buttons. Must not be . - Displays a native platform action sheet, allowing the application user to choose from several buttons. - An awaitable Task that displays an action sheet and returns the Text of the button pressed by the user. - - Developers should be aware that Windows' line endings, CR-LF, only work on Windows systems, and are incompatible with iOS and Android. A particular consequence of this is that characters that appear after a CR-LF, (For example, in the title.) may not be displayed on non-Windows platforms. Developers must use the correct line endings for each of the targeted systems. - - - - - - - - - Method - - 0.0.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Threading.Tasks.Task - - - - - - - - The title of the alert dialog. - The body text of the alert dialog. - Text to be displayed on the 'Cancel' button. - Presents an alert dialog to the application user with a single cancel button. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Threading.Tasks.Task<System.Boolean> - - - - - - - - - The title of the alert dialog. - The body text of the alert dialog. - Text to be displayed on the 'Accept' button. - Text to be displayed on the 'Cancel' button. - Presents an alert dialog to the application user with an accept and a cancel button. - A task that contains the user's choice as a Boolean value. indicates that the user accepted the alert. indicates that the user cancelled the alert. - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - System.Obsolete("DisplayPromptAsync overload is obsolete as of version 4.5.0 and is no longer supported.") - - - - System.Threading.Tasks.Task<System.String> - - - - - - - - - - - - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Threading.Tasks.Task<System.String> - - - - - - - - - - - - - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - Forces the to perform a layout pass. - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - System.Obsolete("Icon is obsolete as of 4.0.0. Please use IconImageSource instead.") - - - - Microsoft.Maui.Controls.FileImageSource - - - Resource identifier for the 's associated icon. - - - - - - - - Property - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.ImageSource - - - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.BindableProperty - - - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - System.Obsolete("IconProperty is obsolete as of 4.0.0. Please use IconImageSourceProperty instead.") - - - - Microsoft.Maui.Controls.BindableProperty - - - Identifies the property. - - - - - - - - Property - - P:Microsoft.Maui.Controls.IPageController.IgnoresContainerArea - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Boolean - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Property - - P:Microsoft.Maui.Controls.IPageController.InternalChildren - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Collections.ObjectModel.ObservableCollection<Microsoft.Maui.Controls.Element> - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Boolean - - - Marks the Page as busy. This will cause the platform specific global activity indicator to show a busy state. - A bool indicating if the Page is busy or not. - Setting IsBusy to true on multiple pages at once will cause the global activity indicator to run until both are set back to false. It is the authors job to unset the IsBusy flag before cleaning up a Page. - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - Identifies the property. - - - - - - - - Event - - E:Microsoft.Maui.Controls.ILayout.LayoutChanged - - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.EventHandler - - - Raised when the layout of the has changed. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - - - Left-hand side of layout area. - Top of layout area. - Width of layout area. - Height of layout area. - Lays out children s into the specified area. - - - - - - - - Method - - M:Microsoft.Maui.Controls.IElementConfiguration`1.On``1 - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.IPlatformElementConfiguration<T,Microsoft.Maui.Controls.Page> - - - - - Microsoft.Maui.Controls.IConfigPlatform - - - - - - To be added. - Returns the platform-specific instance of this , on which a platform-specific method may be called. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - When overridden, allows application developers to customize behavior immediately prior to the becoming visible. - - - - - - - - Method - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Boolean - - - - Application developers can override this method to provide behavior when the back button is pressed. - Whether or not the back navigation was handled by the override. - - If you want to handle or cancel the navigation yourself, you can do so in this method and then return true. - Note that this only works on Android and UWP for the hardware back-button. On iOS, this method will never be called because there is no hardware back-button. - - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - Invoked whenever the binding context of the changes. Override this method to add class handling for this event. - - - Overriders must call the base method. - - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - The object that raised the event. - The event arguments. - Indicates that the preferred size of a child has changed. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - When overridden, allows the application developer to customize behavior as the disappears. - is called when the page disappears due to navigating away from the page within the app. It is not called when the app disappears due to an event external to the app (e.g. user navigates to the home screen or another app, a phone call is received, the device is locked, the device is turned off). - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - Called when the 's property has changed. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - The width allocated to the . - The height allocated to the . - Indicates that the has been assigned a size. - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Thickness - - - The space between the content of the and it's border. - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - Identifies the property. - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.String - - - - - - - - - - Method - - M:Microsoft.Maui.Controls.IPageController.SendAppearing - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Void - - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Method - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Boolean - - - - Calls . - - - - - - - - Method - - M:Microsoft.Maui.Controls.IPageController.SendDisappearing - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - System.Void - - - - For internal use by the Microsoft.Maui.Controls platform. - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.String - - - The 's title. - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - Identifies the property. - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Collections.Generic.IList<Microsoft.Maui.Controls.ToolbarItem> - - - A set of s, implemented in a platform-specific manner. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - Requests that the children s of the update their layouts. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/StackLayout.xml b/src/Controls/docs/Microsoft.Maui.Controls/StackLayout.xml deleted file mode 100644 index 191f63ceb8f6..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/StackLayout.xml +++ /dev/null @@ -1,288 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.3.3.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - - - Microsoft.Maui.Controls.Layout<Microsoft.Maui.Controls.View> - - Microsoft.Maui.Controls.View - - - - - Microsoft.Maui.Controls.IElementConfiguration<Microsoft.Maui.Controls.StackLayout> - - - - A that positions child elements in a single line which can be oriented vertically or horizontally. - - - - - - - - - - Constructor - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.3.3.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - Initializes a new instance of the StackLayout class. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.3.3.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - - - A value representing the x coordinate of the child region bounding box. - A value representing the y coordinate of the child region bounding box. - A value representing the width of the child region bounding box. - A value representing the height of the child region bounding box. - Positions and sizes the children of a StackLayout. - Implementors wishing to change the default behavior of a StackLayout should override this method. It is suggested to still call the base method and modify its calculated results. - - - - - - - - Method - - M:Microsoft.Maui.Controls.IElementConfiguration`1.On``1 - - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.IPlatformElementConfiguration<T,Microsoft.Maui.Controls.StackLayout> - - - - - Microsoft.Maui.Controls.IConfigPlatform - - - - - - The platform configuration that selects the platform specific to use. - Returns the configuration object that the developer can use to call platform-specific methods for the layout. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.3.3.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - System.Obsolete("OnSizeRequest is obsolete as of version 2.2.0. Please use OnMeasure instead.") - - - - Microsoft.Maui.SizeRequest - - - - - - - The available width for the StackLayout to use. - The available height for the StackLayout to use. - This method is called during the measure pass of a layout cycle to get the desired size of the StackLayout. - A which contains the desired size of the StackLayout. - The results of this method will be a sum of all the desired sizes of its children along the orientation axis, and the maximum along the non-orientation axis. - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.3.3.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.StackOrientation - - - Gets or sets the value which indicates the direction which child elements are positioned. - A which indicates the direction children layouts flow. The default value is Vertical. - Setting the Orientation of a StackLayout triggers a layout cycle if the stack is already inside of a parent layout. To prevent wasted layout cycles, set the orientation prior to adding the StackLayout to a parent. - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.3.3.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - Identifies the Orientation bindable property. - - - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.3.3.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Double - - - Gets or sets a value which indicates the amount of space between each child element. - A value in device pixels which indicates the amount of space between each element. The default value is 6.0. - - - Setting this value triggers a layout cycle if the StackLayout is already in a parent Layout. - - - The following example sets the Spacing on construction of a StackLayout. - - - - - - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.3.3.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - Identifies the Spacing bindable property. - - - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/TextAlignmentConverter.xml b/src/Controls/docs/Microsoft.Maui.Controls/TextAlignmentConverter.xml deleted file mode 100644 index 913dc5f084f5..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/TextAlignmentConverter.xml +++ /dev/null @@ -1,66 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - System.ComponentModel.TypeConverter - - - - - Microsoft.Maui.Controls.Xaml.TypeConversion(typeof(Microsoft.Maui.TextAlignment)) - - - - Converts a string representation of a text alignment to a . - - This converter recognizes and converts string representations of the enumeration, as well as the following strings, regardless of case: "left", "right", and "center". - - - - - - - - Constructor - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - - Creates a new default converter. - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - System.Object - - - - - - The value to convert. - Returns the object for the string representation. - The object for the string representation. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/TypeConverterAttribute.xml b/src/Controls/docs/Microsoft.Maui.Controls/TypeConverterAttribute.xml deleted file mode 100644 index 0e2709e75863..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/TypeConverterAttribute.xml +++ /dev/null @@ -1,203 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - - - System.Attribute - - - - - System.AttributeUsage(System.AttributeTargets.All) - - - - Attribute that specifies the type of used by its target. - - - - - - - Constructor - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - Creates a new with default values. - - - - - - - - Constructor - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - - - The name of the type that this attribute can decorate. - Creates a new object that specifies that the class it decorates converts values to the type. - - - - - - - - Constructor - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - - - The type that this attribute can decorate. - reates a new object that specifies that the class it decorates converts values to . - - - - - - - - Property - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.String - - - The name of the type to which the class decorated with this attribute can convert values. - - - - - - - - Field - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.ComponentModel.TypeConverterAttribute - - - A that contains no information about the types to which the class that it decorates can convert values. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Boolean - - - - - - The object against which to do the comparison. - Returns true if is a and has the same value. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Int32 - - - - Returns a value that is used for efficient storage and lookup of this object. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/ViewExtensions.xml b/src/Controls/docs/Microsoft.Maui.Controls/ViewExtensions.xml deleted file mode 100644 index 17e604dc709f..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/ViewExtensions.xml +++ /dev/null @@ -1,417 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - - - System.Object - - - - Extension methods for s, providing animatable scaling, rotation, and layout functions. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - The view on which this method operates. - Aborts the TranslateTo, LayoutTo, RotateTo, ScaleTo, and FadeTo animations on element. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Threading.Tasks.Task<System.Boolean> - - - - - - - - - The view on which this method operates. - The opacity to fade to. - The time, in milliseconds, over which to animate the transition. The default is 250. - The easing function to use for the animation. - Returns a task that performs the fade that is described by the , , and parameters. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Threading.Tasks.Task<System.Boolean> - - - - - - - - - The view on which this method operates. - The layout bounds. - The time, in milliseconds, over which to animate the transition. The default is 250. - The easing function to use for the animation. - Returns a task that eases the bounds of the that is specified by the to the rectangle that is specified by the parameter. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Threading.Tasks.Task<System.Boolean> - - - - - - - - - The view on which this method operates. - The relative rotation. - The time, in milliseconds, over which to animate the transition. The default is 250. - The easing function to use for the animation. - Rotates the that is specified by from its current rotation by . - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Threading.Tasks.Task<System.Boolean> - - - - - - - - - The view on which this method operates. - The relative scale. - The time, in milliseconds, over which to animate the transition. The default is 250. - The easing function to use for the animation. - Returns a task that scales the that is specified by from its current scale to . - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Threading.Tasks.Task<System.Boolean> - - - - - - - - - The view on which this method operates. - The final rotation value. - The time, in milliseconds, over which to animate the transition. The default is 250. - The easing function to use for the animation. - Returns a task that performs the rotation that is described by the , , and parameters. - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Threading.Tasks.Task<System.Boolean> - - - - - - - - - The view on which this method operates. - The final rotation value. - The time, in milliseconds, over which to animate the transition. The default is 250. - The easing function to use for the animation. - Returns a task that skews the X axis by , taking time and using . - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Threading.Tasks.Task<System.Boolean> - - - - - - - - - The view on which this method operates. - The final rotation value. - The time, in milliseconds, over which to animate the transition. The default is 250. - The easing function to use for the animation. - Returns a task that skews the Y axis by , taking time and using . - - - - - - - - Method - - 0.0.0.0 - 1.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Threading.Tasks.Task<System.Boolean> - - - - - - - - - The view on which this method operates. - The final absolute scale. - The time, in milliseconds, over which to animate the transition. The default is 250. - The easing function to use for the animation. - Returns a task that scales the that is specified by to the absolute scale factor . - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Threading.Tasks.Task<System.Boolean> - - - - - - - - - To be added. - To be added. - To be added. - To be added. - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Threading.Tasks.Task<System.Boolean> - - - - - - - - - To be added. - To be added. - To be added. - To be added. - - - - - - - - Method - - 0.0.0.0 - 1.1.0.0 - 1.2.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Threading.Tasks.Task<System.Boolean> - - - - - - - - - - The view to translate. - The x component of the final translation vector. - The y component of the final translation vector. - The duration of the animation in milliseconds. - The easing of the animation. - Animates an elements TranslationX and TranslationY properties from their current values to the new values. This ensures that the input layout is in the same position as the visual layout. - - To animate a view that receives user touch input from outside of the screen, the developer must first lay out the view in its final position, then translate the view off screen, and then finally animate the view back to its final position on the screen. - TranslateTo is useful for animations because it is applied post-layout. Translation animations will not conflict with managed layouts and thus are ideal for doing slide in/out style animations. - - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/WebNavigationEvent.xml b/src/Controls/docs/Microsoft.Maui.Controls/WebNavigationEvent.xml deleted file mode 100644 index bf9b140bf7f7..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/WebNavigationEvent.xml +++ /dev/null @@ -1,110 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - - - System.Enum - - - Contains values that indicate why a navigation event was raised. - - - - - - - - Field - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.WebNavigationEvent - - 1 - - Indicates that the navigation resulted from the user going back to a previous page in the navigation history. - - - - - - - - Field - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.WebNavigationEvent - - 2 - - Indicates that the navigation resulted from the user going forward to a later page in the navigation history. - - - - - - - - Field - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.WebNavigationEvent - - 3 - - Indicates that the navigation was to a preiously unvisited page, according to the navigation history. - - - - - - - - Field - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.WebNavigationEvent - - 4 - - Indicates that the navigation resulted from a page refresh. - - - - diff --git a/src/Controls/docs/Microsoft.Maui.Controls/WebNavigationResult.xml b/src/Controls/docs/Microsoft.Maui.Controls/WebNavigationResult.xml deleted file mode 100644 index 167550324b5a..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls/WebNavigationResult.xml +++ /dev/null @@ -1,110 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - - - System.Enum - - - Enumerates values that indicate the outcome of a web navigation. - - - - - - - - Field - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.WebNavigationResult - - 2 - - The navigation was cancelled. - - - - - - - - Field - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.WebNavigationResult - - 4 - - The navigation failed. - - - - - - - - Field - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.WebNavigationResult - - 1 - - The navigation succeeded. - - - - - - - - Field - - 0.0.0.0 - 1.3.0.0 - 1.4.0.0 - 1.5.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.WebNavigationResult - - 3 - - The navigation timed out. - - - - diff --git a/src/Controls/src/Core/ContentPresenter.cs b/src/Controls/src/Core/ContentPresenter.cs index 0580ef313b2c..871aa3f27cc7 100644 --- a/src/Controls/src/Core/ContentPresenter.cs +++ b/src/Controls/src/Core/ContentPresenter.cs @@ -108,6 +108,10 @@ static async void OnContentChanged(BindableObject bindable, object oldValue, obj } } + + // Don't delete this override. At some point in the future we'd like to delete Compatibility.Layout + // and this is the only way to ensure binary compatibility with code that's already compiled against MAUI + // and is overriding MeasureOverride. protected override Size MeasureOverride(double widthConstraint, double heightConstraint) { return this.ComputeDesiredSize(widthConstraint, heightConstraint); @@ -118,6 +122,17 @@ Size ICrossPlatformLayout.CrossPlatformMeasure(double widthConstraint, double he return this.MeasureContent(widthConstraint, heightConstraint); } + // Don't delete this override. At some point in the future we'd like to delete Compatibility.Layout + // and this is the only way to ensure binary compatibility with code that's already compiled against MAUI + // and is overriding OnSizeAllocated. + protected override void OnSizeAllocated(double width, double height) + { + base.OnSizeAllocated(width, height); + } + + // Don't delete this override. At some point in the future we'd like to delete Compatibility.Layout + // and this is the only way to ensure binary compatibility with code that's already compiled against MAUI + // and is overriding ArrangeOverride. protected override Size ArrangeOverride(Rect bounds) { Frame = this.ComputeFrame(bounds); diff --git a/src/Controls/src/Core/ScrollView/ScrollView.cs b/src/Controls/src/Core/ScrollView/ScrollView.cs index 9e74f9d5da2c..838b04ab8d72 100644 --- a/src/Controls/src/Core/ScrollView/ScrollView.cs +++ b/src/Controls/src/Core/ScrollView/ScrollView.cs @@ -427,6 +427,10 @@ void IScrollView.RequestScrollTo(double horizontalOffset, double verticalOffset, void IScrollView.ScrollFinished() => SendScrollFinished(); + + // Don't delete this override. At some point in the future we'd like to delete Compatibility.Layout + // and this is the only way to ensure binary compatibility with code that's already compiled against MAUI + // and is overriding MeasureOverride. protected override Size MeasureOverride(double widthConstraint, double heightConstraint) { return this.ComputeDesiredSize(widthConstraint, heightConstraint); @@ -460,6 +464,10 @@ Size ICrossPlatformLayout.CrossPlatformMeasure(double widthConstraint, double he return content.DesiredSize; } + + // Don't delete this override. At some point in the future we'd like to delete Compatibility.Layout + // and this is the only way to ensure binary compatibility with code that's already compiled against MAUI + // and is overriding ArrangeOverride. protected override Size ArrangeOverride(Rect bounds) { Frame = this.ComputeFrame(bounds); @@ -468,6 +476,14 @@ protected override Size ArrangeOverride(Rect bounds) return Frame.Size; } + // Don't delete this override. At some point in the future we'd like to delete Compatibility.Layout + // and this is the only way to ensure binary compatibility with code that's already compiled against MAUI + // and is overriding OnSizeAllocated. + protected override void OnSizeAllocated(double width, double height) + { + base.OnSizeAllocated(width, height); + } + Size ICrossPlatformLayout.CrossPlatformArrange(Rect bounds) { if (this is IScrollView scrollView) diff --git a/src/Controls/src/Core/TemplatedView/TemplatedView.cs b/src/Controls/src/Core/TemplatedView/TemplatedView.cs index 0d8785252539..409fcc49c7da 100644 --- a/src/Controls/src/Core/TemplatedView/TemplatedView.cs +++ b/src/Controls/src/Core/TemplatedView/TemplatedView.cs @@ -127,6 +127,9 @@ partial void OnApplyTemplateImpl() Handler?.UpdateValue(nameof(IContentView.Content)); } + // Don't delete this override. At some point in the future we'd like to delete Compatibility.Layout + // and this is the only way to ensure binary compatibility with code that's already compiled against MAUI + // and is overriding MeasureOverride. protected override Size MeasureOverride(double widthConstraint, double heightConstraint) { return this.ComputeDesiredSize(widthConstraint, heightConstraint); @@ -137,6 +140,18 @@ Size ICrossPlatformLayout.CrossPlatformMeasure(double widthConstraint, double he return this.MeasureContent(widthConstraint, heightConstraint); } + // Don't delete this override. At some point in the future we'd like to delete Compatibility.Layout + // and this is the only way to ensure binary compatibility with code that's already compiled against MAUI + // and is overriding OnSizeAllocated. + protected override void OnSizeAllocated(double width, double height) + { + base.OnSizeAllocated(width, height); + } + + + // Don't delete this override. At some point in the future we'd like to delete Compatibility.Layout + // and this is the only way to ensure binary compatibility with code that's already compiled against MAUI + // and is overriding ArrangeOverride. protected override Size ArrangeOverride(Rect bounds) { Frame = this.ComputeFrame(bounds); diff --git a/src/Controls/tests/BindingSourceGen.UnitTests/Controls.BindingSourceGen.UnitTests.csproj b/src/Controls/tests/BindingSourceGen.UnitTests/Controls.BindingSourceGen.UnitTests.csproj index 6026db28d864..3d3d209fab7d 100644 --- a/src/Controls/tests/BindingSourceGen.UnitTests/Controls.BindingSourceGen.UnitTests.csproj +++ b/src/Controls/tests/BindingSourceGen.UnitTests/Controls.BindingSourceGen.UnitTests.csproj @@ -10,8 +10,8 @@ - - + + diff --git a/src/Controls/tests/Core.UnitTests/BindingUnitTests.cs b/src/Controls/tests/Core.UnitTests/BindingUnitTests.cs index f505eec996df..c4c99729c106 100644 --- a/src/Controls/tests/Core.UnitTests/BindingUnitTests.cs +++ b/src/Controls/tests/Core.UnitTests/BindingUnitTests.cs @@ -2220,7 +2220,7 @@ WeakReference CreateReference() await TestHelpers.Collect(); - Assert.False(bindingRef.IsAlive, "Binding should not be alive!"); + Assert.False(await bindingRef.WaitForCollect(), "Binding should not be alive!"); GC.KeepAlive(viewModel); } diff --git a/src/Controls/tests/Core.UnitTests/Layouts/GridLayoutTests.cs b/src/Controls/tests/Core.UnitTests/Layouts/GridLayoutTests.cs index b91f7444a1ee..11e2a5284203 100644 --- a/src/Controls/tests/Core.UnitTests/Layouts/GridLayoutTests.cs +++ b/src/Controls/tests/Core.UnitTests/Layouts/GridLayoutTests.cs @@ -204,7 +204,7 @@ WeakReference CreateReference() await TestHelpers.Collect(); - Assert.False(reference.IsAlive, "Grid should not be alive!"); + Assert.False(await reference.WaitForCollect(), "Grid should not be alive!"); // Ensure that the ColumnDefinition isn't collected during the test GC.KeepAlive(columnDefinition); @@ -223,11 +223,9 @@ public async Task RowDefinitionDoesNotLeak() reference = new(grid); } - await Task.Yield(); - GC.Collect(); - GC.WaitForPendingFinalizers(); + await TestHelpers.Collect(); - Assert.False(reference.IsAlive, "Grid should not be alive!"); + Assert.False(await reference.WaitForCollect(), "Grid should not be alive!"); } } } diff --git a/src/Controls/tests/Core.UnitTests/TestHelpers.cs b/src/Controls/tests/Core.UnitTests/TestHelpers.cs index aa8a2b1efa53..43c9d7f7e3a2 100644 --- a/src/Controls/tests/Core.UnitTests/TestHelpers.cs +++ b/src/Controls/tests/Core.UnitTests/TestHelpers.cs @@ -26,5 +26,15 @@ public static async Task WaitForCollect(this WeakReference reference) return reference.IsAlive; } + + public static async Task WaitForCollect(this WeakReference reference) + { + for (int i = 0; i < 40 && reference.TryGetTarget(out _); i++) + { + await Collect(); + } + + return reference.TryGetTarget(out _); + } } } \ No newline at end of file diff --git a/src/Controls/tests/TestCases.Android.Tests/snapshots/android/PickerShouldShowSelectedItemHighlight.png b/src/Controls/tests/TestCases.Android.Tests/snapshots/android/PickerShouldShowSelectedItemHighlight.png new file mode 100644 index 000000000000..a1725e443a8e Binary files /dev/null and b/src/Controls/tests/TestCases.Android.Tests/snapshots/android/PickerShouldShowSelectedItemHighlight.png differ diff --git a/src/Controls/tests/TestCases.HostApp/Issues/Issue29633.cs b/src/Controls/tests/TestCases.HostApp/Issues/Issue29633.cs new file mode 100644 index 000000000000..d8b4922840f8 --- /dev/null +++ b/src/Controls/tests/TestCases.HostApp/Issues/Issue29633.cs @@ -0,0 +1,29 @@ +namespace Maui.Controls.Sample.Issues; + +[Issue(IssueTracker.Github, 29633, "[Android] Picker Does Not Show Selected Item Highlight", PlatformAffected.Android)] +public class Issue29633 : ContentPage +{ + public Issue29633() + { + var items = new List + { + "Apple", "Banana", "Cherry", "Date", "Elderberry", + "Fig", "Grape", "Honeydew", "Kiwi", "Lemon" + }; + + var picker = new Picker() + { + AutomationId = "HighlightPickerItem", + ItemsSource = items, + SelectedItem = items[6] + }; + + Content = new StackLayout + { + Children = + { + picker + } + }; + } +} \ No newline at end of file diff --git a/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/CollectionViewUITests.CollectionViewItemsUpdatingScrollMode.cs b/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/CollectionViewUITests.CollectionViewItemsUpdatingScrollMode.cs index 09a8d93c8444..7c6ea34eb29a 100644 --- a/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/CollectionViewUITests.CollectionViewItemsUpdatingScrollMode.cs +++ b/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/CollectionViewUITests.CollectionViewItemsUpdatingScrollMode.cs @@ -43,7 +43,7 @@ public void KeepScrollOffset() App.WaitForElement("SelectScrollMode"); App.Click("SelectScrollMode"); App.Click("KeepScrollOffset"); - + App.Click("Cancel"); App.WaitForElement("ScrollToMiddle"); App.Click("ScrollToMiddle"); App.WaitForElement("Vegetables.jpg, 10"); @@ -59,7 +59,7 @@ public void KeepLastItemInView() App.WaitForElement("SelectScrollMode"); App.Click("SelectScrollMode"); App.Click("KeepLastItemInView"); - + App.Click("Cancel"); App.WaitForElement("ScrollToMiddle"); App.Click("ScrollToMiddle"); App.WaitForElement("Vegetables.jpg, 10"); diff --git a/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue16767_Downsize.cs b/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue16767_Downsize.cs index abf900107816..4328ab358ea4 100644 --- a/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue16767_Downsize.cs +++ b/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue16767_Downsize.cs @@ -4,7 +4,6 @@ using UITest.Core; namespace Microsoft.Maui.TestCases.Tests.Issues; - public class Issue16767_Downsize : _IssuesUITest { public Issue16767_Downsize(TestDevice testDevice) : base(testDevice) diff --git a/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue16767_Resize.cs b/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue16767_Resize.cs index 659a4e66eacb..e6b83b25f0e6 100644 --- a/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue16767_Resize.cs +++ b/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue16767_Resize.cs @@ -4,7 +4,6 @@ using UITest.Core; namespace Microsoft.Maui.TestCases.Tests.Issues; - public class Issue16767_Resize : _IssuesUITest { public Issue16767_Resize(TestDevice testDevice) : base(testDevice) diff --git a/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue29633.cs b/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue29633.cs new file mode 100644 index 000000000000..6d3aa0b7ad0b --- /dev/null +++ b/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue29633.cs @@ -0,0 +1,25 @@ +#if TEST_FAILS_ON_CATALYST // Highlighting Not Working Properly on Mac Catalyst, https://github.com/dotnet/maui/issues/27519 +using NUnit.Framework; +using UITest.Appium; +using UITest.Core; + +namespace Microsoft.Maui.TestCases.Tests.Issues; + +public class Issue29633 : _IssuesUITest +{ + public Issue29633(TestDevice testDevice) : base(testDevice) + { + } + + public override string Issue => "[Android] Picker Does Not Show Selected Item Highlight"; + + [Test] + [Category(UITestCategories.Picker)] + public void PickerShouldShowSelectedItemHighlight() + { + App.WaitForElement("HighlightPickerItem"); + App.Click("HighlightPickerItem"); + VerifyScreenshot(); + } +} +#endif \ No newline at end of file diff --git a/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue8870.cs b/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue8870.cs index e5a34d1fddd7..425116db76f4 100644 --- a/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue8870.cs +++ b/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue8870.cs @@ -3,49 +3,45 @@ using UITest.Appium; using UITest.Core; -namespace Microsoft.Maui.TestCases.Tests.Issues -{ - public class Issue8870 : _IssuesUITest - { - const string Success = "Success"; - const string CheckResult = "Check"; +namespace Microsoft.Maui.TestCases.Tests.Issues; - public Issue8870(TestDevice testDevice) : base(testDevice) - { - } +public class Issue8870 : _IssuesUITest +{ + const string Success = "Success"; + const string CheckResult = "Check"; - public override string Issue => "[Bug] CollectionView with HTML Labels Freeze the Screen on Rotation"; + public Issue8870(TestDevice testDevice) : base(testDevice) + { + } - [Test] - [Category(UITestCategories.CollectionView)] - [FailsOnMacWhenRunningOnXamarinUITest("SetOrientationPortrait method not implemented")] - [FailsOnWindowsWhenRunningOnXamarinUITest("SetOrientationPortrait method not implemented")] - public void RotatingCollectionViewWithHTMLShouldNotHangOrCrash() - { - int delay = 1000; + public override string Issue => "[Bug] CollectionView with HTML Labels Freeze the Screen on Rotation"; - App.WaitForElement(CheckResult); + [Test] + [Category(UITestCategories.CollectionView)] + [FailsOnMacWhenRunningOnXamarinUITest("SetOrientationPortrait method not implemented")] + [FailsOnWindowsWhenRunningOnXamarinUITest("SetOrientationPortrait method not implemented")] + public void RotatingCollectionViewWithHTMLShouldNotHangOrCrash() + { + App.WaitForElement(CheckResult); - App.SetOrientationPortrait(); - Thread.Sleep(delay); + App.SetOrientationPortrait(); + App.WaitForElement(CheckResult); - App.SetOrientationLandscape(); - Thread.Sleep(delay); + App.SetOrientationLandscape(); + App.WaitForElement(CheckResult); - App.SetOrientationPortrait(); - Thread.Sleep(delay); + App.SetOrientationPortrait(); + App.WaitForElement(CheckResult); - App.SetOrientationLandscape(); - Thread.Sleep(delay); + App.SetOrientationLandscape(); + App.WaitForElement(CheckResult); - App.SetOrientationPortrait(); - Thread.Sleep(delay); + App.SetOrientationPortrait(); + App.WaitForElement(CheckResult); - App.WaitForElement(CheckResult); - App.Tap(CheckResult); + App.TapWithRetriesUntilElementReady(CheckResult, Success, maxRetries: 10); - App.WaitForElement(Success); - } + App.WaitForElement(Success); } } #endif \ No newline at end of file diff --git a/src/Controls/tests/TestCases.WinUI.Tests/snapshots/windows/PickerShouldShowSelectedItemHighlight.png b/src/Controls/tests/TestCases.WinUI.Tests/snapshots/windows/PickerShouldShowSelectedItemHighlight.png new file mode 100644 index 000000000000..f90da8133c80 Binary files /dev/null and b/src/Controls/tests/TestCases.WinUI.Tests/snapshots/windows/PickerShouldShowSelectedItemHighlight.png differ diff --git a/src/Controls/tests/TestCases.iOS.Tests/snapshots/ios/PickerShouldShowSelectedItemHighlight.png b/src/Controls/tests/TestCases.iOS.Tests/snapshots/ios/PickerShouldShowSelectedItemHighlight.png new file mode 100644 index 000000000000..a39f8eec451f Binary files /dev/null and b/src/Controls/tests/TestCases.iOS.Tests/snapshots/ios/PickerShouldShowSelectedItemHighlight.png differ diff --git a/src/Core/maps/src/PublicAPI/net-android/PublicAPI.Unshipped.txt b/src/Core/maps/src/PublicAPI/net-android/PublicAPI.Unshipped.txt index 7dc5c58110bf..9f1d390876c7 100644 --- a/src/Core/maps/src/PublicAPI/net-android/PublicAPI.Unshipped.txt +++ b/src/Core/maps/src/PublicAPI/net-android/PublicAPI.Unshipped.txt @@ -1 +1,12 @@ #nullable enable +Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Deconstruct(out int Index, out Microsoft.Maui.Maps.IMapElement! MapElement) -> void +Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.MapElementHandlerUpdate(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate! original) -> void +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Equals(object? obj) -> bool +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.GetHashCode() -> int +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.ToString() -> string! +static Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.operator !=(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? left, Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? right) -> bool +static Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.operator ==(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? left, Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? right) -> bool +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.$() -> Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate! +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Equals(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? other) -> bool +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.EqualityContract.get -> System.Type! +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.PrintMembers(System.Text.StringBuilder! builder) -> bool diff --git a/src/Core/maps/src/PublicAPI/net-ios/PublicAPI.Unshipped.txt b/src/Core/maps/src/PublicAPI/net-ios/PublicAPI.Unshipped.txt index 7dc5c58110bf..9f1d390876c7 100644 --- a/src/Core/maps/src/PublicAPI/net-ios/PublicAPI.Unshipped.txt +++ b/src/Core/maps/src/PublicAPI/net-ios/PublicAPI.Unshipped.txt @@ -1 +1,12 @@ #nullable enable +Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Deconstruct(out int Index, out Microsoft.Maui.Maps.IMapElement! MapElement) -> void +Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.MapElementHandlerUpdate(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate! original) -> void +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Equals(object? obj) -> bool +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.GetHashCode() -> int +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.ToString() -> string! +static Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.operator !=(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? left, Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? right) -> bool +static Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.operator ==(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? left, Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? right) -> bool +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.$() -> Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate! +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Equals(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? other) -> bool +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.EqualityContract.get -> System.Type! +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.PrintMembers(System.Text.StringBuilder! builder) -> bool diff --git a/src/Core/maps/src/PublicAPI/net-maccatalyst/PublicAPI.Unshipped.txt b/src/Core/maps/src/PublicAPI/net-maccatalyst/PublicAPI.Unshipped.txt index 7dc5c58110bf..9f1d390876c7 100644 --- a/src/Core/maps/src/PublicAPI/net-maccatalyst/PublicAPI.Unshipped.txt +++ b/src/Core/maps/src/PublicAPI/net-maccatalyst/PublicAPI.Unshipped.txt @@ -1 +1,12 @@ #nullable enable +Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Deconstruct(out int Index, out Microsoft.Maui.Maps.IMapElement! MapElement) -> void +Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.MapElementHandlerUpdate(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate! original) -> void +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Equals(object? obj) -> bool +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.GetHashCode() -> int +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.ToString() -> string! +static Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.operator !=(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? left, Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? right) -> bool +static Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.operator ==(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? left, Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? right) -> bool +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.$() -> Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate! +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Equals(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? other) -> bool +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.EqualityContract.get -> System.Type! +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.PrintMembers(System.Text.StringBuilder! builder) -> bool diff --git a/src/Core/maps/src/PublicAPI/net-tizen/PublicAPI.Unshipped.txt b/src/Core/maps/src/PublicAPI/net-tizen/PublicAPI.Unshipped.txt index 7dc5c58110bf..9f1d390876c7 100644 --- a/src/Core/maps/src/PublicAPI/net-tizen/PublicAPI.Unshipped.txt +++ b/src/Core/maps/src/PublicAPI/net-tizen/PublicAPI.Unshipped.txt @@ -1 +1,12 @@ #nullable enable +Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Deconstruct(out int Index, out Microsoft.Maui.Maps.IMapElement! MapElement) -> void +Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.MapElementHandlerUpdate(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate! original) -> void +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Equals(object? obj) -> bool +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.GetHashCode() -> int +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.ToString() -> string! +static Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.operator !=(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? left, Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? right) -> bool +static Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.operator ==(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? left, Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? right) -> bool +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.$() -> Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate! +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Equals(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? other) -> bool +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.EqualityContract.get -> System.Type! +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.PrintMembers(System.Text.StringBuilder! builder) -> bool diff --git a/src/Core/maps/src/PublicAPI/net-windows/PublicAPI.Unshipped.txt b/src/Core/maps/src/PublicAPI/net-windows/PublicAPI.Unshipped.txt index 7dc5c58110bf..9f1d390876c7 100644 --- a/src/Core/maps/src/PublicAPI/net-windows/PublicAPI.Unshipped.txt +++ b/src/Core/maps/src/PublicAPI/net-windows/PublicAPI.Unshipped.txt @@ -1 +1,12 @@ #nullable enable +Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Deconstruct(out int Index, out Microsoft.Maui.Maps.IMapElement! MapElement) -> void +Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.MapElementHandlerUpdate(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate! original) -> void +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Equals(object? obj) -> bool +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.GetHashCode() -> int +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.ToString() -> string! +static Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.operator !=(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? left, Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? right) -> bool +static Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.operator ==(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? left, Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? right) -> bool +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.$() -> Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate! +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Equals(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? other) -> bool +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.EqualityContract.get -> System.Type! +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.PrintMembers(System.Text.StringBuilder! builder) -> bool diff --git a/src/Core/maps/src/PublicAPI/net/PublicAPI.Unshipped.txt b/src/Core/maps/src/PublicAPI/net/PublicAPI.Unshipped.txt index 7dc5c58110bf..9f1d390876c7 100644 --- a/src/Core/maps/src/PublicAPI/net/PublicAPI.Unshipped.txt +++ b/src/Core/maps/src/PublicAPI/net/PublicAPI.Unshipped.txt @@ -1 +1,12 @@ #nullable enable +Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Deconstruct(out int Index, out Microsoft.Maui.Maps.IMapElement! MapElement) -> void +Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.MapElementHandlerUpdate(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate! original) -> void +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Equals(object? obj) -> bool +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.GetHashCode() -> int +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.ToString() -> string! +static Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.operator !=(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? left, Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? right) -> bool +static Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.operator ==(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? left, Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? right) -> bool +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.$() -> Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate! +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Equals(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? other) -> bool +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.EqualityContract.get -> System.Type! +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.PrintMembers(System.Text.StringBuilder! builder) -> bool diff --git a/src/Core/maps/src/PublicAPI/netstandard/PublicAPI.Unshipped.txt b/src/Core/maps/src/PublicAPI/netstandard/PublicAPI.Unshipped.txt index 7dc5c58110bf..9f1d390876c7 100644 --- a/src/Core/maps/src/PublicAPI/netstandard/PublicAPI.Unshipped.txt +++ b/src/Core/maps/src/PublicAPI/netstandard/PublicAPI.Unshipped.txt @@ -1 +1,12 @@ #nullable enable +Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Deconstruct(out int Index, out Microsoft.Maui.Maps.IMapElement! MapElement) -> void +Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.MapElementHandlerUpdate(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate! original) -> void +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Equals(object? obj) -> bool +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.GetHashCode() -> int +override Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.ToString() -> string! +static Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.operator !=(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? left, Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? right) -> bool +static Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.operator ==(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? left, Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? right) -> bool +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.$() -> Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate! +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.Equals(Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate? other) -> bool +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.EqualityContract.get -> System.Type! +virtual Microsoft.Maui.Maps.Handlers.MapElementHandlerUpdate.PrintMembers(System.Text.StringBuilder! builder) -> bool diff --git a/src/Core/src/Handlers/Picker/PickerHandler.Android.cs b/src/Core/src/Handlers/Picker/PickerHandler.Android.cs index 76325f274690..850a126fa836 100644 --- a/src/Core/src/Handlers/Picker/PickerHandler.Android.cs +++ b/src/Core/src/Handlers/Picker/PickerHandler.Android.cs @@ -5,6 +5,7 @@ using Android.Graphics.Drawables; using Android.Text; using Android.Text.Style; +using Google.Android.Material.Dialog; using AppCompatAlertDialog = AndroidX.AppCompat.App.AlertDialog; using AResource = Android.Resource; @@ -109,7 +110,7 @@ void OnClick(object? sender, EventArgs e) { if (_dialog == null && VirtualView != null) { - using (var builder = new AppCompatAlertDialog.Builder(Context)) + using (var builder = new MaterialAlertDialogBuilder(Context)) { if (VirtualView.TitleColor == null) { @@ -133,7 +134,7 @@ void OnClick(object? sender, EventArgs e) items[i] = String.Empty; } - builder.SetItems(items, (s, e) => + builder.SetSingleChoiceItems(items, VirtualView.SelectedIndex, (s, e) => { var selectedIndex = e.Which; VirtualView.SelectedIndex = selectedIndex; diff --git a/src/Core/src/Platform/Android/Resources/values/styles.xml b/src/Core/src/Platform/Android/Resources/values/styles.xml index d1f2b573fff3..13c3f7277fe7 100644 --- a/src/Core/src/Platform/Android/Resources/values/styles.xml +++ b/src/Core/src/Platform/Android/Resources/values/styles.xml @@ -16,6 +16,7 @@ @style/MauiCheckBox false @style/MauiAlertDialogTheme + @style/MauiAlertDialogTheme