Subsection partially selected - Revision history

Deguix: Made note tags bold.

2005-07-15T22:06:42Z

Made note tags bold.

â† Older revision		Revision as of 22:06, 15 July 2005
Line 2:		Line 2:

	== Description ==		== Description ==
	This macro can be used to determine if any one of the sections within a subsection is selected. Note: if you know the section names ahead of time and there aren't too many then use a method similar to one-section, i.e. directly query each.		This macro can be used to determine if any one of the sections within a subsection is selected.

			'''Note:''' if you know the section names ahead of time and there aren't too many then use a method similar to one-section, i.e. directly query each.

	== The Script ==		== The Script ==
	Note: Using current NSIS 2, this can be more easily achieved using		'''Note:''' Using current NSIS 2, this can be more easily achieved using
	the partially selected flag in combination with the selected flag.		the partially selected flag in combination with the selected flag.
	You must check both unless you only want cases where some and NOT all sections in a subsection are selected.		You must check both unless you only want cases where some and NOT all sections in a subsection are selected.
Line 20:		Line 22:

	== Deprecated (Tested with NSIS 2.0b0) ==		== Deprecated (Tested with NSIS 2.0b0) ==
	This is only tested with NSIS 2.0b0 and relies on my observation of the value of section #s, so may or may not work with other versions. Until I can find a better approach this is used to determine whether to display a page to select a download mirror or not (i.e. you only choose a download mirror if you happened to select a component in a subsection that contains optional downloadable components).		This is only tested with NSIS 2.0b0 and relies on my observation of the value of section #s, so may or may not work with other versions. Until I can find a better approach this is used to determine whether to display a page to select a download mirror or not (i.e. you only choose a download mirror if you happened to select a component in a subsection that contains optional downloadable components).

	Basically, we use the section# of the parent subsection as the base, then cycle through the next MY_SUBSECTION_CNT entries and if any of them are selected (SF_SELECTED is set) we consider the subsection partially selected.		Basically, we use the section# of the parent subsection as the base, then cycle through the next MY_SUBSECTION_CNT entries and if any of them are selected (SF_SELECTED is set) we consider the subsection partially selected.

ConversionBot: Adding new author and category links.

2005-06-24T13:55:46Z

Adding new author and category links.

â† Older revision		Revision as of 13:55, 24 June 2005
Line 1:		Line 1:
	{~~\|align=right~~		{{PageAuthor\|PerditionC}}
	~~\|<small>Author: [[~~{~~{ns:2}}:PerditionC~~\|PerditionC~~]] ([[{{ns:3}}:PerditionC\|talk]], [[{{ns:-1}~~}~~:Contributions/PerditionC\|contrib]])</small>~~
	\|}
	~~<br style="clear:both;">~~
	== Description ==		== Description ==
	This macro can be used to determine if any one of the sections within a subsection is selected. Note: if you know the section names ahead of time and there aren't too many then use a method similar to one-section, i.e. directly query each.		This macro can be used to determine if any one of the sections within a subsection is selected. Note: if you know the section names ahead of time and there aren't too many then use a method similar to one-section, i.e. directly query each.
Line 89:		Line 87:
	</highlight-nsis>		</highlight-nsis>

	[[~~{{ns:14}}~~:Section Management Functions]]		[[Category:Section Management Functions]]

ConversionBot: Added category links.

2005-04-30T20:55:13Z

Added category links.

â† Older revision		Revision as of 20:55, 30 April 2005
Line 88:		Line 88:
	pop $R1		pop $R1
	</highlight-nsis>		</highlight-nsis>

			[[{{ns:14}}:Section Management Functions]]

ConversionBot: Updated author links.

2005-04-30T03:04:35Z

Updated author links.

@@ Line 1: / Line 1: @@
 == Description ==
 This macro can be used to determine if any one of the sections within a subsection is selected.  Note: if you know the section names ahead of time and there aren't too many then use a method similar to one-section, i.e. directly query each.
@@ Line 84: / Line 88: @@
 pop $R1
 </highlight-nsis>

ConversionBot: Updated author and download links, and changed format of some pages.

2005-04-23T12:18:56Z

