.. wxPython Phoenix documentation

   This file was generated by Phoenix's sphinx generator and associated
   tools, do not edit by hand.

   Copyright: (c) 2011-2025 by Total Control Software
   License:   wxWindows License

.. include:: headings.inc



.. _wx.StockPreferencesPage:

==========================================================================================================================================
|phoenix_title|  **wx.StockPreferencesPage**
==========================================================================================================================================

Specialization of :ref:`wx.PreferencesPage`  useful for certain commonly used preferences page. 
         

On macOS, preferences pages named "General" and "Advanced" are commonly used in apps and the OS provides stock icons for them that should be used. Instead of reimplementing this behaviour yourself, you can inherit from :ref:`wx.StockPreferencesPage`  and get correct title and icon. 

Notice that this class only implements :meth:`~wx.StockPreferencesPage.GetName`  and :meth:`~wx.StockPreferencesPage.GetIcon`, you still have to provide the rest of :ref:`wx.PreferencesPage`  implementation. 






         



.. versionadded:: 2.9.5 
     







|

|class_hierarchy| Class Hierarchy
=================================

.. raw:: html

   <div class="collabsible-wrapper">
      <input id="collapsible-inheritance" class="collapsible-checkbox" type="checkbox">
      <label for="collapsible-inheritance" tabindex="0" title="Show inheritance diagram" class="collapsible-label">Inheritance diagram for class <strong>StockPreferencesPage</strong>:</label>
      <div class="collapsible-content">
         <p class="graphviz">
            <center><img src="_static/images/inheritance/wx.StockPreferencesPage_inheritance.svg" alt="Inheritance diagram of StockPreferencesPage" usemap="#dummy" class="inheritance invert-in-dark-mode"/></center>
            <map id="dummy" name="dummy"> <area shape="rect" id="node1" href="wx.StockPreferencesPage.html" title="Specialization of wx.PreferencesPage  useful for certain commonly used preferences page." alt="" coords="5,82,222,111"/> <area shape="rect" id="node2" href="wx.PreferencesPage.html" title="One page of preferences dialog." alt="" coords="25,5,202,34"/> </map> 
         </p>
      </div>
   </div>
   <script type="text/javascript" src="_static/inheritancetoggle.js"></script>



|


|method_summary| Methods Summary
================================

================================================================================ ================================================================================
:meth:`~wx.StockPreferencesPage.__init__`                                        Constructor.
:meth:`~wx.StockPreferencesPage.GetIcon`                                         Reimplemented to return stock icon on macOS.
:meth:`~wx.StockPreferencesPage.GetKind`                                         Returns the page's kind.
:meth:`~wx.StockPreferencesPage.GetName`                                         Reimplemented to return suitable name for the page's kind.
================================================================================ ================================================================================


|


|property_summary| Properties Summary
=====================================

================================================================================ ================================================================================
:attr:`~wx.StockPreferencesPage.Icon`                                            See :meth:`~wx.StockPreferencesPage.GetIcon`
:attr:`~wx.StockPreferencesPage.Name`                                            See :meth:`~wx.StockPreferencesPage.GetName`
================================================================================ ================================================================================


|


|api| Class API
===============


.. class:: wx.StockPreferencesPage(PreferencesPage)

   **Possible constructors**::

       StockPreferencesPage(kind) -> None
       
   
   Specialization of PreferencesPage useful for certain commonly used
   preferences page.



   .. method:: __init__(self, kind)

      Constructor. 
                 


      :param `kind`: 
      :type `kind`: wx.StockPreferencesPage.Kind




      :rtype: `None`     








   .. method:: GetIcon(self)

      Reimplemented to return stock icon on macOS. 
                 

      :rtype: :ref:`wx.BitmapBundle`








   .. method:: GetKind(self)

      Returns the page's kind. 
                 

      :rtype: :ref:`wx.StockPreferencesPage.Kind`








   .. method:: GetName(self)

      Reimplemented to return suitable name for the page's kind. 
                 

      :rtype: `str`








   .. attribute:: Icon

      See :meth:`~wx.StockPreferencesPage.GetIcon`


   .. attribute:: Name

      See :meth:`~wx.StockPreferencesPage.GetName`


.. toctree::
   :maxdepth: 1
   :hidden:

   wx.StockPreferencesPage.Kind.enumeration
