MacViews/a11y: Allow accessibility clients to update the selected text.

ui/accessibility/platform/ax_platform_node_delegate.h

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef UI_ACCESSIBILITY_PLATFORM_AX_PLATFORM_NODE_DELEGATE_H_
 #define UI_ACCESSIBILITY_PLATFORM_AX_PLATFORM_NODE_DELEGATE_H_
 
 #include "ui/accessibility/ax_enums.h"
 #include "ui/accessibility/ax_export.h"
 #include "ui/gfx/geometry/vector2d.h"
@@ skipping 67 matching lines @@
 
   //
   // Actions.
   //
 
   // Perform the default action, e.g. click a button, follow a link, or
   // toggle a checkbox.
   virtual void DoDefaultAction() = 0;
 
   // Change the value of a control, such as the text content of a text field.
-  virtual bool SetStringValue(const base::string16& new_value) = 0;
+  // Optionally replace it or insert at the cursor if |replace| is true.

[dmazzoni, 2016/10/25 17:21:49]

Same here, flip the boolean around and rename it so that it
inserts text by default, and clears the selection if the bool
is set.

Don't say "optionally" because it's a required parameter,
the caller needs to decide for sure whether to pass true or
false.

[Patti Lor, 2016/10/26 00:57:15]

Done.

+  virtual bool SetStringValue(const base::string16& new_value,
+                              bool replace) = 0;
 
-  // Whether the string value is settable.
+  // Whether SetStringValue() and ReplaceSelectedText() are callable, i.e. if
+  // the string value is read only and if the callback exists.
   virtual bool CanSetStringValue() = 0;
 };
 
 }  // namespace ui
 
 #endif  // UI_ACCESSIBILITY_PLATFORM_AX_PLATFORM_NODE_DELEGATE_H_