Generic UI Controllers: 7.2 Other Controllers: GenPageControlClass

| Up: GEOS SDK TechDocs | Up | Prev: 7.1 ColorSelectorClass | Next: 7.3 The Float Format Controller

GenPageControlClass provides a controller object that allows the user to go to any page in a page range. This controller provides UI gadgetry for going to a specified page, going to the next page, or going to the previous page.

The GenPageControl must be put on the GAGCNLT_SELF_LOAD_OPTIONS GCN list in the GenApplication object. It responds to the notification type MANUFACTURER_ID_GEOWORKS.GWNT_PAGE_STATE_CHANGE (sent with a NotifyPageStateChange structure) and sends out three messages exported from MetaClass .

GenPageControlClass is subclassed from GenControlClass and has the features and tools shown below. It has none of its own instance data fields.

  typedef WordFlags GPCFeatures;
#define GPCF_GOTO_PAGE					0x0004
#define GPCF_NEXT_PAGE					0x0002
#define GPCF_PREVIOUS_PAGE					0x0001
  typedef WordFlags GPCToolboxFeatures;
#define GPCTF_PREVIOUS_PAGE					0x0004
#define GPCTF_GOTO_PAGE					0x0002
#define GPCTF_NEXT_PAGE					0x0001
#define  GPC_DEFAULT_FEATURES (GPCF_GOTO_PAGE |
		GPCF_NEXT_PAGE | GPCF_PREVIOUS_PAGE)
#define  GPC_DEFAULT_TOOLBOX_FEATURES
		(GPCTF_GOTO_PAGE | GPCTF_NEXT_PAGE |
		 GPCTF_PREVIOUS_PAGE)
@default GCI_output = (TO_APP_TARGET);

The messages this controller sends out must be handled by any object controlled by it.

M SG_META_PAGED_OBJECT_GOTO_PAGE

void	MSG_META_PAGED_OBJECT_GOTO_PAGE(
        word	page);

This message causes the paged object to go to the specified page.

Source: The GenPageControl object.

Destination: The target paged object.

Parameters: page The page number to which the recipient should go.

Return: Nothing.

Interception: This message must be intercepted for the paged object to interact properly with the GenPageControl object.

MSG_META_PAGED_OBJECT_NEXT_PAGE

void	MSG_META_PAGED_OBJECT_NEXT_PAGE();

This message indicates that the recipient should go to the next page.

Source: The GenPageControl object.

Destination: The target paged object.

Interception: This message must be intercepted for the paged object to interact properly with the GenPageControl object.

MSG_META_PAGED_OBJECT_PREVIOUS_PAGE

void	MSG_META_PAGED_OBJECT_PREVIOUS_PAGE();

This message indicates that the recipient should go to the previous page.

Source: The GenPageControl object.

Destination: The target paged object.

Interception: This message must be intercepted for the paged object to interact properly with the GenPageControl object.

MSG_PC_GOTO_PAGE

see gPageCC.goh

Causes the page control object to go to the specified page.

Source: Unrestricted.

Destination: The page control object.

Parameters: The page to go to.

Return: Nothing.

Interception: Should not be intercepted.

MSG_PC_NEXT_PAGE

void	MSG_PC_NEXT_PAGE();

Causes the page controller to go to the next page.

Source: Unrestricted.

Destination: The page control object.

Interception: Should not be intercepted.

MSG_PC_PREVIOUS_PAGE

void	MSG_PC_PREVIOUS_PAGE();

Causes the page controller to go to the previous page.

Source: Unrestricted.

Destination: The page control object.

Interception: Should not be intercepted .

| Up: GEOS SDK TechDocs | Up | Prev: 7.1 ColorSelectorClass | Next: 7.3 The Float Format Controller