changes-propgrid.txt

非常好用的可移植的多平台C/C++源代码编辑器

Version 1.0.5 ( Jun-06-2005 )

  Minor Features:

  - Added wxPropertyGrid::ReplaceProperty(id/name,newproperty).

  - Added flags argument default value (0) for wxPGProperty's GetValueAsString,
    SetValueFromString, and SetValueFromInt methods.

  - wxWidgets 2.6.1 makefiles.


  Bugs Fixed:

  - WinXP/Win2K, wxWidgets 2.6.1: Indentation in wxTextCtrl based property
    editor was incorrect (due to change in default font face: previously
    "MS Shell Dlg", now "MS Shell Dlg 2").

  - wxGTK: Virtual size was sometimesskewed.

  - When a property with children was expanded or collapsed, and current
    selection was outside the visible area, then the grid was inadvertedly
    scrolled to the selection.



Version 1.0.4 ( May-21-2005 )

  Changes and Minor Features:

  - Colour scheme generator is now smarter and should be considerably
    better for various Windows themes. If you do not like how it looks,
    edit contrib/include/wx/propgrid/propgrid.h and change define
    wxPG_NEW_COLOUR_SCHEME to 0.

  - wxUIntProperty for representing unsigned integers. You can change
    base (default is decimal) and prefix by manipulating wxPG_UINT_BASE
    and wxPG_UINT_PREFIX attributes. See Attribute Identifiers module
    in the documentation for more info.

  - Added wxPropertyGridManager::ClearPage(page) to delete all
    properties on given page.


  Bug Fixes:

  - If value in textctrl editor was edited, and splitter was subsequently
    moved, then the corresponding wxPG_EVT_CHANGED was not sent.

  - Windows 2000: Pressing ALT + some key that isn't actually bound
    to a shortcut caused program to hang (thanks Bernard Duggan).

  - WX_PG_IMPLEMENT_CUSTOM_COLOUR_PROPERTY and
    WX_PG_IMPLEMENT_CUSTOM_COLOUR_PROPERTY_USES_WXCOLOUR did not compile
    (and neither did their declare counterparts).

  - wxFontProperty: setting invalid Family, Style, or Weight caused a crash
    (assertion failure in debug build).

  - Giving -1/wxID_ANY as id to wxPropertyGridManager resulted in an
    assertion failure.

  - Description box or status bar were not cleared consistently when
    Thaw() and Freeze() were used when deleting items.

  - wxPropertyGrid::SetPropertyValueUnspecified(name) had typo in its
    name (Value was missing).



Version 1.0.3 ( May-13-2005 )

  Bug Fixes:

  - Changes were not copied (and wxEVT_PG_CHANGED event was not sent)
    from wxTextCtrl based editor when focusing out of the property grid,
    or when the grid was being destroyed. This is now solved by committing
    changes and sending the event when focus or mouse moves leaves the
    property grid and when special key (alt,ctrl,meta - which are connected
    to closing the app via keyboard) is pressed while text is being edited.
    If this fails to work, *error message will be shown on grid deletion*.

  - Keyboard navigation code has been overhauled. Fixes include:
    * Keyboard navigation in wxPropertyGrid placed in wxDialog or wxPanel
      was seriously skewed.
    * Keyboard navigating upwards (and sometimes downwards as well)
      did not scroll to navigated property.
    * It was possible to navigate out with arrow keys.
    * Changing mode in wxPropertyGridManager stopped keyboard navigation
      from working.
    * Now, when there is no selection, first non-tab, non-esc key down event
      will select the topmost property.
    Known things that don't work yet:
    * wxGTK: Pressing ESC in property editor does not unfocus it correctly.

  - Right-clicking now selects the property underneath.

  - ClientData methods were not enabled by the default, and if they
    were manually enabled, there were compile errors
    (thanks Bernard Duggan).

  - wxPropertyGridManager::SetWindowStyleFlag was seriously flawed.

  - Few ignorable but rare assertion failures removed.

  - Sample app incorrectly placed multiple controls on plain wxFrame
    (which is apparently a no-no).

  - Another Borland C++ fix (hopefully its now fine, thanks Luigi Bianchi).

  - Flag indicating read-only editor was not inherited by fixed sub-properties.



Version 1.0.2 ( May-03-2005 )

  Changes:

  - wxParentProperty has been re-implemented (I thought wxCustomProperty
    could replace it but that turned out not to be practical). Added
    section on docs main page as well.

  - It is now possible to have nested properties that use the default
    SetValueFromString/GetValueAsString (which prints something like
    "child value 1; child value2; ...etc..."). Children with sub-items
    of their own are separated by brackets. For example:
      Property              Value
      --------------------  ------------------------
      TopProperty           "1; [2a; 2b]; 3"
        First Child         "1"
        Second Child        "2a; 2b"
          First Sub-Child   "2a"
          Second Sub-Child  "2b"
        Third Child         "3"

    As an example of this, I have added a property labeled "3D Object" to the
    third page in the sample app.


  Bugs Fixed:

  - Attribute wxPG_FILE_WILDCARD did not work.

  - Various bugs with nested properties.

  - Did not compile with wxUSE_UNICODE=0 + wxUSE_STL=1
    (thanks Joachim H鰊ig).

  - wxPropertyGridManager: wxPG_AUTO_SORT was forced.

  - wxPropertyGridManager: selections were not retained.

  - Windows XP: Drew corrupted drop button with some themes.



