Table Of Contents

Previous topic

IconizeEvent

Next topic

IdleEvent

This Page

phoenix_title IdManager

IdManager is responsible for allocating and releasing window IDs.

It is used by Window.NewControlId and Window.UnreserveControlId , and can also be used be used directly.


class_hierarchy Inheritance Diagram

Inheritance diagram for class IdManager

Inheritance diagram of IdManager


method_summary Methods Summary

ReserveId Called directly by Window.NewControlId , this function will create a new ID or range of IDs.
UnreserveId Called directly by Window.UnreserveControlId , this function will unreserve an ID or range of IDs that is currently reserved.

api Class API



class IdManager(object)

IdManager is responsible for allocating and releasing window IDs.


Methods



static ReserveId(count=1)

Called directly by Window.NewControlId , this function will create a new ID or range of IDs.

The IDs will be reserved until assigned to a WindowIDRef() or unreserved with UnreserveControlId(). Only ID values that are not assigned to a WindowIDRef() need to be unreserved.

Parameters:count (int) – The number of sequential IDs to reserve.
Return type:int
Returns:The value of the first ID in the sequence, or ID_NONE.


static UnreserveId(id, count=1)

Called directly by Window.UnreserveControlId , this function will unreserve an ID or range of IDs that is currently reserved.

This should only be called for IDs returned by ReserveControlId() that have NOT been assigned to a WindowIDRef (see Window IDs).

Parameters:
  • id (int) – The first of the range of IDs to unreserve.
  • count (int) – The number of sequential IDs to unreserve.
Returns:

The value of the first ID in the sequence, or ID_NONE.