Updated author and download links, and changed format of some pages.

â† Older revision		Revision as of 12:18, 23 April 2005
Line 85:		Line 85:
	</highlight-nsis>		</highlight-nsis>

	Page author: PerditionC		Page author: [[User:PerditionC\|PerditionC]]

ConversionBot: Wikipedia python library

2005-04-09T19:15:54Z

Wikipedia python library

New page

== Description ==
This macro can be used to determine if any one of the sections within a subsection is selected. Note: if you know the section names ahead of time and there aren't too many then use a method similar to one-section, i.e. directly query each.

== The Script ==
Note: Using current NSIS 2, this can be more easily achieved using
the partially selected flag in combination with the selected flag.
You must check both unless you only want cases where some and NOT all sections in a subsection are selected.
<highlight-nsis>
!include Sections.nsh
!insertmacro SectionFlagIsSet ${ssection_XXX} ${SF_PSELECTED} isSel chkAll
chkAll:
!insertmacro SectionFlagIsSet ${ssection_XXX} ${SF_SELECTED} isSel notSel
isSel:
; ... do actions if any or all sections in a subsection are selected
notSel:
; ... do actions if no sections in a subsection are selected (all unselected)
</highlight-nsis>

== Deprecated (Tested with NSIS 2.0b0) ==
This is only tested with NSIS 2.0b0 and relies on my observation of the value of section #s, so may or may not work with other versions. Until I can find a better approach this is used to determine whether to display a page to select a download mirror or not (i.e. you only choose a download mirror if you happened to select a component in a subsection that contains optional downloadable components).

Basically, we use the section# of the parent subsection as the base, then cycle through the next MY_SUBSECTION_CNT entries and if any of them are selected (SF_SELECTED is set) we consider the subsection partially selected.

<highlight-nsis>; this is the count of sections in the given subsection
!define MY_SUBSECTION_CNT 27 ; used to query sections & set description text

; determine if section selected by user
!define SF_SELECTED 1

; RESULT should be one of the R set $R0-$R9
; on return RESULT is 0 if none are selected else it is 1 == ${SF_SELECTED}
!macro isMySubSectionSelected RESULT
; we !!!assume!!! that section# of 1st section is # of the subsection + 1

; save called values of our temp variables
push $0 ; used for the 1st section
push $1 ; used for the last section

; initialize result to none selected
StrCpy ${RESULT} 0
StrCpy $0 ${ssection_dl_opt_XXX} ; replace with parent subsection#

; $0=section of 1st downloadable component's section
; $0 = ${ssection_dl_opt_XXX} + 1
; $1=section of last downloadable component's section + 1
; $1 = ${ssection_dl_opt_XXX} + 1 + ${DICTIONARY_COUNT}
IntOp $0 $0 + 1 ; order here
IntOp $1 $0 + ${MY_SUBSECTION_CNT} ; matters

loop_start:
; check if flag set
SectionGetFlags $0 ${RESULT}
IntOp ${RESULT} ${RESULT} & ${SF_SELECTED}
IntCmp ${RESULT} ${SF_SELECTED} loop_end 0 0
; loop through sections
IntOp $0 $0 + 1
IntCmpU $0 $1 loop_end
Goto loop_start
loop_end:
pop $1
pop $0
!macroend
</highlight-nsis>

And if you support multiple languages, but you want all your sections in a given subsection to have the same description as the subsection itself, then use something like this:

<highlight-nsis>
!insertmacro MUI_DESCRIPTION_TEXT ${ssection_dl_opt_XXX} $(DESC_ssection_dl_opt_XXX)

push $R1 ; the 1st section
push $R2 ; the last section

StrCpy $R1 ${ssection_dl_opt_XXX}
IntOp $R1 $R1 + 1
IntOp $R2 $R1 + ${MY_SUBSECTION_CNT}
loop_start:
!insertmacro MUI_DESCRIPTION_TEXT $R1 $(DESC_ssection_dl_opt_XXX)
IntOp $R1 $R1 + 1
IntCmpU $R1 $R2 loop_end
Goto loop_start
loop_end:

pop $R2
pop $R1
</highlight-nsis>

Page author: PerditionC