Version 1.0.1 ( April-24-2005 )

  Changes:

  - More consistent positions for wxTextCtrl-based editors.

  - wxGTK2 wxTextCtrl based editor now uses clipper window to remove its
    borders. Previously only wxNO_BORDER flag was used (similar to wxMSW),
    but it was not sufficient for all GUI themes.


  Bugs Fixed:

  - Category with zero children caused a graphics glitch.

  - If mouse in editor was dragged outside on to the splitter, control's
    cursor was changed to double arrow.

  - Editor control's keyboard focus was not detected correctly if it used a
    clipper window.

  - Borland C++ compile error.



Version 1.0.0 ( Apr-14-2005 )

  Note: There are still few known bugs left. I have tried to compile a
    more-or-less complete list, which can be found on the docs main page.

  New Features:

  - wxWidgets 2.6.0 compatibility.

  - wxCustomProperty. This is a property class that can be, using
    SetPropertyAttribute, customized for various needs. It can also have
    children. Note that its value type is string, and this cannot be
    (and should not be) currently modified.

    See docs main page, section "Custom User Properties (using
    wxCustomProperty)" for more information.


  Changes and Minor Additions:

  - wxParentProperty is removed (use wxCustomProperty instead).

  - Moved class definitions of following property classes to propdev.h or
    advprops.h (so they can now be inherited from):
      wxImageFilePropertyClass, wxCursorPropertyClass,
      wxMultiChoicePropertyClass.

  - Expander button is no longer drawn for parent properties when they
    have no children.

  - Added wxPropertyGridPopulator pseudo-code sample to the documentation.

  - New method: SetPropertyChoices(id/name,wxPGConstants)
    Preferred way to override the entire set of choices for a property.

  - Added some missing wxPropertyGridManager methods:
      SetPropertyLabel

  - Modified wxPropertyGrid::GetImageSize so that it can return image size
    of a specified property. If no argument is given, it works as before.


  Bugs Fixed:

  - Graphics glitch when deleting a property.

  - Active editor misplacement on Compact.

  - Garbage between textctrl and button after splitter movement.

  - Expander icon clickable area was slightly less than the entire icon.

  - GCC 4.x compile problem.

  - If grid was resized so that the scrolled position changed and there
    was an editor control which position or size had to be changed, then
    the final control position was skewed.



Version 1.0.0 RC1 ( Mar-30-2005 )

  New Features:

  - wxWidgets 2.5.5 compatibility.

  - wxPropertyGridPopulator class.
    Allows populating wxPropertyGrid from an arbitrary text source.
    For a practical example, see propgridsample.cpp's functions
      FormMain::OnSaveToFileClick
      FormMain::OnLoadFromFileClick

    NOTES:
      * wxParentProperty is not supported yet.
      * As currently there is no GetPropertyAttribute, property
        attributes cannot be stored.

  - wxEnumProperty and all custom properties derived from them
    now have dynamic label and value storage (called "choices" storage).
    Arrays given on creation are only initial and can be modified. Note
    that they are cached per-pointer, so two properties which are given
    same static arrays use the same dynamic storage. Thus, adding a choice
    to one property adds the same choice to all other properties using the
    same choice storage. However, there is a method to create private copy
    of choices for a property.

    Methods of note:
      wxPGConstants& GetPropertyChoices(id/name). Returns
        writable reference to the choices of a wxEnumProperty or
        derivative (and some others, such as wxMultiChoiceProperty,
        as well). Can be modified or given to another property in
        constructor function.

      AddPropertyChoice(id/name,label[,value]). Appends entry to
        the choices storage of a property.

      SetPropertyChoicesPrivate(id/name). If property's set of choices
        if shared with other properties, a private copy of it will be
        created for this property.

  - wxGTK 1.2 port is now almost usable. Problems remain in refreshing
    editor controls (try expanding/collapsing font property while its
    selected) and also there is a strange problem with wxMultiChoiceProperty
    (dialog's list box doesn't get correct selection). Note that this
    port also no longer uses custom controls.


  Changes and Minor Features:

  - Margin no longer uses background colour - use new SetMarginColour
    and GetMarginColour instead.

  - wxOwnerDrawnComboBox now allows "fake" popup window (i.e. wxWindow
    instead of wxPopupWindow) whenever possible. This reduces number
    of bugs experienced (wxPopupWindow is not perfect yet). To make
    best use of this "feature", use vertically large wxPropertyGrid
    (common in typical applications).

  - wxOwnerDrawnComboBox now extends the popup to always be wide
    enough to accommodate widest item in list.

  - IsModified is deprecated. Use IsPropertyModified and
    IsAnyModified instead.

  - GetFirstChild now only returns first child of root and
    category (you should not have need for easy sub-property access).

  - Using better Doxygen configuration (member sorting, no brief
    in member list).

  - Removed option to use .NET icons on toolbar.

  - ChoiceAndButton editor's button is now of same height
    as choice's dropbutton.

  - Precision handling of wxFloatProperty and wxArrayDoubleProperty
    have been improved. Precision of -1, which is now default, indicates